Descripción general de SDKs oficiales - Dodo Payments Documentation

Dodo Payments proporciona SDKs oficiales para múltiples lenguajes de programación, cada uno diseñado con las mejores prácticas específicas del lenguaje y características modernas para una integración de pagos sin problemas.

Utiliza siempre la versión más reciente del SDK para acceder a las funciones e mejoras más recientes. Revisa tu gestor de paquetes periódicamente para asegurarte de tener acceso a todas las capacidades de Dodo Payments.

SDKs disponibles

Elige el SDK que coincida con tu stack tecnológico:

TypeScript SDK

Integración con tipado seguro para TypeScript y Node.js con API basada en promesas y auto-paginación

Python SDK

Interfaz de estilo pythonico con soporte para async/await en aplicaciones Python 3.7+

PHP SDK

SDK compatible con PSR-4 para aplicaciones PHP 8.1+ modernas

Go SDK

Interfaz idiomática de Go con soporte de context y tipado fuerte

Ruby SDK

Interfaz elegante de Ruby siguiendo las convenciones y mejores prácticas de Ruby

Java SDK

SDK robusto y seguro para hilos en Java 8+ con soporte para Maven y Gradle

Kotlin SDK

SDK moderno de Kotlin con corutinas, seguridad contra nulos y funciones de extensión

C# SDK

SDK con tipado seguro para .NET 8+ con API basada en async Task (Beta)

Rust SDK

SDK orientado a la asincronía construido sobre Tokio y reqwest con fuerte tipado para Rust 1.75+

CLI

Interfaz de línea de comandos para interactuar con la API desde tu terminal

¿Estás creando una aplicación móvil? Consulta los SDKs de Mobile Checkout a continuación para Android, iOS, React Native y Flutter.

Inicio Rápido

Comienza con cualquier SDK en minutos:

Install the SDK

Usa el gestor de paquetes de tu lenguaje para instalar el SDK

TypeScript/Node.js
Python
PHP
Go
Rust

npm install dodopayments

pip install dodopayments

composer require dodopayments/client

go get github.com/dodopayments/dodopayments-go

cargo add dodopayments

Initialize the Client

Configura el cliente con tu clave API

TypeScript
Python
PHP
Go
Rust

import DodoPayments from 'dodopayments';
const client = new DodoPayments({ bearerToken: 'your_api_key' });

from dodopayments import DodoPayments
client = DodoPayments(bearer_token="your_api_key")

use Dodopayments\Client;
$client = new Client(bearerToken: 'your_api_key');

import "github.com/dodopayments/dodopayments-go"
client := dodopayments.NewClient(option.WithBearerToken("your_api_key"))

use dodopayments::Client;
let client = Client::from_env()?; // reads DODO_PAYMENTS_API_KEY

Siempre almacena tus claves API de forma segura utilizando variables de entorno. Nunca las comprometas al control de versiones.

Make Your First API Call

Crea una sesión de pago o pago

¡Ahora estás listo para procesar pagos! Visita las páginas individuales de los SDK para guías y ejemplos detallados.

Características Clave

Todos los SDKs de backend comparten estas capacidades principales. Los SDKs de Mobile Checkout a continuación son deliberadamente más limitados: no contienen ninguna API key ni llaman a la API:

Seguridad de tipos: Tipado fuerte para garantizar la seguridad en tiempo de compilación y ofrecer mejor compatibilidad con el IDE
Manejo de errores: Manejo integral de excepciones con mensajes de error detallados
Autenticación: Autenticación sencilla mediante API key con compatibilidad con variables de entorno
Compatibilidad con async: Patrones modernos de async/await cuando corresponde
Paginación automática: Paginación automática para respuestas de listas
Facturación basada en el uso: Compatibilidad integrada para realizar el seguimiento e ingerir eventos de uso
Pruebas: Compatibilidad completa con Test Mode para desarrollo y pruebas

SDKs de Mobile Checkout

