Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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.
RegionBrandCard NumberExpiryCVV
USVisa424242424242424206/32123
USMastercard555555555555444406/32123
IndiaVisa457623891277145006/32123
IndiaMastercard540916266938103406/32123
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 o método de pagamento da assinatura.
3

Advance the next billing date (optional)

Para acionar a renovação imediatamente, em vez de aguardar o ciclo de cobrança natural, use a API Atualizar 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).
PATCH /subscriptions/{subscription_id}
{
  "next_billing_date": "2026-05-03T00:00:00Z"
}
Consulte a referência da API de Atualização de Assinatura para detalhes.
4

Verify the failure

Na próxima tentativa de cobrança:
  • A cobrança de renovação falha no cartão de falha
  • A assinatura passa para o status Em Espera
  • Um evento webhook payment.failed é entregue
  • 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 cobrança, permitindo que você teste a lógica de nova 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.
StatusUPI ID
Sucessosuccess@upi
Falhafailure@upi

​
Requisitos para Teste UPI

  • O país de cobrança deve ser configurado para IN
  • A moeda deve ser INR
  • Para comerciantes não indianos: A Moeda Adaptativa deve estar habilitada
Para documentação completa do UPI, incluindo teste de mandato do RBI para assinaturas, consulte a página India Payment Methods.

​
Testar BNPL

Os provedores de Compre Agora Pague Depois têm requisitos específicos de dados de teste.

​
Dados de Teste da Klarna

Use estes detalhes para simular pagamentos Klarna em modo de teste:
CampoAprovadoNegado
Data de Nascimento07-10-197007-10-1970
NomeTesteTeste
SobrenomePessoa-usPessoa-us
Emailcliente@email.uscliente+negado@email.us
RuaAmsterdam AveAmsterdam Ave
Número da Casa509509
CidadeNova YorkNova York
EstadoNova YorkNova York
CEP10024-394110024-3941
Telefone+13106683312+13106354386
Klarna requer 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 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 falha, feche a janela modal do Afterpay na página de redirecionamento. O pagamento passa 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 documentação completa do BNPL, incluindo testes Billie B2B, veja 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 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 complete o fluxo do Apple Pay.
Apple Pay requer HTTPS. Não aparecerá em localhost sem configuração adequada de SSL. A verificação de domínio também deve estar completa.

​
Google Pay

1

Join the test card group

Junte-se ao grupo de cartões de teste do Google Pay para obter cartões de teste automaticamente adicionados à 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, veja a página Digital Wallets.

​
Testar Métodos Europeus

Os métodos de pagamento europeus (iDEAL, Bancontact, EPS, Multibanco) podem ser testados em 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 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 requerem moeda em EUR.
4

Complete test flow

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

​
Melhores Práticas de Teste

Não teste apenas pagamentos bem-sucedidos. Teste recusas, cancelamentos e casos extremos, como fundos insuficientes.
Garanta que seus endpoints de webhook processem corretamente todos os tipos de eventos, 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 ao vivo para seu servidor local
  • dodo wh trigger envia payloads simulados para todos os 22 tipos de eventos
Para Apple Pay e Google Pay, teste em dispositivos iOS e Android reais. Simuladores não replicam completamente o comportamento da carteira.
Métodos regionais de pagamento (UPI, iDEAL, etc.) requerem endereços de cobrança correspondentes. Um endereço de cobrança dos EUA não mostrará iDEAL.
Métodos BNPL requerem um mínimo de $50,01. Teste se eles aparecem/corretamente são ocultados com base no total do carrinho.

​
Páginas Relacionadas

Cards

Testes de cartão, 3D Secure e métodos de pagamento salvos.

Digital Wallets

Testes de Apple Pay, Google Pay, Amazon Pay.

BNPL

Testes Klarna, Afterpay e Billie.

India

Testes de UPI e mandatos RBI.

Europe

Testes de iDEAL, Bancontact, EPS, Multibanco.

Webhooks

Configurar webhooks para eventos de teste.

CLI Webhook Testing

Teste webhooks localmente com o Dodo Payments CLI.
Last modified on May 4, 2026