Saltar al contenido principal
Dodo Payments proporciona adaptadores de framework oficiales que simplifican la integración de pagos. Cada adaptador está diseñado para funcionar sin problemas con las convenciones de tu framework, ofreciendo manejo de checkout, portal de clientes y webhooks desde el primer momento.
Los adaptadores de framework te permiten integrar Dodo Payments en menos de 10 líneas de código. Manejan la autenticación, el análisis de solicitudes y el formato de respuestas automáticamente.

​
Adaptadores de Framework Disponibles

Elige el adaptador que coincida con tu framework:

Next.js

Soporte para App Router con controladores de ruta para checkout, portal y webhooks

Nuxt

Framework full-stack basado en Vue con integración de rutas del servidor

Express

Controladores 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 más

Astro

Framework centrado en contenido con soporte para endpoints del servidor

SvelteKit

Framework Svelte full-stack con integración de hooks del servidor

Remix

Framework React full-stack con controladores de carga y acción

TanStack Start

Framework React full-stack seguro en tipos con funciones del servidor

Better Auth

Plugin de framework de autenticación para una integración fluida de auth + pagos

Convex

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

​
Características Principales

Todos los adaptadores de framework proporcionan estas capacidades integradas:
CaracterísticaDescripción
Manejador de CheckoutSoporte para flujos de checkout estáticos, dinámicos y basados en sesiones
Portal de ClientesManejador preconstruido para gestión de suscripciones y facturación
Manejador de WebhooksVerificación de firma segura con controladores de eventos tipados
Configuración del EntornoConfiguración simple a través de variables de entorno
Seguridad de TiposSoporte completo para TypeScript con cargas útiles tipadas

​
Inicio Rápido

Comienza con cualquier adaptador de framework en tres pasos:
1

Instalar el Adaptador

Usa tu gestor de paquetes para instalar el adaptador específico del framework:
npm install @dodopayments/nextjs
2

Configurar Variables de Entorno

Agrega 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 cometas tu .env archivo o secretos en el control de versiones.
3

Crear Controladores de Ruta

Configura tus rutas de checkout, portal de clientes y webhooks:
// 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,
});
¡Ahora estás listo para procesar pagos! Visita las páginas de adaptadores individuales para guías detalladas y todas las opciones disponibles.

​
Tipos de Flujos de Checkout

Todos los adaptadores soportan tres tipos de flujos de checkout:
Usa el checkout estático para enlaces de pago simples y compartibles. Pasa el ID del producto como un parámetro de consulta:
/api/checkout?productId=pdt_xxx&quantity=1
Soporta prellenado opcional de clientes y personalización a través de parámetros de consulta.
Usa el checkout dinámico para crear pagos programáticamente con detalles personalizados:
{
  "product_id": "pdt_xxx",
  "customer": {
    "email": "customer@example.com",
    "name": "John Doe"
  },
  "quantity": 1
}
Soporta tanto pagos únicos como suscripciones.
Usa sesiones de checkout para la experiencia de checkout más flexible con soporte de carrito:
{
  "product_cart": [
    { "product_id": "pdt_xxx", "quantity": 1 },
    { "product_id": "pdt_yyy", "quantity": 2 }
  ],
  "customer": {
    "email": "customer@example.com"
  }
}
Aprende más en la Guía de Sesiones de Checkout.

​
Manejo de Eventos de Webhook

Todos los adaptadores proporcionan manejo de webhooks seguro en tipos con 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 manejadores de webhooks verifican automáticamente las firmas y validan las cargas útiles utilizando esquemas de Zod. Las solicitudes inválidas son rechazadas con códigos de error apropiados.

​
Elegir el Adaptador Correcto

FrameworkMejor ParaRuntime
Next.jsAplicaciones React full-stack con App RouterNode.js, Edge
NuxtAplicaciones Vue.js full-stackNode.js
ExpressAPIs REST y aplicaciones Node.js tradicionalesNode.js
FastifyAPIs de alto rendimientoNode.js
HonoDespliegues en el edge, Cloudflare WorkersEdge, Node.js
AstroSitios de contenido con endpoints del servidorNode.js, Edge
SvelteKitAplicaciones Svelte full-stackNode.js
RemixReact full-stack con enrutamiento anidadoNode.js
TanStack StartReact full-stack seguro en tiposNode.js
Better AuthAplicaciones que ya utilizan Better AuthVarios
ConvexAplicaciones que utilizan Convex para backendConvex Runtime

​
Obtener Ayuda

¿Necesitas asistencia con los adaptadores de framework?