Si procesas métodos de pago reutilizables en la API Sources (adeudo directo SEPA, adeudo directo Bacs o Alipay), tendrás que completar una migración de datos para convertir tus objetos Sources reutilizables en PaymentMethods. 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 puedo acceder 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 has hecho, primero se te solicitará que te suscribas a la versión beta 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, en todos los métodos de pago aparecerán marcas de verificación verdes, como confirmación de que has completado 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 Sources de {type}», donde {type} representa «Adeudo directo SEPA», «Adeudo 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?
Te recomendamos que realices la migración cuando 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 objeto Source en las últimas 24 horas.
¿Puedo ejecutar la herramienta de migración varias veces?
Te recomendamos que realices la migración una sola vez para migrar todos los objetos Source en un solo paso. Sin embargo, si necesitas volver a utilizar la herramienta de migración, es seguro hacerlo. La herramienta primero verifica si ya se ha migrado un objeto Source y solo creará PaymentMethods para los objetos que todavía no se hayan migrado.
¿La herramienta de migración es segura? ¿Puedo usarla sin alterar mi flujo de pago?
Sí, es seguro convertir Sources a PaymentMethods (paso 2). Ambos conjuntos de objetos, los Sources antiguos y los PaymentMethods nuevos, estarán activos y admitirán cargos (es decir, podrán crear pagos) para que la conversión no afecte a 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 hayas configurado 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 antiguos 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 cambiando la configuración del Dashboard de Stripe y activando 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 a 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 puede ser tedioso completarlo 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, contacta con soporte.