Migración de objetos reusables de Sources a Payment Intents

Si estás procesando métodos de pago reutilizables en la API Sources (débito directo SEPA, débito directo Bacs o Alipay), tendrás que completar una migración de datos para convertir tus Fuentes reutilizables en Métodos de pago. Esto permitirá que sigas procesando pagos recurrentes sin interrupciones para tus clientes actuales. Para guiarte en cada paso de este proceso, hemos creado una herramienta de migración de datos en el Dashboard de Stripe. 

¿Cómo accedo a esta herramienta de migración?

Puedes acceder a la herramienta a través de este enlace en tu Dashboard. Si todavía no lo hiciste, primero se te solicitará que te suscribas a la versión preliminar de Workbench. Selecciona «iniciar migración con Workbench» para aceptar. 

La página principal de la herramienta es la pestaña «Resumen», que está diseñada para lo siguiente:

Una vez que hayas dejado de procesar los pagos a través de la API Sources, todos los métodos de pago exhibirán marcas de verificación verdes, que confirman que completaste la migración.

Al lado de la pestaña «Resumen», verás una pestaña adicional para cada método de pago reutilizable que requiere una migración de datos. Esta pestaña tendrá el nombre «Migrar {type} fuentes» donde {type} representa «Débito directo SEPA», «Débito directo Bacs» o «Alipay».


Esta pestaña te guiará por el proceso de migración paso a paso. A medida que avanzas en el proceso, cada paso estará señalado en el lado izquierdo con las instrucciones correspondientes para completarlo a la derecha. 

¿Cuándo debo usar la herramienta de migración? 

Recomendamos que ejecutes la migración después de que hayas migrado tu integración para usar la API PaymentIntents y PaymentMethods para que ya no crees nuevos objetos Source reutilizables. El primer paso que la herramienta verifica es que no hayas creado ningún Source en las últimas 24 horas. 

¿Puedo ejecutar la herramienta de migración varias veces? 

Recomendamos que ejecutes la migración una sola vez para migrar todos los objetos Source en un solo paso. Sin embargo, si necesitas volver a ejecutar la herramienta de migración, es seguro hacerlo. La herramienta primero verifica si ya se migró un objeto Source y solo creará PaymentMethods para los objetos que todavía no se hayan migrado. 

¿Es segura la herramienta de migración? ¿Puedo usarla sin afectar mi flujo de pago?

Sí, es seguro convertir Sources a PaymentMethods (paso 2). Ambos conjuntos de objetos, los Sources viejos y los nuevos PaymentMethods, estarán activos y admitirán cargos (es decir, podrán crear pagos) para que la conversión no afecte tus flujos de pago.

Los nuevos objetos no comenzarán a usarse en tu flujo de pagos hasta que hayas actualizado tu código o que configures los nuevos PaymentMethods como predeterminados en Clientes, Facturas o Suscripciones en el paso 4. El único paso irreversible es el paso 6, que desvinculará los Sources viejos y evitará que se reutilicen. Antes de ejecutar este paso, asegúrate de que hayas eliminado todas las referencias a objetos Source heredados de tu código base y hayas hecho las actualizaciones necesarias para referenciar los nuevos PaymentMethods.

¿Cómo puedo probar la herramienta antes de ponerla en marcha?

Puedes usar la herramienta de migración en modo de prueba al cambiar la configuración del Dashboard de Stripe y activar el «Modo de prueba» en la esquina superior derecha de la pantalla. Como alternativa, visita https://dashboard.stripe.com/test/dashboard. Una vez que el Dashboard esté en modo de prueba, puedes ejecutar la migración en los objetos de prueba existentes (o usar la API de Stripe para crear nuevos objetos en modo de prueba para migrar).

¿Cómo me funcionará la herramienta de migración como Plataforma Connect?

Si todos los objetos Source están directamente asociados con tu cuenta de plataforma, puedes usar la herramienta de migración como está diseñada y seguir el proceso de migración que se describe previamente.

Si, de lo contrario, los objetos Source están asociados con tus cuentas conectadas, puedes iniciar sesión en el Dashboard de Stripe de cada cuenta conectada para completar la migración de datos en su nombre. Entendemos que esto puede ser molesto de completar si tienes muchas cuentas conectadas: estamos trabajando en un mejor enfoque y actualizaremos las plataformas cuando tengamos una solución. Mientras tanto, si tienes todo listo para completar tu migración y te gustaría trabajar directamente con nosotros para completar este paso para una gran cantidad de cuentas conectadas, ponte en contacto con soporte.