Inngest

Introduktion

Kör Inngest-funktioner och bakgrundsjobb när betalningshändelser inträffar. Dodo Payments skickar varje händelse till Inngest, där dina funktioner kan skicka aviseringar, uppdatera databaser och köra arbetsflöden i flera steg med Inngests funktioner för omförsök och felhantering.

Du behöver en Inngest webhook-URL. Du skapar den i Inngest-dashboarden under Manage → Webhooks.

Komma igång

Open the Webhook Section

I Dodo Payments-instrumentpanelen går du till Developer → Webhooks och klickar på Add endpoint.

Add endpoint dialog with Inngest selected in the Integration dropdown

Select Inngest

I Integration väljer du Inngest. Under Subscribed events väljer du de händelser som ska utlösa dina funktioner.

Create an Inngest Webhook

Öppna fliken Manage i Inngest-dashboarden och välj Webhooks. Skapa en webhook och kopiera dess URL. Inngest kör webhookens transform-funktion vid varje begäran, så kontrollera att den behåller fälten name och data som dina funktioner förväntar sig.

Paste Webhook URL

Klistra in Inngest webhook-URL:en i Endpoint URL.

Configure Transformation

I Transformation code redigerar du koden för att formatera händelser för dina Inngest-funktioner. Se exemplen nedan.

Test & Create

Under Test this code väljer du en händelsetyp och klickar på Simulate för att köra transformeringen mot en exempelpayload. Klicka sedan på Create endpoint för att aktivera integrationen.

Done

Dodo Payments-händelser utlöser nu dina Inngest-funktioner.

Exempel på transformationskod

Varje exempel skriver om webhook.payload till en Inngest-händelse. name är den händelse som din funktion utlöses av, data innehåller händelsedetaljerna, user innehåller kunden och ts är händelsetiden i millisekunder, vilket Inngests händelseformat kräver.

Grundläggande payload för händelser

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;
}

Hanterare för prenumerationshändelser

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;
}

Hanterare för tvistrelaterade händelser

Den här hanteraren vidarebefordrar varje händelse av typen dispute.* och markerar dispute.opened som brådskande. Payloads för tvister innehåller inga kunduppgifter, så den skickar inget user-objekt.

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;
}

Vanliga användningsområden för Inngest

Payment Processing

Skicka bekräftelsemeddelanden
Uppdatera kundposter
Hantera återbetalningar
Generera fakturor
Uppdatera lagerstatus

Subscription Management

Välkomna nya prenumeranter
Hantera uppsägningar
Skicka påminnelser om förnyelse
Uppdatera faktureringscykler
Hantera misslyckade betalningar

Analytics & Reporting

Uppdatera intäktsmått
Spåra kundbeteende
Generera rapporter
Synkronisera data med analysplattformar
Beräkna kundbortfallsfrekvenser

Tips

Använd beskrivande händelsenamn. Inngest rekommenderar att du prefixar dem med källan, till exempel dodo/payment.succeeded.
Lägg kunduppgifter i user, som Inngest krypterar i vila.
Ange ts från webhookens timestamp, i millisekunder, så att händelserna behåller sin ursprungliga ordning och tid.
Använd samma datastruktur för alla händelser.
Använd Inngests funktioner för omförsök och felhantering.

Felsökning

Functions not triggering

Kontrollera att endpoint-URL:en matchar din Inngest webhook-URL och att webhooken är aktiv.
Kontrollera att din Inngest-funktion är distribuerad och aktiv.
Kontrollera att händelsenamnen matchar dina funktionsutlösare.
Granska loggarna för Inngest-funktionen efter fel.

Data not received correctly

Kontrollera att payload-strukturen matchar Inngest-händelseformatet.
Kontrollera att händelsenamnen är korrekt formaterade.
Kontrollera att Inngest webhookens transform-funktion behåller fälten som Dodo Payments-transformeringen anger.
Kontrollera att alla obligatoriska fält ingår.
Testa med Inngests verktyg för webhook-testning.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduktion

Komma igång

Exempel på transformationskod

Grundläggande payload för händelser

Hanterare för prenumerationshändelser

Hanterare för tvistrelaterade händelser

Vanliga användningsområden för Inngest

Tips

Felsökning

​Introduktion

​Komma igång

​Exempel på transformationskod

​Grundläggande payload för händelser

​Hanterare för prenumerationshändelser

​Hanterare för tvistrelaterade händelser

​Vanliga användningsområden för Inngest

​Tips

​Felsökning

Introduktion

Komma igång

Exempel på transformationskod

Grundläggande payload för händelser

Hanterare för prenumerationshändelser

Hanterare för tvistrelaterade händelser

Vanliga användningsområden för Inngest

Tips

Felsökning