Skip to main content
Dodo Migrate é uma ferramenta CLI que move seus dados do Lemon Squeezy, Stripe, Polar.sh ou Paddle para o Dodo Payments. Ela solicita cada escolha e pode migrar primeiro para o modo de teste, para que você verifique o resultado antes de mover os dados de produção.

​
O que você pode migrar

Products & Pricing

Produtos e seus preços.

Customers

Registros de clientes, incluindo dados de contato.

Discount Codes

Códigos de desconto e cupons.

License Keys

Chaves de licença com associações de clientes e produtos (somente Polar.sh e Lemon Squeezy).
A ferramenta não migra assinaturas, histórico de pagamentos nem métodos de pagamento salvos. Planeje como seus assinantes atuais passarão para o Dodo Payments antes de fazer a troca. Consulte Migração de assinaturas.

​
Instalar a ferramenta

Você precisará do Node.js 18 ou posterior.

​
Executar uma migração

Escolha o comando correspondente ao seu provedor atual:
A ferramenta solicita:
  • A chave de API do seu provedor
  • A chave de API do Dodo Payments
  • Se deseja testar primeiro ou entrar em produção
  • Para qual marca do Dodo Payments migrar
  • Quais dados migrar (produtos, clientes, descontos, chaves de licença)

​
Modo não interativo

Para ignorar as solicitações, passe os valores como flags. --mode aceita test_mode ou live_mode. Use uma chave de API do Dodo Payments criada no mesmo modo. Se você omitir --dodo-brand-id, a ferramenta listará suas marcas e pedirá que você escolha uma. A flag que seleciona o que migrar é --types para o Lemon Squeezy e --migrate-types para os outros provedores. Se você a omitir, a ferramenta solicitará que você escolha. Quando nenhum terminal estiver conectado, o Paddle migrará apenas produtos, e o Polar.sh migrará produtos e descontos.

​
Migração de chaves de licença

As chaves de licença podem ser migradas do Polar.sh e do Lemon Squeezy. Quando você seleciona chaves de licença na solicitação interativa ou passa license_keys em --types (Lemon Squeezy) ou --migrate-types (Polar.sh), a ferramenta importa suas chaves existentes com as associações corretas de clientes e produtos.
A migração de chaves de licença exige que produtos e clientes sejam migrados na mesma sessão. Durante a execução, a ferramenta cria um mapeamento em memória dos IDs do provedor para os IDs do Dodo. Se produtos ou clientes estiverem ausentes, as chaves de licença não poderão ser associadas corretamente.

​
O que é migrado

  • Strings das chaves de licença
  • Limites de ativação
  • Datas de expiração
  • Associações de clientes e produtos

​
O que não é migrado

  • Ativações de chaves de licença — os clientes deverão reativá-las em seus dispositivos após a migração.
  • Chaves revogadas ou desativadas — somente chaves ativas são migradas.
  • Chaves sem um produto ou cliente correspondente são ignoradas com um aviso.
Se você executar a migração novamente, as chaves já importadas serão detectadas e ignoradas, portanto é seguro tentar novamente.

​
Obter ajuda

  • Ajuda da ferramenta: dodo-migrate --help
  • Ajuda específica do provedor: dodo-migrate lemonsqueezy --help (ou stripe, polar, paddle)
  • Comunidade: Discord
  • Relatar problemas: GitHub

​
Atualizar ou desinstalar

Última modificação em 26 de setembro de 2026