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 admitimos migración para tokens de tarjeta. Apple Pay, Google Pay y otros métodos de pago en billetera no pueden transferirse 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 iniciar una migración de suscripciones, contacte a nuestro equipo de soporte. Lo conectarán con un Ingeniero de Soluciones dedicado que lo guiará durante todo el proceso.

​
Requisitos

Antes de iniciar una migración, asegúrate de cumplir con los siguientes requisitos:
Dodo Payments cumple con PCI DSS Nivel 1. Para cumplir con las obligaciones de cumplimiento, solo podemos recibir datos de tarjeta de otro procesador de pagos que cumpla 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
Consulte nuestra Attestation of Compliance (AOC) para compartirla con su procesador actual.
Complete su integración con Dodo Payments y asegúrese de que todos los nuevos clientes estén siendo dirigidos al checkout de Dodo Payments antes de comenzar la migración. Esto previene inconsistencias de datos durante el período de transición.
Asegúrese de contar con la autorización necesaria para solicitar una exportación de datos a su procesador actual. Esto suele requerir:
  • Verificación del propietario de la cuenta
  • Autorización por escrito para el acceso a datos sensibles
  • Finalización de los pasos de verificación de seguridad de su procesador

​
Guía de migración paso a paso

1

Request payment method export from your current processor

Contacte al equipo de soporte de su procesador de pagos actual y presente una solicitud formal para una exportación completa de los tokens de tarjeta de sus 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. Su Ingeniero de Soluciones le proporcionará las credenciales de SFTP para compartir con su procesador actual.
En promedio, este proceso tarda alrededor de 2 semanas, aunque el tiempo varía según las políticas y los tiempos de respuesta de su procesador actual.
2

Prepare subscriber data export

Mientras la transferencia del método de pago está en curso, exporte los datos de suscriptores desde su sistema heredado. Su Ingeniero de Soluciones le proporcionará una plantilla CSV y lo guiará a través de los campos requeridos.

​
Datos de suscriptores requeridos

CampoDescripción
customer_idSu identificador interno del cliente
emailDirección de correo electrónico del cliente
nameNombre completo del cliente
countryCódigo de país de dos letras (ISO 3166-1 alfa-2)
currencyCódigo de moneda de tres letras (ISO 4217)
payment_amountMonto de la 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 su procesador actual
El campo card_token es fundamental: se utiliza para emparejar los registros de suscriptores con sus métodos de pago durante la importación. Asegúrese 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": "jane.doe@example.com",
      "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

Validation and testing

Antes de la fecha de importación, nuestro equipo:
  • 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á un informe de validación que confirme que todo está listo para la importación a producción.
4

Production import

En la fecha de importación acordada, nuestro equipo de ingeniería:
  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 a 3 días hábiles para migraciones estándar, dependiendo del volumen de suscriptores.
5

Post-migration verification

Después de que se complete la importación, recibirá:
  • 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 su panel
  • Probar algunas renovaciones de suscripción en modo sandbox
  • Actualizar las referencias de su base de datos interna con los nuevos ID
  • Ejecutar 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 se pueden migrar. Recomendamos exportar estos datos desde su procesador actual para tenerlos como referencia 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 completa generalmente toma 3 a 4 semanas de principio a fin. Comenzar la preparación de los datos de suscriptores mientras la transferencia del método de pago está en curso ayuda a minimizar la línea de tiempo general.

​
Comienza

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

Contact Support

Contáctenos para iniciar su migración y conectarse con un Ingeniero de Soluciones.

API Documentation

Explore nuestra API para comprender cómo funcionan las suscripciones en Dodo Payments.