Skip to main content
Use as credenciais de teste nesta página para simular pagamentos bem-sucedidos, recusados e com falha no modo de teste. Nenhum dinheiro é movimentado e nenhuma conta real é cobrada. Para ver um pagamento de teste completo, assista a este vídeo.

Full API Access

Todos os endpoints da API estão disponíveis no modo de teste.

Webhook Testing

Webhooks são disparados para transações de teste da mesma forma que em produção.
As credenciais de teste funcionam somente no modo de teste. No modo live, um pagamento feito com uma credencial de teste falha.

​
Cartões de teste

Use estes números de cartão para simular pagamentos bem-sucedidos e recusados em diferentes regiões.
Para todos os cartões de teste, use a data de validade 06/32 (ou 12/34) e o CVV 123.

​
Testando falhas de renovação

1

Create a test subscription

Crie uma assinatura com suas chaves de teste da API usando um cartão de teste aprovado (por exemplo, 4242424242424242). A cobrança inicial deve ser aprovada e a assinatura deve ficar ativa.
2

Update the payment method

Abra o Customer Portal, localize a assinatura e clique em Update Payment Method. Insira o cartão de teste de falha 4000000000000341 (Validade: 12/34, CVV: 123) e salve-o.
3

Advance the next billing date (optional)

Para acionar a renovação imediatamente, em vez de esperar pelo ciclo de cobrança normal, use a API Update Subscription para definir next_billing_date como o horário UTC atual, substituindo o valor de exemplo abaixo. O valor deve ser um timestamp UTC no formato ISO 8601 / RFC 3339 (o sufixo Z é obrigatório).
Consulte a referência da API Update Subscription para obter detalhes.
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 passa primeiro para Past Due (o período de carência; o webhook subscription.past_due contém past_due_ends_at) e depois para On-Hold quando o período de carência termina
  • Um evento de webhook payment.failed é entregue
  • O cliente pode retornar ao Customer Portal para atualizar o método de pagamento e tentar novamente

​
Testar UPI

Os testes de UPI usam identificadores VPA (Virtual Payment Address) especiais que simulam diferentes resultados de pagamento.

​
Requisitos para testes de UPI

  • O país de cobrança deve ser definido como IN
  • A moeda deve ser INR
  • Para comerciantes não indianos: o Adaptive Currency deve estar habilitado
Para obter a documentação completa de UPI, incluindo testes de mandato do RBI para assinaturas, consulte a página Métodos de pagamento da Índia.

​
Testar Pix

Os testes de Pix usam um CPF de teste (documento fiscal brasileiro) para simular o fluxo do código QR.

​
Requisitos para testes de Pix

  • O país de cobrança deve ser definido como BR
  • A moeda deve ser BRL
Insira o CPF de teste quando solicitado no checkout. Um código QR de teste é gerado — escaneie-o com a câmera normal do seu celular (não é necessário usar um app de Pix) e você será redirecionado para uma página de teste onde poderá simular a transação como bem-sucedida ou com falha. Para obter a documentação completa de Pix, consulte a página Pix.

​
Testar BNPL

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

​
Dados de teste da Klarna

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

​
Testes do Afterpay

1

Select Afterpay

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

Test successful payment

Use qualquer endereço de e-mail 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 passa de requires_customer_action para requires_payment_method.
O Afterpay exige 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 testes B2B do Billie, consulte a página Buy Now Pay Later.

​
Testar carteiras digitais

​
Apple Pay

1

Enable test mode

Desative o seletor Live Mode na barra lateral do dashboard e use chaves da API criadas no modo de teste. Consulte Test Mode vs Live Mode.
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 exige 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 adicionar cartões de teste automaticamente à sua carteira.
2

Enable test mode

Desative o seletor Live Mode na barra lateral do dashboard e use chaves da API criadas no modo de teste. Consulte Test Mode vs Live Mode.
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 de carteiras digitais, incluindo a verificação de domínio do Apple Pay, consulte a página Carteiras digitais.

​
Testar ACH Direct Debit

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

Enable test mode

Desative o seletor Live Mode na barra lateral do dashboard e use chaves da API criadas no modo de teste. Consulte Test Mode vs Live Mode.
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. O ACH não é oferecido fora dessa combinação.
3

Use a one-time payment

O 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 número de roteamento e número de conta de teste abaixo e confirme se o seu handler de webhook 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 número de roteamento 110000000 com qualquer um destes números de conta: Para obter 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 modo de teste.
1

Enable test mode

Desative o seletor Live Mode na barra lateral do dashboard e use chaves da API criadas no modo de teste. Consulte Test Mode vs Live Mode.
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.

​
IBANs de teste do SEPA Direct Debit

O 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 obter a lista completa de IBANs de teste, incluindo valores por país, consulte a página Europa. Para obter a documentação completa dos métodos de pagamento europeus, consulte a página Europa.

​
Testar carteiras da Ásia-Pacífico

GCash, Alipay HK, FPS e Touch ‘n Go são pagamentos por código QR que aparecem somente quando o país e a moeda de cobrança correspondem.
1

Enable test mode

Desative o seletor Live Mode na barra lateral do dashboard e use chaves da API criadas no modo de teste. Consulte Test Mode vs Live Mode.
2

Set billing country and currency

Crie um checkout de pagamento único com o par correspondente:
3

Select the method and confirm

Selecione o método e clique em Pay. Um código QR é aberto em uma sobreposição de tela inteira e o checkout aguarda o pagamento.
4

Verify the checkout behavior

Confirme que o método aparece somente para o país e a moeda correspondentes e que o código QR é exibido.
Os códigos QR do modo de teste são emitidos pelo ambiente de teste do provedor da carteira e podem se comportar de forma diferente de um pagamento live.
Para obter a documentação completa, consulte a página Ásia-Pacífico.

​
Práticas recomendadas de teste

Não teste somente pagamentos bem-sucedidos. Teste recusas, cancelamentos e casos extremos, como saldo insuficiente.
Certifique-se de que seus endpoints de webhook processem corretamente todos os tipos de evento, especialmente payment.succeeded, payment.failed e os eventos de assinatura.Use a Dodo Payments CLI para testar webhooks localmente:
  • dodo wh listen encaminha webhooks de teste live 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. 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 US não exibirá o iDEAL.
Os métodos de 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 mandato do RBI.

Pix

Testes de Pix com CPF de teste.

Europe

Testes de iDEAL, Bancontact, EPS e Multibanco.

Asia-Pacific

Testes de GCash, Alipay HK, FPS e Touch ‘n Go.

Webhooks

Configure webhooks para eventos de teste.

CLI Webhook Testing

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