Saltar al contenido 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.

​
Resumen

El modo de prueba te permite simular pagos sin procesar transacciones reales. Todas las credenciales de prueba solo funcionan en modo de prueba; nunca las uses en producción.

No Real Charges

Las transacciones de prueba no procesan pagos reales ni afectan cuentas reales.

Full API Access

Todos los endpoints de la API funcionan idénticamente en los modos de prueba y en vivo.

Webhook Testing

Los webhooks se activan para las transacciones de prueba igual que en producción.
Las credenciales de prueba solo funcionan en modo de prueba. Si intentas usarlas en modo en vivo, los pagos fallarán.

​
Tarjetas de Prueba

Usa estos números de tarjeta para simular pagos exitosos y rechazados en diferentes regiones.
RegiónMarcaNúmero de tarjetaVenceCVV
EE. UU.Visa424242424242424206/32123
EE. UU.Mastercard555555555555444406/32123
IndiaVisa457623891277145006/32123
IndiaMastercard540916266938103406/32123
Para todas las tarjetas de prueba, use la fecha de caducidad 06/32 (o 12/34) y CVV 123.

​
Cómo Probar la Fallo de Renovación

1

Create a test subscription

Cree una suscripción con sus claves API de prueba usando una tarjeta de prueba exitosa (por ejemplo, 4242 4242 4242 4242). El cargo inicial debería tener éxito y la suscripción debería activarse.
2

Swap in the failure card via Customer Portal

Abra el Portal del Cliente, busque la suscripción que acaba de crear y haga clic en Actualizar método de pago. Ingrese la tarjeta de prueba de fallo 4000 0000 0000 0341 (Expiry: 12/34, CVC: 123) y guárdela como el método de pago de la suscripción.
3

Advance the next billing date (optional)

Para activar la renovación inmediatamente en lugar de esperar el ciclo de facturación natural, use la API de Actualización de Suscripción para establecer next_billing_date a la hora UTC actual. El valor debe ser una marca de tiempo UTC en formato ISO 8601 / RFC 3339 (es necesario el sufijo Z).
PATCH /subscriptions/{subscription_id}
{
  "next_billing_date": "2026-05-03T00:00:00Z"
}
Consulte la referencia de la API de Actualización de Suscripción para más detalles.
4

Verify the failure

En el próximo intento de facturación:
  • El cargo de renovación se rechaza con la tarjeta de fallo
  • La suscripción se mueve al estado En espera
  • Se entrega un evento webhook payment.failed
  • El cliente puede volver al Portal del Cliente para actualizar el método de pago e intentarlo nuevamente
Esta tarjeta es específicamente para probar fallos de renovación. El cargo será rechazado en la próxima fecha de facturación, permitiéndole probar la lógica de reintento de pago, notificaciones al cliente y manejo de fallos.

​
Prueba UPI

La prueba UPI utiliza identificadores especiales de VPA (Dirección de Pago Virtual) que simulan diferentes resultados de pago.
EstadoID UPI
Éxitosuccess@upi
Fallofailure@upi

​
Requisitos para la Prueba UPI

  • El país de facturación debe estar establecido en IN
  • La moneda debe ser INR
  • Para comerciantes no indios: debe estar habilitada la Moneda Adaptativa
Para obtener documentación completa de UPI, incluyendo pruebas de mandato de RBI para suscripciones, consulte la página de Métodos de Pago en India.

​
Prueba BNPL

Los proveedores de Compre Ahora Pague Después tienen requisitos específicos de datos de prueba.

​
Datos de Prueba de Klarna

Use estos detalles para simular pagos de Klarna en modo de prueba:
CampoAprobadoDenegado
Fecha de Nacimiento07-10-197007-10-1970
NombreTestTest
ApellidoPerson-usPerson-us
Correo Electrónicocustomer@email.uscustomer+denied@email.us
CalleAmsterdam AveAmsterdam Ave
Número509509
CiudadNueva YorkNueva York
EstadoNueva YorkNueva York
Código Postal10024-394110024-3941
Teléfono+13106683312+13106354386
Klarna requiere un monto mínimo de transacción de $50.01 para aparecer como opción de pago.

