Se você processa formas de pagamento reutilizáveis na API Sources (débito automático SEPA, débito automático Bacs ou Alipay), precisará concluir uma migração de dados para converter objetos Sources reutilizáveis para PaymentMethods. Com isso, será possível continuar processando pagamentos recorrentes sem que seus clientes sofram interrupções no serviço. Criamos uma ferramenta de migração de dados no Stripe Dashboard para ajudar no seu processo de migração.
Como faço para acessar essa ferramenta de migração?
Use este link para acessar a ferramenta no seu Dashboard. Primeiro, você precisará se inscrever em um beta do Workbench. Para aceitar essa opção, selecione "Iniciar a migração com o Workbench".
A página principal da ferramenta é a guia "Resumo", que foi criada para:
Depois que você tiver parado de processar pagamentos pela API Sources, todas as formas de pagamento terão uma marca de verificação verde, confirmando que você concluiu a migração.
Ao lado da guia "Resumo", haverá uma guia extra para cada forma de pagamento reutilizável que exigir uma migração de dados. Essa guia se chamará "Migrar Sources de {type}" em que {type} é "débito automático SEPA", "débito automático Bacs" ou "Alipay".
Essa guia terá orientações detalhadas sobre o processo de migração. Cada etapa do processo ficará destacada do lado esquerdo, com as instruções correspondentes à direita.
Quando devo usar a ferramenta de migração?
Recomendamos fazer a migração após migrar sua integração para as APIs PaymentIntents e PaymentMethods para que não seja mais necessário criar objetos Source reutilizáveis. A primeira etapa da ferramenta verifica se você não criou nenhum objeto Source nas últimas 24 horas.
Posso executar a ferramenta de migração várias vezes?
Recomendamos que você execute a ferramenta de migração uma vez para migrar todos os objetos Source de uma única vez. No entanto, se precisar executá-la novamente, é seguro fazê-lo A ferramenta primeiro confere se um objeto Source já foi migrado e só cria PaymentMethods para objetos que não foram migrados.
A ferramenta de migração é segura? Posso usá-la sem interromper meu fluxo de pagamentos?
Sim. É seguro converter objetos Sources para PaymentMethods (etapa 2). Os dois conjuntos de objetos, o Sources antigo e o novo PaymentMethods, estarão ativos e cobráveis (capazes de criar pagamentos) para que a conversão não interrompa seus fluxos de pagamento.
Os objetos mais novos só começarão a ser usados nos fluxos de pagamento quando você atualizar seu código ou configurar os novos PaymentMethods como padrão em Clientes, Faturas ou Assinaturas na etapa 4. A única etapa irreversível é a 6, que desanexará os objetos Source antigos e impedirá que eles sejam reutilizados. Antes de executar essa etapa, remova todas as referências a objetos Source antigos da sua base de código e faça as alterações necessárias para que a referência seja feita aos PaymentMethods.
Como faço para testar a ferramenta antes de executá-la em produção?
Se quiser usar a ferramenta de migração no modo de teste, clique no botão "Modo de teste" que fica no canto superior direito da tela para colocar o Stripe Dashboard no modo de teste. Também é possível fazer isso em https://dashboard.stripe.com/test/dashboard. Com o Dashboard no modo de teste, você pode executar a migração em qualquer objeto de teste reutilizável (ou usar a API Stripe para criar novos objetos no modo teste para migração).
Como a ferramenta de migração funcionará para uma plataforma Connect?
Se todos os objetos Source estiverem diretamente associados à sua conta da plataforma, você poderá usar a ferramenta de migração conforme ela foi projetada e seguir o processo descrito acima.
No entanto, se os objetos Source estiverem associados às suas contas conectadas, você poderá fazer login no Stripe Dashboard de cada conta conectada para concluir a migração de dados. Entendemos que esse processo é chato para quem tem muitas contas conectadas e estamos trabalhando para melhorar isso. Avisaremos assim que tivermos uma solução. Enquanto isso, se estiver tudo pronto para concluir sua migração e você quiser trabalhar conosco diretamente para concluir essa etapa para um número grande de contas conectadas, entre em contato.