Introducción

La API de Dodo Payments proporciona endpoints completos para el procesamiento de pagos, la gestión de suscripciones y la entrega de productos digitales. Nuestra API RESTful sigue los estándares del sector con respuestas detalladas para todas las operaciones.

SDKs & Libraries

Acelera tu integración utilizando los SDK oficiales para TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby y React Native. Estas bibliotecas simplifican las solicitudes a la API, la autenticación y la gestión de errores, lo que te permite centrarte en crear excelentes experiencias de pago.

​

URLs de entorno

• Modo de prueba: https://test.dodopayments.com
• Modo activo: https://live.dodopayments.com

Obtén más información sobre el modo de prueba frente al modo activo.

​

Gestión y autenticación de API Keys

1. Access API Keys

   Ve a Developer → API Keys en tu dashboard para gestionar tus claves.

2. Generate a New Key

   Selecciona Add API Key, proporciona un nombre descriptivo y configura el acceso de escritura:

   • Enable write access (marcado): permisos completos de lectura y escritura para todas las operaciones de la API
   • Enable write access (sin marcar): acceso de solo lectura; únicamente puede obtener datos (pagos, suscripciones, clientes y productos). No puede crear ni modificar recursos.

   Desmarca “Enable write access” para las integraciones con el dashboard, las herramientas de analítica y cualquier sistema que solo necesite consultar datos sin realizar cambios.

3. Store Your Key Securely

   Copia inmediatamente la clave generada y asegúrate de almacenarla de forma segura.

4. Authenticate Your API Requests

   Utiliza tus API Keys para autenticar todas las solicitudes. Aplica el siguiente formato de autorización:

   Authorization: Bearer YOUR_API_KEY
   

   Nunca expongas tus API Keys secretas en código del lado del cliente ni en repositorios públicos.

​

Formato de respuesta

Success Response

{
  "id": "pay_1234567890",
  "status": "succeeded",
  "amount": 2999,
  "currency": "USD",
  "created_at": "2024-01-15T10:30:00Z"
}

​

Límites de solicitudes

Nuestra API utiliza un sistema de límites de solicitudes con dos ventanas y protección contra ráfagas. Los límites se aplican según tu método de autenticación y tu nivel empresarial.

​

Límites predeterminados (nivel 0)

Ventana	Límite
Por segundo (ráfaga)	40 solicitudes
Por minuto (sostenido)	240 solicitudes

​

Niveles empresariales

Hay límites de solicitudes más altos disponibles para empresas con mayores necesidades de API:

Nivel	Ráfaga (por segundo)	Sostenido (por minuto)
Nivel 0 (predeterminado)	40	240
Nivel 1	100	1.000
Nivel 2	500	5.000

Contacta con soporte para actualizar tu empresa a un nivel de límite de solicitudes superior.

​

Solicitudes no autenticadas

Las solicitudes sin headers de autenticación válidos tienen límites por dirección IP:

Ventana	Límite
Por segundo (ráfaga)	20 solicitudes
Por minuto (sostenido)	100 solicitudes

​

Headers de límite de solicitudes

Supervisa tu uso con estos headers de respuesta:

• X-RateLimit-Limit - Número máximo de solicitudes permitidas
• X-RateLimit-Remaining - Solicitudes restantes en la ventana actual
• X-RateLimit-Reset - Momento en que se restablece el límite de solicitudes

Cuando superas los límites de solicitudes, la API devuelve una respuesta 429 Too Many Requests. Implementa un backoff exponencial en tu lógica de reintentos.

​

Gestión de errores

Para gestionar los errores de forma eficaz, consulta las secciones Códigos de error y Fallos de transacciones para obtener instrucciones detalladas.

Error Codes

Consulta detalles completos sobre los errores y sus soluciones.

Transaction Failures

Conoce los problemas habituales de las transacciones y sus soluciones.

​

Webhooks

Recibe notificaciones en tiempo real sobre los eventos de pago. Consulta nuestra guía de Webhooks para obtener instrucciones de configuración.

Webhook Guide

Configura Webhooks para recibir notificaciones en tiempo real y gestionar eventos.

​

Guías de desarrollo relacionadas

Explora nuestras guías completas para comprender cómo implementar funciones clave utilizando la API:

One-time Payments Integration

Aprende a integrar pagos únicos, sesiones de checkout y enlaces de pago en tu aplicación

Subscription Integration

Guía completa para implementar suscripciones, gestionar planes y administrar eventos del ciclo de vida de las suscripciones

Usage-Based Billing

Configura medidores y eventos de uso para la facturación medida y los modelos de precios basados en el consumo

Webhooks

Recibe notificaciones en tiempo real y automatiza flujos de trabajo con eventos de Webhooks

Checkout Sessions

Crea experiencias de checkout alojadas y seguras con personalización completa y funciones avanzadas