​
Prueba de Afterpay

1

Select Afterpay

Elija Afterpay como método de pago en la caja y haga clic en Pagar.
2

Test successful payment

Use cualquier dirección de correo electrónico y dirección de envío válidas para pagos exitosos.
3

Test failed authentication

Para simular fallos, cierre la ventana modal de Afterpay en la página de redirección. El pago pasará de requires_action a requires_payment_method.
Afterpay requiere un monto mínimo de transacción de $50.01 para aparecer como opción de pago.
Para obtener documentación completa de BNPL, incluyendo pruebas de Billie B2B, consulte la página de Compre Ahora Pague Después.

​
Prueba de Wallets Digitales

​
Apple Pay

1

Enable test mode

Use sus claves API de prueba de Dodo Payments.
2

Add a card to Apple Wallet

Agregue una tarjeta real a su Apple Wallet. En modo de prueba, la tarjeta no será cargada.
3

Complete test purchase

Abra el pago en un dispositivo Apple y complete el flujo de Apple Pay.
Apple Pay requiere HTTPS. No aparecerá en localhost sin la configuración adecuada de SSL. También se debe completar la verificación de dominio.

​
Google Pay

1

Join the test card group

Únase al grupo de tarjetas de prueba de Google Pay para tener tarjetas de prueba agregadas automáticamente a su billetera.
2

Enable test mode

Use sus claves API de prueba de Dodo Payments.
3

Complete test purchase

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

​
Amazon Pay, Cash App Pay & RevolutPay

Use sus claves API de prueba y siga el flujo estándar de pago. Las transacciones de prueba se simulan sin cargos reales. Para obtener documentación completa de billeteras digitales, incluyendo la verificación de dominio para Apple Pay, consulte la página de Billeteras Digitales.

​
Prueba de Métodos Europeos

Los métodos de pago europeos (iDEAL, Bancontact, EPS, Multibanco) pueden probarse en modo sandbox.
1

Enable test mode

Use sus claves API de prueba de Dodo Payments.
2

Set billing address

Establezca 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 moneda EUR.
4

Complete test flow

Siga el flujo de autenticación bancaria simulado en el entorno de prueba.
Para obtener documentación completa de métodos de pago europeos, consulte la página de Europa.

​
Mejores Prácticas de Pruebas

No solo pruebe pagos exitosos. Pruebe rechazos, cancelaciones y casos extremos como fondos insuficientes.
Asegúrese de que sus endpoints webhook procesen correctamente todos los tipos de eventos, especialmente payment.succeeded, payment.failed, y eventos de suscripción.Use el CLI de Dodo Payments para probar webhooks localmente:
  • dodo wh listen reenvía webhooks de prueba en vivo a su servidor local
  • dodo wh trigger envía cargas útiles simuladas para los 22 tipos de eventos
Para Apple Pay y Google Pay, pruebe en dispositivos reales iOS y Android. Los simuladores no replican 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 los EE. UU. no mostrará iDEAL.
Los métodos BNPL requieren un mínimo de $50.01. Asegúrese de que aparecen/desaparecen correctamente según el total del carrito.

​
Páginas Relacionadas

Cards

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

Digital Wallets

Prueba de Apple Pay, Google Pay, y Amazon Pay.

BNPL

Pruebas de Klarna, Afterpay, y Billie.

India

Pruebas de UPI y mandato de RBI.

Europe

Pruebas de iDEAL, Bancontact, EPS, Multibanco.

Webhooks

Configure webhooks para eventos de prueba.

CLI Webhook Testing

Pruebe webhooks localmente con el CLI de Dodo Payments.
Last modified on May 4, 2026