Checkout Handler
Integra el checkout de Dodo Payments en tu servidor Bun.
Customer Portal
Permite que los clientes gestionen sus suscripciones y datos.
Webhooks
Recibe y procesa eventos de webhook de Dodo Payments.
Instalación
1
Install the package
Ejecuta el siguiente comando en la raíz de tu proyecto:
2
Set up environment variables
Crea un archivo
.env en la raíz de tu proyecto:Ejemplos de controladores de rutas
Todos los ejemplos asumen que utilizas el servidor nativo de Bun con
Bun.serve().- Checkout Handler
- Customer Portal Handler
- Webhook Handler
Utiliza este controlador para integrar el checkout de Dodo Payments en tu servidor Bun. Admite flujos de pago estáticos (GET), dinámicos (POST) y de sesión (POST).
Controlador de rutas de checkout
Dodo Payments admite tres tipos de flujos de pago para integrar pagos en tu sitio web; este adaptador admite todos los tipos de flujos de pago.
- Enlaces de pago estáticos: URLs que se pueden compartir al instante para cobrar pagos rápidamente y sin código.
- Enlaces de pago dinámicos: Genera enlaces de pago mediante programación con datos personalizados usando la API o los SDK.
- Sesiones de checkout: Crea experiencias de checkout seguras y personalizables con carritos de productos preconfigurados y datos del cliente.
Static Checkout (GET)
Static Checkout (GET)
Parámetros de consulta compatibles
string
requerido
Identificador del producto (p. ej.,
?productId=pdt_xxx).integer
Cantidad del producto.
string
Nombre completo del cliente.
string
Nombre del cliente.
string
Apellido del cliente.
string
Dirección de correo electrónico del cliente.
string
País del cliente.
string
Línea de dirección del cliente.
string
Ciudad del cliente.
string
Estado o provincia del cliente.
string
Código postal del cliente.
boolean
Desactivar el campo de nombre completo.
boolean
Desactivar el campo de nombre.
boolean
Desactivar el campo de apellido.
boolean
Desactivar el campo de correo electrónico.
boolean
Desactivar el campo de país.
boolean
Desactivar el campo de línea de dirección.
boolean
Desactivar el campo de ciudad.
boolean
Desactivar el campo de estado.
boolean
Desactivar el campo de código postal.
string
Especificar la moneda del pago (p. ej.,
USD).boolean
Mostrar el selector de moneda.
boolean
Fija el importe cobrado en unidades monetarias principales (p. ej.,
12.5 para 12,50 $). Solo para productos Pay What You Want; se ignora si es inferior al precio mínimo del producto.boolean
Mostrar los campos de descuento.
string
Cualquier parámetro de consulta que comience por
metadata_ se pasará como metadata.Formato de respuesta
El checkout estático devuelve una respuesta JSON con la URL de checkout:Dynamic Checkout (POST)
Dynamic Checkout (POST)
- Envía los parámetros como un cuerpo JSON en una solicitud POST.
- Admite pagos únicos y recurrentes.
- Para consultar la lista completa de campos compatibles del cuerpo POST, consulta:
Formato de respuesta
El checkout dinámico devuelve una respuesta JSON con la URL de checkout:Checkout Sessions (POST)
Checkout Sessions (POST)
Las sesiones de checkout proporcionan una experiencia de checkout alojada más segura que gestiona el flujo de pago completo, tanto para compras únicas como para suscripciones, con control total de personalización.Consulta la guía de integración de Checkout Sessions para obtener más información y consultar la lista completa de campos compatibles.
Formato de respuesta
Las sesiones de checkout devuelven una respuesta JSON con la URL de checkout:Controlador de rutas de Customer Portal
El controlador de rutas de Customer Portal te permite integrar sin problemas el Customer Portal de Dodo Payments en tu aplicación de servidor Bun.Query Parameters
string
requerido
ID del cliente para la sesión del portal (por ejemplo,
?customer_id=cus_123).boolean
Si se establece en
true, envía al cliente un correo electrónico con el enlace al portal.Controlador de rutas de Webhook
- Método: Solo se admiten solicitudes POST. Los demás métodos devuelven 405.
- Verificación de firma: Verifica la firma del webhook mediante
webhookKey. Devuelve 401 si la verificación falla. - Validación del payload: Se valida con Zod. Devuelve 400 para payloads no válidos.
- Gestión de errores:
- 401: Firma no válida
- 400: Payload no válido
- 500: Error interno durante la verificación
- Enrutamiento de eventos: Llama al controlador de eventos adecuado según el tipo de payload.