Skip to main content

​
Overview

Test mode lets you simulate payments without processing real transactions. All test credentials only work in test mode — never use them in production.

No Real Charges

Test transactions don’t process actual payments or affect real accounts.

Full API Access

All API endpoints work identically in test and live modes.

Webhook Testing

Webhooks fire for test transactions just like production.
Test credentials only work in test mode. Attempting to use them in live mode will result in payment failures.

​
Test Cards

Use these card numbers to simulate successful and declined payments across different regions.
Para todos os cartões de teste, use a data de validade 06/32 (ou 12/34) e CVV 123.

​
Como Testar Falha de Renovação

1

Create a test subscription

Crie uma assinatura com suas chaves de API de teste usando um cartão de teste de sucesso (por exemplo, 4242 4242 4242 4242). A cobrança inicial deve ser bem-sucedida e a assinatura deve se tornar ativa.
2

Swap in the failure card via Customer Portal

Abra o Portal do Cliente, encontre a assinatura que você acabou de criar e clique em Atualizar Método de Pagamento. Insira o cartão de teste de falha 4000 0000 0000 0341 (Validade: 12/34, CVC: 123) e salve-o como método de pagamento da assinatura.
3

Advance the next billing date (optional)

Para acionar a renovação imediatamente, em vez de esperar o ciclo de faturamento natural, use a API de Atualização de Assinatura para definir next_billing_date para o horário UTC atual. O valor deve ser um timestamp UTC ISO 8601 / RFC 3339 (o sufixo Z é necessário).
Veja os detalhes na referência API de Atualização de Assinaturas.
4

Verify the failure

Na próxima tentativa de cobrança:
  • A cobrança de renovação é recusada no cartão de falha
  • A assinatura muda para o status Em Espera
  • Um evento webhook payment.failed é enviado
  • O cliente pode retornar ao Portal do Cliente para atualizar o método de pagamento e tentar novamente
Este cartão é especificamente para testar falhas de renovação. A cobrança será recusada na próxima data de faturamento, permitindo que você teste a lógica de tentativa de pagamento, notificações ao cliente e tratamento de falhas.

​
Testar UPI

O teste UPI usa identificadores especiais de VPA (Endereço de Pagamento Virtual) que simulam diferentes resultados de pagamento.

​
Requisitos para Teste de UPI

  • O país de faturamento deve ser definido como IN
  • A moeda deve ser INR
  • Para comerciantes não indianos: Moeda Adaptativa deve estar ativada
Para documentação completa de UPI, incluindo testes de mandato do RBI para assinaturas, consulte a página Métodos de Pagamento na Índia.

​
Testar BNPL

Os provedores de Buy Now Pay Later têm requisitos específicos de dados de teste.

​
Dados de Teste Klarna

Use estes detalhes para simular pagamentos Klarna no modo de teste:
Klarna exige um valor mínimo de transação de $50.01 para aparecer como opção de pagamento.

​
Teste Afterpay

1

Select Afterpay

Escolha Afterpay como o método de pagamento no checkout e clique em Pagar.
2

Test successful payment

Use qualquer endereço de email e endereço de entrega válidos para pagamentos bem-sucedidos.
3

Test failed authentication

Para simular uma falha, feche a janela modal do Afterpay na página de redirecionamento. O pagamento muda de requires_customer_action para requires_payment_method.
Afterpay requer um valor mínimo de transação de $50.01 para aparecer como opção de pagamento.
Para obter a documentação completa de BNPL, incluindo os testes B2B do Billie, consulte a página Buy Now Pay Later.

​
Testar carteiras digitais

​
Apple Pay

1

Enable test mode

Use suas chaves de teste da API do Dodo Payments.
2

Add a card to Apple Wallet

Adicione um cartão real à sua Apple Wallet. No modo de teste, o cartão não será cobrado.
3

Complete test purchase

Abra o checkout em um dispositivo Apple e conclua o fluxo do Apple Pay.
O Apple Pay requer HTTPS. Ele não aparecerá em localhost sem a configuração adequada de SSL. A verificação do domínio também deve estar concluída.

​
Google Pay

