Saltar al contenido principal

​
¿Qué es una migración de suscripciones?

Una migración de suscripciones transfiere tus suscriptores existentes desde tu procesador de pagos heredado a Dodo Payments, dándote una única fuente de verdad para todos tus datos de clientes. Sin una migración, los clientes que has adquirido hasta la fecha permanecen en tu sistema heredado, y solo los nuevos clientes serían visibles en Dodo Payments. El proceso de migración asegura una experiencia de facturación sin interrupciones para tus clientes: no necesitarán volver a ingresar sus detalles de pago ni experimentar ninguna interrupción en sus suscripciones.
Actualmente, solo soportamos la migración de tokens de tarjeta. Apple Pay, Google Pay y otros métodos de pago de billetera no pueden ser transferidos entre procesadores de pagos debido a restricciones de tokenización impuestas por estos proveedores.

​
Resumen del proceso de migración

El proceso de migración de suscripciones consta de tres partes clave:
  1. Transferencia de método de pago — Transferencia segura de datos sensibles de tarjetas desde tu procesador actual
  2. Transferencia de datos de suscriptores — Exportación de detalles de clientes, planes de suscripción y horarios de facturación
  3. Importación y validación — Unificación de métodos de pago y datos de suscriptores en Dodo Payments
Para comenzar una migración de suscripciones, contacta a nuestro equipo de soporte. Ellos te conectarán con un Ingeniero de Soluciones dedicado que te guiará a través de todo el proceso.

​
Requisitos

Antes de iniciar una migración, asegúrate de cumplir con los siguientes requisitos:
Dodo Payments es compatible con PCI DSS Nivel 1. Para cumplir con las obligaciones de cumplimiento, solo podemos recibir datos de tarjetas de otro procesador de pagos que sea compatible con PCI DSS Nivel 1.Tu procesador actual debe proporcionar:
  • Su actual Certificación de Cumplimiento de PCI (AOC), o su listado en el Registro Global de Proveedores de Servicios de Visa
  • Confirmación de que soportan exportaciones seguras de datos de tarjetas
Consulta nuestra Certificación de Cumplimiento (AOC) para compartir con tu procesador actual.
Completa tu integración de Dodo Payments y asegúrate de que todos los nuevos clientes sean dirigidos al proceso de pago de Dodo Payments antes de comenzar la migración. Esto previene inconsistencias de datos durante el período de transición.
Asegúrate de tener la autorización necesaria para solicitar una exportación de datos de tu procesador actual. Esto generalmente requiere:
  • Verificación del propietario de la cuenta
  • Autorización por escrito para el acceso a datos sensibles
  • Completar los pasos de verificación de seguridad de tu procesador

​
Guía de migración paso a paso

1

Solicitar exportación de método de pago a tu procesador actual

Contacta al equipo de soporte de tu procesador de pagos actual y presenta una solicitud formal para una exportación completa de los tokens de tarjeta de tus clientes.Necesitarás:
  • Proporcionar verificación de tu identidad y autorización
  • Solicitar que encripten la exportación utilizando la clave pública PGP de Dodo Payments (proporcionada a continuación)
  • Pedirles que transfieran el archivo encriptado directamente a nuestro servidor SFTP seguro
Las transferencias seguras se realizan directamente de servidor a servidor a través de SFTP. Tu Ingeniero de Soluciones proporcionará las credenciales SFTP para compartir con tu procesador actual.
En promedio, este proceso toma alrededor de 2 semanas, aunque el tiempo varía dependiendo de las políticas y tiempos de respuesta de tu procesador actual.
2

Preparar exportación de datos de suscriptores

Mientras la transferencia del método de pago está en progreso, exporta los datos de tus suscriptores desde tu sistema heredado. Tu Ingeniero de Soluciones proporcionará una plantilla CSV y te guiará a través de los campos requeridos.

​
Datos de suscriptores requeridos

CampoDescripción
customer_idTu identificador interno de cliente
emailDirección de correo electrónico del cliente
nameNombre completo del cliente
countryCódigo de país de dos letras (ISO 3166-1 alpha-2)
currencyCódigo de moneda de tres letras (ISO 4217)
payment_amountMonto de suscripción en la unidad monetaria más pequeña
payment_intervalFrecuencia de facturación (mensual, anual, etc.)
next_billing_datePróxima fecha de facturación programada (ISO 8601)
card_tokenToken único de tu procesador actual
El campo card_token es crítico: se utiliza para emparejar los registros de suscriptores con sus métodos de pago durante la importación. Asegúrate de que coincida exactamente con el token en la exportación del método de pago.

