Pular para o conteúdo principal

​
O que é uma migração de assinaturas?

Uma migração de assinaturas transfere seus assinantes existentes do seu processador de pagamentos legado para o Dodo Payments, fornecendo uma única fonte de verdade para todos os seus dados de clientes. Sem uma migração, os clientes que você adquiriu até agora permanecem em seu sistema legado, e apenas novos clientes seriam visíveis no Dodo Payments. O processo de migração garante uma experiência de cobrança contínua para seus clientes—eles não precisarão reentrar seus dados de pagamento ou experimentar qualquer interrupção em suas assinaturas.
Atualmente, só suportamos migração para tokens de cartão. Apple Pay, Google Pay e outros métodos de pagamento por carteira não podem ser transferidos entre processadores de pagamento devido a restrições de tokenização impostas por esses provedores.

​
Visão geral do processo de migração

O processo de migração de assinaturas consiste em três partes principais:
  1. Transferência de método de pagamento — Transferência segura de dados sensíveis do cartão do seu processador atual
  2. Transferência de dados do assinante — Exportação de detalhes do cliente, planos de assinatura e cronogramas de cobrança
  3. Importação e validação — Unificação de métodos de pagamento e dados de assinantes no Dodo Payments
Para iniciar uma migração de assinatura, contate nossa equipe de suporte. Eles irão conectá-lo a um Engenheiro de Soluções dedicado que o guiará por todo o processo.

​
Requisitos

Antes de iniciar uma migração, certifique-se de atender aos seguintes requisitos:
Dodo Payments é compatível com o PCI DSS Nível 1. Para atender às obrigações de conformidade, só podemos receber dados de cartão de outro processador de pagamento compatível com o PCI DSS Nível 1.Seu processador atual deve fornecer:
  • Sua atual Declaração de Conformidade PCI (AOC), ou sua listagem no Registro Global de Provedores de Serviços da Visa
  • Confirmação de que eles suportam exportações seguras de dados de cartão
Veja nossa Declaração de Conformidade (AOC) para compartilhar com seu processador atual.
Finalize sua integração com a Dodo Payments e assegure que todos os novos clientes estão sendo direcionados para o checkout da Dodo Payments antes de iniciar a migração. Isso previne inconsistências de dados durante o período de transição.
Certifique-se de que você tem a autorização necessária para solicitar uma exportação de dados do seu processador atual. Normalmente isso requer:
  • Verificação do proprietário da conta
  • Autorização por escrito para acesso a dados sensíveis
  • Conclusão dos passos de verificação de segurança do seu processador

​
Guia de migração passo a passo

1

Request payment method export from your current processor

Entre em contato com a equipe de suporte do seu processador de pagamento atual e envie uma solicitação formal para uma exportação completa dos tokens de cartão dos seus clientes.Você precisará:
  • Fornecer verificação de sua identidade e autorização
  • Solicitar que eles criptografem a exportação usando a chave pública PGP do Dodo Payments (fornecida abaixo)
  • Pedir que eles transfiram o arquivo criptografado diretamente para nosso servidor SFTP seguro
As transferências seguras são feitas diretamente de servidor para servidor via SFTP. Seu Engenheiro de Soluções fornecerá as credenciais do SFTP para você compartilhar com seu processador atual.
Em média, esse processo leva cerca de 2 semanas, embora o tempo varie de acordo com as políticas e os tempos de resposta do seu processador atual.
2

Prepare subscriber data export

Enquanto a transferência do método de pagamento estiver em andamento, exporte os dados dos seus assinantes do seu sistema legado. Seu Engenheiro de Soluções fornecerá um modelo de CSV e orientará você quanto aos campos necessários.

​
Dados de assinante necessários

O campo card_token é crítico—ele é usado para vincular os registros de assinantes aos seus métodos de pagamento durante a importação. Certifique-se de que isso corresponda exatamente ao token na exportação do método de pagamento.

​
Formato de dados de exemplo

3

Validation and testing

Antes da data de importação, nossa equipe irá:
  • Verificar a integridade do arquivo e a criptografia dos dados do método de pagamento
  • Validar seu CSV de assinantes para formatação correta
  • Executar uma importação de teste em nosso ambiente sandbox
  • Identificar e resolver quaisquer problemas de mapeamento de dados
Você receberá um relatório de validação confirmando que tudo está pronto para a importação em produção.
4

Production import

Na data de importação acordada, nossa equipe de engenharia irá:
  1. Importar os dados do método de pagamento em nosso Cofre de Cartões compatível com PCI
  2. Importar seus dados de assinantes
  3. Corresponder assinantes aos seus métodos de pagamento usando os tokens de cartão
  4. Ativar todas as assinaturas migradas
O tempo típico de processamento é de 2 a 3 dias úteis para migrações padrão, dependendo do volume de assinantes.
5

Post-migration verification

Após a conclusão da importação, você receberá:
  • Um relatório abrangente de migração
  • Um CSV mapeando seus antigos IDs de assinatura para novos IDs do Dodo Payments
  • Acesso a todos os clientes migrados em seu painel do Dodo Payments
Recomendamos:
  • Verificar uma amostra das assinaturas migradas no seu painel
  • Testar algumas renovações de assinatura no modo sandbox
  • Atualizar as referências do seu banco de dados interno com os novos IDs
  • Executar monitoramento paralelo durante o primeiro ciclo de cobrança

​
Dados migráveis

Os seguintes dados podem ser transferidos durante uma migração de assinaturas:
O histórico de pagamentos e os registros de transações não podem ser migrados. Recomendamos exportar esses dados do seu processador atual para seus registros antes de concluir a transição.

​
Criptografia PGP

Para máxima segurança ao transferir dados sensíveis do cartão, todos os arquivos devem ser criptografados usando nossa chave pública PGP. Isso fornece uma camada adicional de proteção além da criptografia em nível de transporte. Compartilhe esta chave com seu processador de pagamento atual para criptografar a exportação dos dados do cartão:

​
Expectativas de cronograma

A migração total normalmente leva 3 a 4 semanas do início ao fim. Começar a preparação dos dados dos assinantes enquanto a transferência do método de pagamento está em andamento ajuda a reduzir o tempo total.

​
Comece

Pronto para migrar suas assinaturas para o Dodo Payments? Entre em contato com nossa equipe para iniciar o processo:

Contact Support

Entre em contato para iniciar sua migração e ser conectado a um Engenheiro de Soluções.

API Documentation

Explore nossa API para entender como as assinaturas funcionam no Dodo Payments.
Última modificação em 28 de maio de 2026