Actualizar Configuración y Claves API de la App CartDNA
¿Necesitas corregir una clave, cambiar de prueba a producción o conectar una subcuenta diferente? Puedes actualizar la configuración de la app CartDNA sin reinstalar la aplicación. Esto ahorra tiempo, reduce fricciones de configuración y te ayuda a mantener los pagos funcionando sin problemas.
Funciona para actualizaciones de claves, cambios de cuenta dentro del mismo procesador y corrección de errores de configuración anteriores.
¿Qué puedes actualizar en una app CartDNA?
Puedes editar claves API, cambiar detalles de configuración y conectar una cuenta o subcuenta diferente dentro del mismo procesador de pagos. No necesitas comprar una nueva licencia para ese cambio. La app permanece instalada. Tu configuración simplemente se actualiza con los nuevos detalles de conexión.
- Actualizar claves de prueba a claves de producción
- Reemplazar credenciales API incorrectas
- Editar detalles de configuración existentes
- Conectar una subcuenta diferente
- Conectar una cuenta diferente dentro del mismo procesador
Puedes cambiar cuentas dentro del mismo procesador de pagos. No puedes cambiar la app de un procesador a otro procesador.
Regla importante antes de hacer cambios
Las apps CartDNA soportan cambios de claves y cambios de cuenta dentro del mismo procesador. Esto te da flexibilidad cuando cambia la estructura de tu cuenta PSP. Pero cada procesador usa APIs diferentes, lógica de autenticación diferente y arquitectura de conexión diferente. Por eso no se soporta el cambio de procesador dentro de la misma app instalada.
Lo que puedes hacer
- Cambiar claves API dentro del mismo procesador
- Mover de una subcuenta a otra subcuenta
- Cambiar de modo de prueba a modo producción
- Corregir errores de configuración anteriores sin reinstalar la app
Lo que no puedes hacer
- Cambiar el procesador conectado del Procesador A al Procesador B
- Reutilizar la misma app para un procesador de pagos completamente diferente
- Omitir un nuevo acuerdo al cambiar a un nuevo procesador
Si quieres usar un procesador diferente, necesitas: una nueva app CartDNA, una nueva conexión de procesador y un nuevo acuerdo firmado y proceso de aprobación.
Por qué los comerciantes actualizan la configuración y claves API de CartDNA
La mayoría de los comerciantes actualizan la configuración durante el crecimiento, pruebas o cambios de cuenta. Esto suele ocurrir cuando un negocio pasa de pagos sandbox a producción, corrige errores de configuración o necesita conectar una cuenta de comerciante diferente bajo el mismo PSP. Las actualizaciones rápidas reducen la interrupción del checkout y ayudan a proteger la tasa de conversión.
Pasar de prueba a producción
Reemplaza claves sandbox con credenciales de producción cuando estés listo para recibir pagos reales de clientes.
Corregir errores de configuración
Corrige claves API inválidas, secretos incorrectos o valores de configuración que se agregaron anteriormente.
Cambiar a otra subcuenta
Conecta una cuenta aprobada diferente dentro de la misma configuración del procesador de pagos.
Editar detalles de configuración
Actualiza la configuración de la app para que coincida con los nuevos detalles de la cuenta PSP o los requisitos de la tienda.
Cómo actualizar/cambiar las claves API de la app CartDNA
Normalmente puedes actualizar tu configuración en unos pocos pasos claros. Sigue el proceso cuidadosamente. Esto te ayuda a evitar errores de autenticación, pagos fallidos e interrupción de la tienda. Siempre verifica dos veces los valores antes de guardar cualquier cambio.
Método 1: Actualizar a través del Admin de Shopify
- 1Inicia sesión en tu admin de Shopify.
- 2Abre la app de pagos CartDNA.
- 3Ve al área de configuración de la app.
- 4Encuentra la sección de credenciales API.
- 5Reemplaza las claves antiguas con las nuevas claves correctas.
- 6Actualiza cualquier campo de configuración relacionado si es necesario.
- 7Guarda tus cambios.
- 8Ejecuta un pago de prueba si el modo de prueba está activo.
- 9Verifica que la app se esté conectando correctamente.
Método 2: Actualizar a través del portal de comerciante CartDNA
- 1Inicia sesión en tu portal de comerciante CartDNA.
- 2Abre la tienda o cuenta vinculada a tu app.
- 3Ve a la configuración de conexión o credenciales API.
- 4Ingresa los nuevos detalles de la clave.
- 5Revisa todos los valores de configuración relacionados.
- 6Guarda la nueva configuración.
- 7Confirma el estado de la conexión.
- 8Prueba el comportamiento del checkout antes de confiar en la nueva configuración.
Support note: Si no puedes acceder al portal o tu actualización falla, contacta al soporte de CartDNA antes de hacer cambios repetidos.
Mejores prácticas antes de guardar nuevas claves API
Un pequeño error en las credenciales puede bloquear pagos, romper la comunicación de la app o crear intentos de checkout fallidos. Usa esta lista de verificación antes de guardar cambios. Te ayuda a proteger los ingresos y te da un cambio más fluido.
- Confirma que estás usando la cuenta correcta
- Verifica si las claves son de prueba o producción
- Copia la clave completa sin caracteres faltantes
- Revisa los campos de configuración relacionados
- Guarda cambios solo después de una verificación final
- Ejecuta una transacción de prueba
- Confirma autorización exitosa y creación de pedido
- Revisa registros o mensajes de error si la conexión falla
Cambiar de claves de prueba a claves de producción
Esta es una de las actualizaciones más comunes que hacen los comerciantes. Las claves de prueba te ayudan a verificar el flujo de forma segura. Las claves de producción activan pagos reales. Solo debes cambiar después de haber validado el checkout, la configuración de la app y la preparación de la cuenta del procesador.
Antes de cambiar a producción
- Asegúrate de que tu cuenta PSP de producción esté aprobada
- Confirma que la cuenta de producción coincida con los detalles de tu negocio
- Verifica monedas y métodos de pago
- Confirma la configuración de webhook o callback si es necesario
- Ejecuta una prueba final de extremo a extremo
Después de cambiar a producción
- Realiza una transacción real controlada si es apropiado
- Verifica el estado de autorización del pago
- Verifica la creación de pedidos en Shopify
- Monitorea de cerca los primeros pedidos en producción
- Ten los detalles de contacto de soporte listos en caso de errores
Próximos pasos útiles
Los enlaces internos ayudan a los usuarios a avanzar más rápido. También ayudan a los motores de búsqueda a entender las relaciones entre páginas. Agrega enlaces contextuales dentro del contenido y un pequeño hub de enlaces cerca del final de la página para una navegación más fuerte y mayor valor SEO.
Preguntas frecuentes
¿Puedo actualizar la configuración de la app CartDNA sin reinstalar la app?▼
¿Puedo cambiar a una subcuenta diferente en el mismo procesador?▼
¿Puedo cambiar la app de un procesador de pagos a otro?▼
¿Puedo cambiar de claves de prueba a claves de producción?▼
¿Qué debo hacer si las nuevas claves no funcionan?▼
¿Necesitas ayuda actualizando tu conexión CartDNA?
Si necesitas editar claves, corregir errores de configuración o conectar una cuenta diferente dentro del mismo procesador, el soporte de CartDNA puede ayudarte a hacerlo de forma segura. Toma acción antes de que un problema de configuración afecte el rendimiento del checkout o la confianza del cliente.