Descripción general de los adaptadores de frameworks

Dodo Payments proporciona adaptadores oficiales de frameworks que simplifican la integración de pagos. Cada adaptador está diseñado para funcionar a la perfección con las convenciones de tu framework, ofreciendo checkout, Customer Portal y gestión de webhooks desde el primer momento.

Los adaptadores de frameworks te permiten integrar Dodo Payments con menos de 10 líneas de código. Gestionan automáticamente la autenticación, el análisis de solicitudes y el formato de respuestas.

Adaptadores de frameworks disponibles

Elige el adaptador que corresponda a tu framework:

Next.js

Compatibilidad con App Router mediante route handlers para checkout, portal y webhooks

Nuxt

Framework full-stack basado en Vue con integración de server routes

Express

Handlers basados en middleware para el popular framework de Node.js

Fastify

Framework de Node.js de alto rendimiento con arquitectura de plugins

Hono

Framework web ultrarrápido para el edge, Cloudflare Workers y mucho más

Astro

Framework centrado en contenido con compatibilidad con server endpoints

SvelteKit

Framework full-stack de Svelte con integración de server hooks

Remix

Framework full-stack de React con handlers de loader y action

TanStack Start

Framework full-stack de React con seguridad de tipos y server functions

Better Auth

Plugin de framework de autenticación para una autenticación y pagos fluidos

Convex

Componente Backend-as-a-Service para la sincronización de pagos en tiempo real

Bun

Handlers nativos de Bun.serve() para checkout, portal y webhooks

Funciones principales

Todos los adaptadores de frameworks ofrecen estas capacidades integradas:

Función	Descripción
Handler de checkout	Compatibilidad con flujos de checkout estáticos, dinámicos y basados en sesiones
Customer Portal	Handler prediseñado para la gestión de suscripciones y facturación
Handler de webhook	Verificación segura de firmas con event handlers tipados
Configuración del entorno	Configuración sencilla mediante variables de entorno
Seguridad de tipos	Compatibilidad completa con TypeScript y payloads tipados

Inicio rápido

Empieza a usar cualquier adaptador de framework en tres pasos:

Install the Adaptor

Usa tu gestor de paquetes para instalar el adaptador específico del framework:

npm install @dodopayments/nextjs

npm install @dodopayments/nuxt

npm install @dodopayments/express

npm install @dodopayments/hono

npm install @dodopayments/astro

npm install @dodopayments/sveltekit

Configure Environment Variables

Añade tus credenciales de Dodo Payments a tu entorno:

DODO_PAYMENTS_API_KEY=your-api-key
DODO_PAYMENTS_WEBHOOK_KEY=your-webhook-secret
DODO_PAYMENTS_RETURN_URL=https://yourdomain.com/checkout/success
DODO_PAYMENTS_ENVIRONMENT="test_mode" # or "live_mode"

Nunca confirmes tu archivo .env ni tus secretos en el control de versiones.

Create Route Handlers

Configura tus rutas de checkout, Customer Portal y webhooks:

Next.js
Express
Hono

// app/checkout/route.ts
import { Checkout } from "@dodopayments/nextjs";

export const GET = Checkout({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
  environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
});

import { checkoutHandler } from '@dodopayments/express';

app.get('/api/checkout', checkoutHandler({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
  environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
}));

import { Checkout } from "@dodopayments/hono";

app.get('/checkout', Checkout({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
  environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
}));

¡Ya puedes procesar pagos! Visita las páginas individuales de los adaptadores para consultar guías detalladas y todas las opciones disponibles.

Tipos de flujo de checkout

Todos los adaptadores admiten tres tipos de flujo de checkout:

Static Checkout (GET)

Usa el checkout estático para enlaces de pago sencillos y fáciles de compartir. Pasa el ID del producto como parámetro de consulta:

/api/checkout?productId=pdt_xxx&quantity=1

Admite el autocompletado y la personalización opcionales del cliente mediante parámetros de consulta.

Dynamic Checkout (POST)

Usa el checkout dinámico para crear pagos mediante programación con detalles personalizados:

{
  "product_id": "pdt_xxx",
  "customer": {
    "email": "customer@example.com",
    "name": "John Doe"
  },
  "quantity": 1
}

Admite pagos únicos y suscripciones.

Checkout Sessions (POST)

Usa sesiones de checkout para disfrutar de la experiencia de checkout más flexible, con compatibilidad con carritos:

{
  "product_cart": [
    { "product_id": "pdt_xxx", "quantity": 1 },
    { "product_id": "pdt_yyy", "quantity": 2 }
  ],
  "customer": {
    "email": "customer@example.com"
  }
}

Obtén más información en la guía de Checkout Sessions.

Gestión de eventos de webhook

Todos los adaptadores ofrecen gestión de webhooks con seguridad de tipos y callbacks de eventos granulares:

Webhooks({
  webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_KEY,
  onPayload: async (payload) => {
    // Handle any webhook event
  },
  onPaymentSucceeded: async (payload) => {
    // Handle successful payments
  },
  onSubscriptionActive: async (payload) => {
    // Handle new subscriptions
  },
  // ... 20+ event types supported
});

Todos los handlers de webhook verifican automáticamente las firmas y validan los payloads mediante esquemas de Zod. Las solicitudes no válidas se rechazan con los códigos de error correspondientes.

Cómo elegir el adaptador adecuado

Framework	Ideal para	Runtime
Next.js	Aplicaciones React full-stack con App Router	Node.js, Edge
Nuxt	Aplicaciones Vue.js full-stack	Node.js
Express	API REST y aplicaciones Node.js tradicionales	Node.js
Fastify	API de alto rendimiento	Node.js
Hono	Implementaciones en Edge, Cloudflare Workers	Edge, Node.js
Astro	Sitios de contenido con server endpoints	Node.js, Edge
SvelteKit	Aplicaciones Svelte full-stack	Node.js
Remix	React full-stack con routing anidado	Node.js
TanStack Start	React full-stack con seguridad de tipos	Node.js
Better Auth	Aplicaciones que ya utilizan Better Auth	Varios
Convex	Aplicaciones que utilizan Convex para el backend	Convex Runtime
Bun	Aplicaciones de servidor nativas de Bun	Bun

Obtener ayuda

¿Necesitas ayuda con los adaptadores de frameworks?

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 adaptador correspondiente
Documentación: Visita nuestra referencia de API

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Descripción general de los adaptadores de frameworks

Adaptadores de frameworks disponibles

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

Bun

Funciones principales

Inicio rápido

Tipos de flujo de checkout

Gestión de eventos de webhook

Cómo elegir el adaptador adecuado

Obtener ayuda

​Adaptadores de frameworks disponibles

Next.js

Nuxt

Express

Fastify

Hono

Astro

SvelteKit

Remix

TanStack Start

Better Auth

Convex

Bun

​Funciones principales

​Inicio rápido

​Tipos de flujo de checkout

​Gestión de eventos de webhook

​Cómo elegir el adaptador adecuado

​Obtener ayuda

Adaptadores de frameworks disponibles

Funciones principales

Inicio rápido

Tipos de flujo de checkout

Gestión de eventos de webhook

Cómo elegir el adaptador adecuado

Obtener ayuda