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 Afterpay na página de redirecionamento. O pagamento transita de requires_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 métodos europeus

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

Enable test mode

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

Set billing address

Defina o país do endereço de cobrança de acordo com o 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.
Para obter a documentação completa sobre 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 fundos insuficientes.
Certifique-se de que seus endpoints de webhook processem corretamente todos os tipos de evento, especialmente payment.succeeded, payment.failed e eventos de assinatura.Use a 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 22 tipos de evento
Para Apple Pay e Google Pay, teste em dispositivos iOS e Android reais. Os simuladores não reproduzem completamente o comportamento das carteiras.
Os 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 de BNPL exigem um mínimo de US$ 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 do RBI.

Europe

Testes de iDEAL, Bancontact, EPS e Multibanco.

Webhooks

Configure webhooks para eventos de teste.

CLI Webhook Testing

Teste webhooks localmente com a Dodo Payments CLI.
Última modificação em 31 de julho de 2026