> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Migración de Suscripciones a Dodo Payments
> Aprende cómo migrar tus suscriptores y métodos de pago existentes desde tu procesador de pagos actual a Dodo Payments.
## ¿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](mailto:support@dodopayments.com). 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)](https://pub-2a89184e4c954b599464449d23f506bb.r2.dev/dodo-payments-pci-dss-aoc.pdf) 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
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.
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
| Campo | Descripción |
| ------------------- | ---------------------------------------------------------- |
| `customer_id` | Su identificador interno del cliente |
| `email` | Dirección de correo electrónico del cliente |
| `name` | Nombre completo del cliente |
| `country` | Código de país de dos letras (ISO 3166-1 alfa-2) |
| `currency` | Código de moneda de tres letras (ISO 4217) |
| `payment_amount` | Monto de la suscripción en la unidad monetaria más pequeña |
| `payment_interval` | Frecuencia de facturación (mensual, anual, etc.) |
| `next_billing_date` | Próxima fecha de facturación programada (ISO 8601) |
| `card_token` | Token ú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
```json theme={null}
{
"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"
}
}
]
}
```
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.
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.
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 dato | Soportado | Notas |
| --------------------------------------------- | --------- | ----------------------------------- |
| 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
| Fase | Duración |
| ------------------------------------- | ------------------- |
| Configuración inicial y planificación | 1-2 días |
| Transferencia de método de pago | \~2 semanas |
| Preparación de datos de suscriptores | 3-5 días (paralelo) |
| Validación y pruebas | 2-3 días |
| Importación en producción | 2-3 días hábiles |
| Verificación post-migración | 1-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:
Contáctenos para iniciar su migración y conectarse con un Ingeniero de Soluciones.
Explora nuestra API para entender cómo funcionan las suscripciones en Dodo Payments.