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

To simulate failure, close the Afterpay modal window on the redirect page. The payment transitions from requires_action to 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 métodos europeos

Los métodos de pago europeos (iDEAL, Bancontact, EPS, Multibanco) se pueden probar en modo sandbox.
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.
Para consultar la documentación completa sobre métodos de pago europeos, visita la página de Europe.

​
Prácticas recomendadas de prueba

No pruebes únicamente pagos exitosos. Prueba también los rechazos, las cancelaciones y casos extremos, como 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 la Dodo Payments CLI para probar webhooks localmente:
  • dodo wh listen reenvía webhooks de prueba activos a tu servidor local
  • dodo wh trigger envía payloads simulados para los 22 tipos de eventos
Para Apple Pay y Google Pay, prueba en dispositivos iOS y Android reales. Los simuladores no reproducen completamente el comportamiento de las billeteras.
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 mandatos de RBI.

Europe

Pruebas de iDEAL, Bancontact, EPS y Multibanco.

Webhooks

Configura webhooks para eventos de prueba.

CLI Webhook Testing

Prueba webhooks localmente con la Dodo Payments CLI.
Última modificación el 31 de julio de 2026