1

Join the test card group

Participe do grupo de cartões de teste do Google Pay para que os cartões de teste sejam adicionados automaticamente à sua carteira.
2

Enable test mode

Use suas chaves de teste da API do Dodo Payments.
3

Complete test purchase

Selecione um dos cartões de teste no Google Pay para concluir a transação.

​
Amazon Pay, Cash App Pay e RevolutPay

Use suas chaves de teste da API e siga o fluxo padrão de checkout. As transações de teste são simuladas sem cobranças reais. Para obter a documentação completa sobre carteiras digitais, incluindo a verificação de domínio do Apple Pay, consulte a página Digital Wallets.

​
Testar ACH Direct Debit

ACH Direct Debit pode ser testado no Test Mode inserindo dados bancários de teste no checkout.
1

Enable test mode

Use suas chaves de teste da API do Dodo Payments.
2

Set currency and billing address

Defina a moeda de cobrança como USD e o país do endereço de cobrança como US. ACH não é oferecido fora dessa combinação.
3

Use a one-time payment

ACH não está disponível em checkouts de assinaturas, portanto teste-o com um pagamento único.
4

Enter the test bank details

Insira um dos pares de routing number e account number de teste abaixo e confirme se o seu webhook handler recebe o status final do pagamento — os pagamentos ACH são confirmados de forma assíncrona, e não no checkout.

​
Contas bancárias de teste

Use o routing number 110000000 com qualquer um destes account numbers: Para ver a lista completa de contas de teste, consulte a página ACH Direct Debit.

​
Testar métodos europeus

Os métodos de pagamento europeus (iDEAL, Bancontact, EPS, Multibanco) podem ser testados no Test Mode.
1

Enable test mode

Use suas chaves de API de teste do Dodo Payments.
2

Set billing address

Defina o país do endereço de cobrança para corresponder ao método de pagamento:
  • NL para iDEAL
  • BE para Bancontact
  • AT para EPS
  • PT para Multibanco
3

Set currency

Os métodos europeus exigem a moeda EUR.
4

Complete test flow

Siga o fluxo simulado de autenticação bancária no ambiente de teste.

​
IBANs de teste para SEPA Direct Debit

SEPA Direct Debit exige EUR e um endereço de cobrança na Zona do Euro. Use estes IBANs de teste para forçar um resultado específico: Para ver a lista completa de IBANs de teste, incluindo valores por país, consulte a página Europe. Para obter a documentação completa sobre os métodos de pagamento europeus, consulte a página Europe.

​
Práticas recomendadas de teste

Não teste apenas pagamentos bem-sucedidos. Teste recusas, cancelamentos e casos extremos, como falta de fundos.
Garanta que seus endpoints de webhook processem corretamente todos os tipos de evento, especialmente payment.succeeded, payment.failed e eventos de assinatura.Use o Dodo Payments CLI para testar webhooks localmente:
  • dodo wh listen encaminha webhooks de teste ativos para o seu servidor local
  • dodo wh trigger envia payloads simulados para todos os tipos de evento de webhook compatíveis
Para Apple Pay e Google Pay, teste em dispositivos iOS e Android reais. Simuladores não reproduzem completamente o comportamento das carteiras digitais.
Métodos de pagamento regionais (UPI, iDEAL etc.) exigem endereços de cobrança correspondentes. Um endereço de cobrança dos EUA não exibirá o iDEAL.
Os métodos BNPL exigem um mínimo de $50.01. Teste se eles aparecem ou ficam ocultos corretamente com base no total do carrinho.

​
Páginas relacionadas

Cards

Testes de cartões, 3D Secure e métodos de pagamento salvos.

Digital Wallets

Testes de Apple Pay, Google Pay e Amazon Pay.

BNPL

Testes de Klarna, Afterpay e Billie.

India

Testes de UPI e do mandato RBI.

Europe

Testes de iDEAL, Bancontact, EPS e Multibanco.

Webhooks

Configure webhooks para eventos de teste.

CLI Webhook Testing

Teste webhooks localmente com o Dodo Payments CLI.
Última modificação em 17 de agosto de 2026