SDKs & Libraries
SDK oficiales de backend para TypeScript, Python, Go, PHP, Java, Kotlin, C#, Ruby y Rust. Estas bibliotecas simplifican las solicitudes a la API, la autenticación y el manejo de errores, para que puedas centrarte en crear excelentes experiencias de pago.
Mobile Checkout SDKs
¿Estás creando una aplicación nativa? Abre el checkout alojado de Dodo y obtén un resultado tipado en una sola llamada, en Android, iOS, React Native y Flutter. Estos no contienen ninguna API key.
URL 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 y el modo activo.
Administración y autenticación de API keys
1
Access API Keys
Ve a Developer → API Keys en tu dashboard para administrar tus claves.
2
Generate a New Key
Selecciona Add API Key, proporciona un nombre descriptivo y configura el acceso de escritura:
- Enable write access (seleccionado): permisos completos de lectura y escritura para todas las operaciones de la API
- Enable write access (no seleccionado): acceso de solo lectura; solo permite obtener datos (pagos, suscripciones, clientes y productos). No permite crear ni modificar recursos.
3
Store Your Key Securely
Copia inmediatamente la clave generada y asegúrate de almacenarla de forma segura.
4
Authenticate Your API Requests
Usa tus API keys para autenticar todas las solicitudes. Aplica el siguiente formato de autorización:
Formato de respuesta
Límites de solicitudes
Nuestra API utiliza un sistema de limitación de solicitudes de doble ventana con protección contra picos. Los límites se aplican según tu método de autenticación y el nivel de tu empresa.Límites predeterminados (nivel 0)
Niveles empresariales
Hay límites de solicitudes más altos disponibles para empresas con mayores necesidades de API:Solicitudes no autenticadas
Las solicitudes sin encabezados de autenticación válidos tienen un límite basado en la dirección IP:Encabezados de límite de solicitudes
Supervisa tu uso con estos encabezados de respuesta:X-RateLimit-Limit- Máximo de solicitudes permitidasX-RateLimit-Remaining- Solicitudes restantes en la ventana actualX-RateLimit-Reset- Momento en que se restablece el límite de solicitudes
Cuando superes los límites de solicitudes, la API devuelve una respuesta
429 Too Many Requests. Implementa un retroceso exponencial en tu lógica de reintento.Manejo 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 información detallada sobre los errores y sus resoluciones.
Transaction Failures
Obtén información sobre 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 mediante 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, administrar planes y gestionar eventos del ciclo de vida de las suscripciones
Usage-Based Billing
Configura medidores y eventos de uso para la facturación medida y modelos de precios basados en el consumo
Webhooks
Recibe notificaciones en tiempo real y automatiza flujos de trabajo con eventos de webhook
Checkout Sessions
Crea experiencias de checkout alojado seguras, con personalización completa y funciones avanzadas