Skip to main content

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:
Nunca confirmes tu archivo .env ni tus secretos en el control de versiones.

Ejemplos de controladores de rutas

Todos los ejemplos asumen que utilizas el servidor nativo de Bun con Bun.serve().
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.

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.
Si falta productId, el controlador devuelve una respuesta 400. Los parámetros de consulta no válidos también producen una respuesta 400.

Formato de respuesta

El checkout estático devuelve una respuesta JSON con la URL de checkout:

Formato de respuesta

El checkout dinámico devuelve una respuesta JSON con la URL de checkout:
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.
Devuelve 400 si falta customer_id.

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.

Controladores de eventos de webhook compatibles


Prompt para LLM

Última modificación el 6 de agosto de 2026