​
Formato de datos de ejemplo

{
  "customers": [
    {
      "customer_id": "cus_abc123",
      "email": "[email protected]",
      "name": "Jane Doe",
      "country": "US",
      "currency": "USD",
      "payment_amount": 2999,
      "payment_interval": "monthly",
      "next_billing_date": "2025-01-15T00:00:00Z",
      "card_token": "tok_xyz789",
      "metadata": {
        "plan": "pro",
        "signup_source": "website"
      }
    }
  ]
}
3

Validación y pruebas

Antes de la fecha de importación, nuestro equipo realizará:
  • Verificación de la integridad del archivo y encriptación de los datos del método de pago
  • Validación de tu CSV de suscriptores para el formato correcto
  • Ejecución de una importación de prueba en nuestro entorno de sandbox
  • Identificación y resolución de cualquier problema de mapeo de datos
Recibirás un informe de validación confirmando que todo está listo para la importación en producción.
4

Importación en producción

En la fecha de importación acordada, nuestro equipo de ingeniería realizará:
  1. Importar los datos del método de pago en nuestro Vault de Tarjetas compatible con PCI
  2. Importar tus datos de suscriptores
  3. Emparejar suscriptores con sus métodos de pago utilizando los tokens de tarjeta
  4. Activar todas las suscripciones migradas
El tiempo de procesamiento típico es de 2-3 días hábiles para migraciones estándar, dependiendo del volumen de suscriptores.
5

Verificación post-migración

Después de que se complete la importación, recibirás:
  • Un informe de migración completo
  • Un CSV que mapea tus antiguos IDs de suscripción a nuevos IDs de Dodo Payments
  • Acceso a todos los clientes migrados en tu panel de Dodo Payments
Recomendamos:
  • Verificar una muestra de suscripciones migradas en tu panel
  • Probar algunas renovaciones de suscripción en modo sandbox
  • Actualizar las referencias de tu base de datos interna con los nuevos IDs
  • Realizar un monitoreo paralelo durante el primer ciclo de facturación

​
Datos migrables

Los siguientes datos pueden ser transferidos durante una migración de suscripciones:
Tipo de datoSoportadoNotas
Números de tarjetas de crédito/débito✅Encriptados a través de PGP
Fechas de expiración de tarjetas✅
Nombres de titulares de tarjetas✅
Direcciones de facturación✅
Direcciones de correo electrónico de clientes✅
Metadatos de clientes✅Pares clave-valor personalizados
Detalles de suscripción✅Plan, monto, intervalo
Tokens de Apple Pay❌No se pueden transferir
Tokens de Google Pay❌No se pueden transferir
Otros tokens de billetera❌No se pueden transferir
Historial de pagos❌Exportar desde tu procesador actual
El historial de pagos y los registros de transacciones no pueden ser migrados. Recomendamos exportar estos datos de tu procesador actual para tus registros antes de completar la transición.

​
Encriptación PGP

Para máxima seguridad al transferir datos sensibles de tarjetas, todos los archivos deben ser encriptados utilizando nuestra clave pública PGP. Esto proporciona una capa adicional de protección más allá de la encriptación a nivel de transporte. Comparte esta clave con tu procesador de pagos actual para encriptar la exportación de datos de tarjetas: 
-----BEGIN PGP PUBLIC KEY BLOCK-----

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
1OSDhXaPYtJnVApUzaCrC5PJCXU=
=nHcw
-----END PGP PUBLIC KEY BLOCK-----

​
Expectativas de cronograma

FaseDuración
Configuración inicial y planificación1-2 días
Transferencia de método de pago~2 semanas
Preparación de datos de suscriptores3-5 días (paralelo)
Validación y pruebas2-3 días
Importación en producción2-3 días hábiles
Verificación post-migración1-2 días
La migración total generalmente toma 3-4 semanas de principio a fin. Comenzar la preparación de datos de suscriptores mientras la transferencia del método de pago está en progreso ayuda a minimizar el cronograma general.

​
Comienza

¿Listo para migrar tus suscripciones a Dodo Payments? Contacta a nuestro equipo para comenzar el proceso:

Contactar Soporte

Comunícate para comenzar tu migración y conectarte con un Ingeniero de Soluciones.

Documentación de API

Explora nuestra API para entender cómo funcionan las suscripciones en Dodo Payments.