Inngest

Introducción

Ejecuta funciones de Inngest y trabajos en segundo plano cuando se produzcan eventos de pago. Dodo Payments envía cada evento a Inngest, donde tus funciones pueden enviar notificaciones, actualizar bases de datos y ejecutar flujos de trabajo de varios pasos con los reintentos y la gestión de errores de Inngest.

Necesitas una URL de webhook de Inngest. Puedes crearla en el dashboard de Inngest, en Manage → Webhooks.

Comenzando

Open the Webhook Section

En el dashboard de Dodo Payments, ve a Developer → Webhooks y haz clic en Add endpoint.

Add endpoint dialog with Inngest selected in the Integration dropdown

Select Inngest

En Integration, selecciona Inngest. En Subscribed events, selecciona los eventos que deben activar tus funciones.

Create an Inngest Webhook

En el dashboard de Inngest, abre la pestaña Manage y selecciona Webhooks. Crea un webhook y copia su URL. Inngest ejecuta la función de transformación del webhook en cada solicitud, así que comprueba que conserve los campos name y data que esperan tus funciones.

Paste Webhook URL

Pega la URL del webhook de Inngest en Endpoint URL.

Configure Transformation

En Transformation code, edita el código para dar formato a los eventos para tus funciones de Inngest. Consulta los ejemplos siguientes.

Test & Create

En Test this code, selecciona un tipo de evento y haz clic en Simulate para ejecutar la transformación con un payload de ejemplo. Después, haz clic en Create endpoint para activar la integración.

Done

Los eventos de Dodo Payments ahora activan tus funciones de Inngest.

Ejemplos de Código de Transformación

Cada ejemplo transforma webhook.payload en un evento de Inngest. name es el evento que activa tu función, data contiene los detalles del evento, user contiene el cliente y ts es la hora del evento en milisegundos, que requiere el formato de eventos de Inngest.

Payload de evento básico

basic_event.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.payload = {
      name: "payment.succeeded",
      data: {
        payment_id: p.payment_id,
        amount: (p.total_amount / 100).toFixed(2),
        currency: p.currency || "USD",
        customer_email: p.customer.email,
        customer_name: p.customer.name,
        payment_method: p.payment_method || "unknown"
      },
      user: {
        email: p.customer.email
      },
      ts: new Date(webhook.payload.timestamp).getTime()
    };
  }
  return webhook;
}

Controlador de eventos de suscripción

subscription_event.js

function handler(webhook) {
  const s = webhook.payload.data;
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        name: "subscription.started",
        data: {
          subscription_id: s.subscription_id,
          customer_email: s.customer.email,
          customer_name: s.customer.name,
          product_id: s.product_id,
          amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
          frequency: s.payment_frequency_interval,
          next_billing: s.next_billing_date
        },
        user: {
          email: s.customer.email
        },
        ts: new Date(webhook.payload.timestamp).getTime()
      };
      break;
    case "subscription.cancelled":
      webhook.payload = {
        name: "subscription.cancelled",
        data: {
          subscription_id: s.subscription_id,
          customer_email: s.customer.email,
          cancelled_at: s.cancelled_at,
          cancel_at_next_billing: s.cancel_at_next_billing_date
        },
        user: {
          email: s.customer.email
        },
        ts: new Date(webhook.payload.timestamp).getTime()
      };
      break;
  }
  return webhook;
}

Controlador de eventos de disputas

Este controlador reenvía todos los eventos dispute.* y marca dispute.opened como urgentes. Los payloads de disputas no incluyen detalles del cliente, por lo que no envía ningún objeto user.

dispute_event.js

function handler(webhook) {
  if (webhook.eventType.startsWith("dispute.")) {
    const d = webhook.payload.data;
    webhook.payload = {
      name: webhook.eventType,
      data: {
        dispute_id: d.dispute_id,
        payment_id: d.payment_id,
        amount: (d.amount / 100).toFixed(2),
        status: d.dispute_status,
        stage: d.dispute_stage,
        remarks: d.remarks || "",
        urgent: webhook.eventType === "dispute.opened"
      },
      ts: new Date(webhook.payload.timestamp).getTime()
    };
  }
  return webhook;
}

Casos de uso comunes de Inngest

Payment Processing

Enviar correos electrónicos de confirmación
Actualizar registros de clientes
Procesar reembolsos
Generar facturas
Actualizar el inventario

Subscription Management

Dar la bienvenida a nuevos suscriptores
Procesar cancelaciones
Enviar recordatorios de renovación
Actualizar ciclos de facturación
Gestionar pagos fallidos

Analytics & Reporting

Actualizar métricas de ingresos
Hacer seguimiento del comportamiento de los clientes
Generar informes
Sincronizar datos con plataformas de analítica
Calcular las tasas de abandono

Consejos

Usa nombres de eventos descriptivos. Inngest recomienda anteponerles el origen, como dodo/payment.succeeded.
Coloca los detalles del cliente en user, que Inngest cifra en reposo.
Establece ts a partir de timestamp del webhook, en milisegundos, para que los eventos conserven su orden y hora originales.
Usa la misma estructura de datos en todos los eventos.
Usa las funciones de reintento y gestión de errores de Inngest.

Solución de problemas

Functions not triggering

Comprueba que la URL del endpoint coincida con la URL del webhook de Inngest y que el webhook esté activo.
Comprueba que tu función de Inngest esté implementada y activa.
Comprueba que los nombres de los eventos coincidan con los activadores de tu función.
Revisa los logs de la función de Inngest para detectar errores.

Data not received correctly

Comprueba que la estructura del payload coincida con el formato de eventos de Inngest.
Comprueba que los nombres de los eventos tengan el formato correcto.
Comprueba que la función de transformación del webhook de Inngest conserve los campos que establece la transformación de Dodo Payments.
Comprueba que se incluyan todos los campos obligatorios.
Realiza pruebas con la herramienta de pruebas de webhooks de Inngest.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introducción

Comenzando

Ejemplos de Código de Transformación

Payload de evento básico

Controlador de eventos de suscripción

Controlador de eventos de disputas

Casos de uso comunes de Inngest

Consejos

Solución de problemas

​Introducción

​Comenzando

​Ejemplos de Código de Transformación

​Payload de evento básico

​Controlador de eventos de suscripción

​Controlador de eventos de disputas

​Casos de uso comunes de Inngest

​Consejos

​Solución de problemas

Introducción

Comenzando

Ejemplos de Código de Transformación

Payload de evento básico

Controlador de eventos de suscripción

Controlador de eventos de disputas

Casos de uso comunes de Inngest

Consejos

Solución de problemas