Pular para o conteúdo principal

​
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.

​
Teste Sunbit

1

Set billing country and currency

Certifique-se de que billing_address.country seja US e billing_currency seja USD.
2

Use a qualifying amount

Defina o valor da transação entre 60.00e60.00 e 19,999.00.
3

Complete the Sunbit flow

Selecione Sunbit no checkout e complete a aplicação de financiamento no modal Sunbit.
4

Test failure

Feche o modal Sunbit antes de completar o fluxo para simular uma aplicação recusada. O pagamento transita para requires_payment_method.
Sunbit só aparece para clientes dos EUA pagando em USD com um valor entre 60.00∗∗e∗∗60.00** e **19,999.00.
Para documentação completa de BNPL, incluindo testes Billie B2B, consulte a página Buy Now Pay Later.

​
Testar Carteiras Digitais

​
Apple Pay

1

Enable test mode

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

Add a card to Apple Wallet

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

Complete test purchase

Abra o checkout em um dispositivo Apple e complete o fluxo de Apple Pay.
Apple Pay requer HTTPS. Não aparecerá em localhost sem configuração SSL adequada. A verificação de domínio também deve estar completa.

​
Google Pay

1

Join the test card group

Participe do grupo de cartões de teste do Google Pay para adicionar cartões de teste automaticamente à sua carteira.
2

Enable test mode

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

Complete test purchase

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

​
Amazon Pay, Cash App Pay & RevolutPay

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

​
Testar Métodos Europeus

Métodos de pagamento europeus (iDEAL, Bancontact, EPS, Multibanco) podem ser testados no modo sandbox.
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 faturamento para corresponder ao método de pagamento:
  • NL para iDEAL
  • BE para Bancontact
  • AT para EPS
  • PT para Multibanco
3

Set currency

Métodos europeus requerem moeda EUR.
4

Complete test flow

Siga o fluxo de autenticação bancária simulado no ambiente de teste.
Para documentação completa de métodos de pagamento europeus, consulte a página Europa.

​
Melhores Práticas de Teste

Não teste apenas pagamentos bem-sucedidos. Teste recusas, cancelamentos e casos extremos como fundos insuficientes.
Certifique-se de que seus endpoints webhook processem corretamente todos os tipos de eventos, especialmente payment.succeeded, payment.failed, e eventos de assinatura.Use o CLI do Dodo Payments para testar webhooks localmente:
  • dodo wh listen encaminha webhooks de teste ao vivo para seu servidor local
  • dodo wh trigger envia cargas simuladas para todos os 22 tipos de eventos
Para Apple Pay e Google Pay, teste em dispositivos iOS e Android reais. Simuladores não replicam totalmente o comportamento da carteira.
Métodos de pagamento regionais (UPI, iDEAL, etc.) requerem endereços de faturamento correspondentes. Um endereço de faturamento nos EUA não mostrará iDEAL.
Métodos BNPL requerem valor mínimo de $50.01. Teste se eles aparecem/desaparecem 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

Teste de Apple Pay, Google Pay, Amazon Pay.

BNPL

Testes Klarna, Afterpay e Billie.

India

Testes UPI e mandato RBI.

Europe

Testes iDEAL, Bancontact, EPS, Multibanco.

Webhooks

Configurar webhooks para eventos de teste.

CLI Webhook Testing

Testar webhooks localmente com o CLI do Dodo Payments.
Última modificação em 18 de junho de 2026