Skip to main content
O modo de teste permite criar e testar sua integração sem processar pagamentos reais. O modo de produção aceita transações reais dos clientes. Cada modo tem suas próprias chaves de API, produtos e webhooks.

Disponibilidade de recursos

Recursos dependentes e independentes do ambiente

Recursos dependentes do ambiente mantêm dados separados em cada modo. Uma alteração em um modo não afeta o outro. Recursos independentes do ambiente compartilham um único conjunto de dados entre os dois modos. As configurações da sua conta, o perfil da empresa, a conta bancária e os documentos de verificação são os mesmos no modo de teste e no modo de produção; portanto, uma alteração em qualquer um dos modos se aplica a ambos.

Endpoints da API

Use estes hostnames para direcionar as solicitações ao ambiente correto:
  • Modo de teste: https://test.dodopayments.com
  • Modo de produção: https://live.dodopayments.com
A maioria dos SDKs seleciona o ambiente com uma opção do cliente em vez de uma URL base, por exemplo, environment: 'test_mode' em TypeScript. Em vez disso, os SDKs de PHP e C# aceitam a URL base do modo de teste. Consulte SDKs.

Como os modos funcionam

No modo de teste, todas as transações são simuladas e nenhum dinheiro é movimentado. Use os cartões de teste, IDs UPI e outras credenciais em Processo de testes para simular pagamentos bem-sucedidos e com falha. Essa página também contém um vídeo de um pagamento de teste completo. As credenciais de teste funcionam somente no modo de teste. O modo de produção fica disponível assim que você se cadastra. Os pagamentos e payouts de produção são ativados depois que sua conta é aprovada na Verificação da conta. Os produtos, as chaves de API e os webhooks pertencem ao modo em que são criados. Para reutilizar um produto, abra-o no modo de teste e copie-o para o modo de produção. A cópia mantém os detalhes do produto. Uma chave de API do modo de teste não autentica em live.dodopayments.com, e uma chave de produção não autentica em test.dodopayments.com. Para receber webhooks do modo de teste na sua máquina local durante o desenvolvimento, encaminhe-os usando o listener de webhooks da CLI (dodo wh listen).

E-mails no modo de teste

O modo de teste envia e-mails reais aos clientes para o endereço real do destinatário, portanto use endereços que você controla. O assunto de cada e-mail no modo de teste começa com [TEST MODE]. Uma empresa pode enviar até 100 e-mails no modo de teste por semana. Para interromper os e-mails aos clientes no modo de teste, desative E-mails do modo de teste em Configurações → Comunicação → E-mail. Os e-mails do modo live não são afetados. Consulte E-mails do modo de teste e Registros de e-mails de clientes.

Alternar entre modos

Para alternar entre os modos, use o seletor Modo live na barra lateral do dashboard. Use as chaves de API que pertencem ao modo em que você está trabalhando.

Próximos passos

Testing Process

Teste cartões, UPI, BNPL, carteiras e débitos bancários.

Account Verification

Habilite pagamentos e repasses live.
Última modificação em 8 de outubro de 2026