Inngest

Einführung

Führe Inngest-Funktionen und Hintergrundaufgaben aus, wenn Zahlungsereignisse auftreten. Dodo Payments sendet jedes Ereignis an Inngest. Dort können deine Funktionen Benachrichtigungen senden, Datenbanken aktualisieren und mehrstufige Workflows mit den Wiederholungs- und Fehlerbehandlungsfunktionen von Inngest ausführen.

Du benötigst eine Inngest-Webhook-URL. Du erstellst sie im Inngest-Dashboard unter Manage → Webhooks.

Erste Schritte

Open the Webhook Section

Gehe im Dodo Payments-Dashboard zu Developer → Webhooks und klicke auf Add endpoint.

Dialog zum Hinzufügen eines Endpunkts mit Inngest im Dropdown-Menü „Integration“ ausgewählt

Select Inngest

Wähle unter Integration die Option Inngest aus. Wähle unter Subscribed events die Ereignisse aus, die deine Funktionen auslösen sollen.

Create an Inngest Webhook

Öffne im Inngest-Dashboard den Tab Manage und wähle Webhooks aus. Erstelle einen Webhook und kopiere seine URL. Inngest führt bei jeder Anfrage die Transformationsfunktion des Webhooks aus. Überprüfe daher, dass sie die Felder name und data beibehält, die deine Funktionen erwarten.

Paste Webhook URL

Füge die Inngest-Webhook-URL unter Endpoint URL ein.

Configure Transformation

Bearbeite unter Transformation code den Code, um Ereignisse für deine Inngest-Funktionen zu formatieren. Siehe die Beispiele weiter unten.

Test & Create

Wähle unter Test this code einen Ereignistyp aus und klicke auf Simulate, um die Transformation mit einer Beispiel-Payload auszuführen. Klicke anschließend auf Create endpoint, um die Integration zu aktivieren.

Done

Dodo-Payments-Ereignisse lösen jetzt deine Inngest-Funktionen aus.

Transformationscode-Beispiele

Jedes Beispiel wandelt webhook.payload in ein Inngest-Ereignis um. name ist das Ereignis, bei dem deine Funktion ausgelöst wird, data enthält die Ereignisdetails, user enthält den Kunden und ts ist der Ereigniszeitpunkt in Millisekunden, den das Ereignisformat von Inngest erfordert.

Einfacher Ereignis-Payload

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

Handler für Abonnementereignisse

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

Handler für Streitfallereignisse

Dieser Handler leitet jedes dispute.*-Ereignis weiter und markiert dispute.opened als dringend. Streitfall-Payloads enthalten keine Kundendetails. Daher wird kein user-Objekt gesendet.

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

Häufige Anwendungsfälle für Inngest

Payment Processing

Bestätigungs-E-Mails senden
Kundendatensätze aktualisieren
Rückerstattungen verarbeiten
Rechnungen erstellen
Bestand aktualisieren

Subscription Management

Neue Abonnenten begrüßen
Kündigungen verarbeiten
Erinnerungen an Verlängerungen senden
Abrechnungszyklen aktualisieren
Fehlgeschlagene Zahlungen verarbeiten

Analytics & Reporting

Umsatzkennzahlen aktualisieren
Kundenverhalten verfolgen
Berichte erstellen
Daten mit Analyseplattformen synchronisieren
Abwanderungsraten berechnen

Tipps

Verwende aussagekräftige Ereignisnamen. Inngest empfiehlt, ihnen die Quelle voranzustellen, zum Beispiel dodo/payment.succeeded.
Speichere Kundendetails in user, das Inngest im Ruhezustand verschlüsselt.
Setze ts aus dem timestamp des Webhooks in Millisekunden, damit Ereignisse ihre ursprüngliche Reihenfolge und ihren ursprünglichen Zeitpunkt beibehalten.
Verwende für alle Ereignisse dieselbe Datenstruktur.
Nutze die Wiederholungs- und Fehlerbehandlungsfunktionen von Inngest.

Fehlerbehebung

Functions not triggering

Überprüfe, dass die Endpoint-URL mit deiner Inngest-Webhook-URL übereinstimmt und der Webhook aktiv ist.
Überprüfe, dass deine Inngest-Funktion bereitgestellt und aktiv ist.
Überprüfe, dass die Ereignisnamen mit den Auslösern deiner Funktion übereinstimmen.
Prüfe die Logs der Inngest-Funktion auf Fehler.

Data not received correctly

Überprüfe, dass die Payload-Struktur dem Inngest-Ereignisformat entspricht.
Überprüfe, dass die Ereignisnamen korrekt formatiert sind.
Überprüfe, dass die Transformationsfunktion des Inngest-Webhooks die Felder beibehält, die durch die Dodo-Payments-Transformation festgelegt werden.
Überprüfe, dass alle erforderlichen Felder enthalten sind.
Teste mit dem Webhook-Testtool von Inngest.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Einführung

Erste Schritte

Transformationscode-Beispiele

Einfacher Ereignis-Payload

Handler für Abonnementereignisse

Handler für Streitfallereignisse

Häufige Anwendungsfälle für Inngest

Tipps

Fehlerbehebung

​Einführung

​Erste Schritte

​Transformationscode-Beispiele

​Einfacher Ereignis-Payload

​Handler für Abonnementereignisse

​Handler für Streitfallereignisse

​Häufige Anwendungsfälle für Inngest

​Tipps

​Fehlerbehebung

Einführung

Erste Schritte

Transformationscode-Beispiele

Einfacher Ereignis-Payload

Handler für Abonnementereignisse

Handler für Streitfallereignisse

Häufige Anwendungsfälle für Inngest

Tipps

Fehlerbehebung