Si prefieres abrir la página de checkout alojada de Dodo en lugar de crear una hoja de pago nativa, usa el SDK de Mobile Checkout para tu plataforma. Los cuatro comparten el mismo contrato de una sola llamada: start(...) devuelve un CheckoutResult tipado, ninguno contiene una API key, y Apple Pay/Google Pay funcionan de la misma manera que en la web abierta, ya que el checkout se abre en la superficie del navegador real de la plataforma (SFSafariViewController / Custom Tabs), no en un WebView:

Android

SDK de Kotlin que abre una Chrome Custom Tab. Requiere minSdk 23

iOS

SDK de Swift que abre SFSafariViewController. Requiere iOS 16+

React Native

Turbo Module sobre ambos núcleos nativos. Requiere React Native 0.76+

Flutter

Canal Pigeon sobre ambos núcleos nativos. Requiere Flutter 3.44+

Mobile Integration Guide

El flujo de pago móvil de extremo a extremo, desde la sesión de checkout del backend hasta la configuración del esquema de callback

Interfaz de línea de comandos

Para flujos de trabajo y automatización basados en terminal:

CLI

Interfaz de línea de comandos generada automáticamente con compatibilidad para la API de Dodo Payments

Características:

Estructura de comandos basada en recursos para un uso intuitivo
Múltiples formatos de salida (JSON, YAML, legible, interactivo)
Autocompletado de shell para bash, zsh y fish
Ideal para scripting y automatización de CI/CD

# Quick example
dodopayments payments list --format json | jq '.items[] | {payment_id, total_amount}'

Migración desde el SDK de Node.js

Migramos del SDK de Node.js al nuevo SDK de TypeScript. Si usas el SDK heredado de Node.js, consulta la guía de migración para actualizar tu integración.

Adaptadores de frameworks

Integra en menos de 10 líneas de código con nuestros adaptadores de frameworks. Elige entre nuestros frameworks recomendados o explora todas las opciones compatibles.

Frameworks recomendados

Next.js

Framework full-stack basado en React con compatibilidad con App Router

Better Auth

Framework de autenticación con integraciones integradas

Supabase

Alternativa de código abierto a Firebase con Postgres y Auth

Convex

Backend-as-a-Service con capacidades en tiempo real

Show other 8+ supported frameworks

SvelteKit

Nuxt

Remix

Express

Fastify

Hono

Astro

TanStack

Obtener ayuda

¿Necesitas ayuda con algún SDK?

Discord: Únete a nuestro servidor de la comunidad para recibir ayuda en tiempo real
Email: Contáctanos en support@dodopayments.com
GitHub: Abre un issue en el repositorio del SDK correspondiente
Documentación: Visita nuestra referencia de la API

Contribuir

¡Damos la bienvenida a las contribuciones para todos nuestros SDKs! Cada repositorio tiene un archivo CONTRIBUTING.md con directrices sobre:

Informar de errores
Solicitar funcionalidades
Enviar pull requests
Ejecutar pruebas localmente
Estilo y convenciones del código

Visita las páginas individuales de los SDKs para acceder a sus repositorios de GitHub y a las directrices de contribución.

​SDKs disponibles

TypeScript SDK

Python SDK

PHP SDK

Go SDK

Ruby SDK

Java SDK

Kotlin SDK

C# SDK

Rust SDK

CLI

​Inicio Rápido

​Características Clave

​SDKs de Mobile Checkout

Android

iOS

React Native

Flutter

Mobile Integration Guide

​Interfaz de línea de comandos

CLI

​Migración desde el SDK de Node.js

​Adaptadores de frameworks

​Frameworks recomendados

Next.js

Better Auth

Supabase

Convex

SvelteKit

Nuxt

Remix

Express

Fastify

Hono

Astro

TanStack

​Obtener ayuda

​Contribuir

SDKs disponibles

Inicio Rápido

Características Clave

SDKs de Mobile Checkout

Interfaz de línea de comandos

Migración desde el SDK de Node.js

Adaptadores de frameworks

Frameworks recomendados

Obtener ayuda

Contribuir