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 Dashboard. Primeiro, você precisará se inscrever em uma prévia 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:

• Especificar quais LPMs você vem aceitando pela API Sources
• Indicar com um "x" vermelho quais formas de pagamento tiveram pagamentos aceitos pela API Sources no último período de 24 horas, 7 dias ou 31 dias.

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 a finalização da 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 usá-la 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 objetos Source nas últimas 24 horas.

Posso executar a ferramenta de migração várias vezes?

Recomendamos que você execute a ferramenta uma vez para migrar todos os objetos Source em lote. 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 antigo da Sources e o novo do 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 o 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" no canto superior direito da tela para ativá-lo no Stripe Dashboard. 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 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 é complicado para quem tem muitas contas conectadas e estamos trabalhando para aprimorá-lo. Avisaremos assim que tivermos uma solução. Enquanto isso, se estiver com tudo pronto para concluir sua migração e quiser trabalhar conosco diretamente para concluir essa etapa para um número grande de contas conectadas, fale com o suporte.