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.
For all test cards, use expiry date 06/32 (or 12/34) and CVV 123.

​
How to Test Renewal Failure

1

Create a test subscription

Create a subscription with your test API keys using a success test card (for example, 4242 4242 4242 4242). The initial charge should succeed and the subscription should become active.
2

Swap in the failure card via Customer Portal

Open the Customer Portal, find the subscription you just created, and click Update Payment Method. Enter the failure test card 4000 0000 0000 0341 (Expiry: 12/34, CVC: 123) and save it as the subscription’s payment method.
3

Advance the next billing date (optional)

To trigger renewal immediately instead of waiting for the natural billing cycle, use the Update Subscription API to set next_billing_date to the current UTC time. The value must be an ISO 8601 / RFC 3339 UTC timestamp (the Z suffix is required).
See the Update Subscription API reference for details.
4

Verify the failure

On the next billing attempt:
  • The renewal charge declines on the failure card
  • The subscription moves to On-Hold status
  • A payment.failed webhook event is delivered
  • The customer can return to the Customer Portal to update the payment method and retry
This card is specifically for testing renewal failures. The charge will decline on the next billing date, allowing you to test payment retry logic, customer notifications, and failure handling.

​
Test UPI

UPI testing uses special VPA (Virtual Payment Address) identifiers that simulate different payment outcomes.

​
Requirements for UPI Testing

  • Billing country must be set to IN
  • Currency must be INR
  • For non-Indian merchants: Adaptive Currency must be enabled
For complete UPI documentation including RBI mandate testing for subscriptions, see the India Payment Methods page.

​
Test BNPL

Buy Now Pay Later providers have specific test data requirements.

​
Klarna Test Data

Use these details to simulate Klarna payments in test mode:
Klarna requires a minimum transaction amount of $50.01 to appear as a payment option.

​
Afterpay Testing

1

Select Afterpay

Choose Afterpay as the payment method in checkout and click Pay.
2

Test successful payment

Use any valid email address and shipping address for successful payments.
3

Test failed authentication

Para simular un fallo, cierra la ventana modal de Afterpay en la página de redirección. El pago pasa de requires_customer_action a requires_payment_method.
Afterpay requires a minimum transaction amount of $50.01 to appear as a payment option.
Para consultar la documentación completa de BNPL, incluidas las pruebas de Billie B2B, visita la página de Buy Now Pay Later.

​
Probar billeteras digitales

​
Apple Pay

1

Enable test mode

Usa tus claves de API de prueba de Dodo Payments.
2

Add a card to Apple Wallet

Añade una tarjeta real a tu Apple Wallet. En el modo de prueba, no se cobrará la tarjeta.
3

Complete test purchase

Abre el checkout en un dispositivo Apple y completa el flujo de Apple Pay.
Apple Pay requiere HTTPS. No aparecerá en localhost sin una configuración SSL adecuada. La verificación del dominio también debe estar completa.

​
Google Pay

1

Join the test card group

Únete al grupo de tarjetas de prueba de Google Pay para que las tarjetas de prueba se añadan automáticamente a tu billetera.
2

Enable test mode

Usa tus claves de API de prueba de Dodo Payments.
3

Complete test purchase

Selecciona una de las tarjetas de prueba en Google Pay para completar la transacción.

​
Amazon Pay, Cash App Pay y RevolutPay

Usa tus claves de API de prueba y sigue el flujo estándar de checkout. Las transacciones de prueba se simulan sin realizar cargos reales. Para consultar la documentación completa sobre billeteras digitales, incluida la verificación de dominios para Apple Pay, visita la página de Digital Wallets.

​
Probar ACH Direct Debit

ACH Direct Debit se puede probar en Test Mode introduciendo datos bancarios de prueba durante el checkout.
1

Enable test mode

Usa tus claves de API de prueba de Dodo Payments.
2

Set currency and billing address

Establece la moneda de facturación en USD y el país de la dirección de facturación en US. ACH no se ofrece fuera de esta combinación.
3

Use a one-time payment

ACH no está disponible en los checkouts de suscripciones, así que pruébalo con un pago único.
4

Enter the test bank details

Introduce uno de los pares de routing number y account number de prueba que aparecen a continuación y confirma que tu webhook handler recibe el estado final del pago — los pagos ACH se confirman de forma asíncrona, no durante el checkout.

​
Cuentas bancarias de prueba

Usa el routing number 110000000 con cualquiera de estos account numbers: Para consultar la lista completa de cuentas de prueba, visita la página ACH Direct Debit.

​
Probar métodos europeos

Los métodos de pago europeos (iDEAL, Bancontact, EPS, Multibanco) se pueden probar en Test Mode.
1

Enable test mode

Usa tus claves de API de prueba de Dodo Payments.
2

Set billing address

Establece el país de la dirección de facturación para que coincida con el método de pago:
  • NL para iDEAL
  • BE para Bancontact
  • AT para EPS
  • PT para Multibanco
3

Set currency

Los métodos europeos requieren la moneda EUR.
4

Complete test flow

Sigue el flujo simulado de autenticación bancaria en el entorno de prueba.

​
IBAN de prueba de SEPA Direct Debit

SEPA Direct Debit requiere EUR y una dirección de facturación de la eurozona. Usa estos IBAN de prueba para forzar un resultado específico: Para consultar la lista completa de IBAN de prueba, incluidos los valores por país, visita la página Europe. Para consultar la documentación completa sobre los métodos de pago europeos, visita la página Europe.

​
Prácticas recomendadas de prueba

No pruebes únicamente pagos exitosos. Prueba los rechazos, las cancelaciones y casos límite como los fondos insuficientes.
Asegúrate de que tus endpoints de webhook procesen correctamente todos los tipos de eventos, especialmente payment.succeeded, payment.failed y los eventos de suscripción.Usa Dodo Payments CLI para probar webhooks localmente:
  • dodo wh listen reenvía webhooks de prueba en tiempo real a tu servidor local
  • dodo wh trigger envía payloads simulados para todos los tipos de eventos de webhook compatibles
Para Apple Pay y Google Pay, prueba en dispositivos iOS y Android reales. Los simuladores no reproducen completamente el comportamiento de las wallets.
Los métodos de pago regionales (UPI, iDEAL, etc.) requieren direcciones de facturación coincidentes. Una dirección de facturación de EE. UU. no mostrará iDEAL.
Los métodos BNPL requieren un mínimo de $50.01. Comprueba que aparezcan o se oculten correctamente según el total del carrito.

​
Páginas relacionadas

Cards

Pruebas de tarjetas, 3D Secure y métodos de pago guardados.

Digital Wallets

Pruebas de Apple Pay, Google Pay y Amazon Pay.

BNPL

Pruebas de Klarna, Afterpay y Billie.

India

Pruebas de UPI y de mandatos de RBI.

Europe

Pruebas de iDEAL, Bancontact, EPS y Multibanco.

Webhooks

Configura webhooks para eventos de prueba.

CLI Webhook Testing

Prueba los webhooks localmente con Dodo Payments CLI.
Última modificación el 17 de agosto de 2026