Inngest

Introduction

Exécutez des fonctions Inngest et des tâches en arrière-plan lorsque des événements de paiement se produisent. Dodo Payments envoie chaque événement à Inngest, où vos fonctions peuvent envoyer des notifications, mettre à jour des bases de données et exécuter des workflows en plusieurs étapes grâce aux mécanismes de nouvelle tentative et de gestion des erreurs d’Inngest.

Vous avez besoin d’une URL de webhook Inngest. Vous la créez dans le dashboard Inngest, sous Manage → Webhooks.

Prise en main

Open the Webhook Section

Dans le tableau de bord Dodo Payments, accédez à Developer → Webhooks et cliquez sur Add endpoint.

Add endpoint dialog with Inngest selected in the Integration dropdown

Select Inngest

Dans Integration, sélectionnez Inngest. Sous Subscribed events, sélectionnez les événements qui doivent déclencher vos fonctions.

Create an Inngest Webhook

Dans le dashboard Inngest, ouvrez l’onglet Manage et sélectionnez Webhooks. Créez un webhook et copiez son URL. Inngest exécute la fonction de transformation du webhook à chaque requête. Vérifiez donc qu’elle conserve les champs name et data attendus par vos fonctions.

Paste Webhook URL

Collez l’URL du webhook Inngest dans Endpoint URL.

Configure Transformation

Dans Transformation code, modifiez le code pour formater les événements destinés à vos fonctions Inngest. Consultez les exemples ci-dessous.

Test & Create

Sous Test this code, sélectionnez un type d’événement et cliquez sur Simulate pour exécuter la transformation sur un exemple de payload. Cliquez ensuite sur Create endpoint pour activer l’intégration.

Done

Les événements Dodo Payments déclenchent désormais vos fonctions Inngest.

Exemples de code de transformation

Chaque exemple réécrit webhook.payload en événement Inngest. name correspond à l’événement qui déclenche votre fonction, data contient les détails de l’événement, user contient les informations client et ts correspond à l’heure de l’événement en millisecondes, requise par le format d’événement Inngest.

Payload d’événement de base

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

Gestionnaire d’événements d’abonnement

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

Gestionnaire d’événements de litige

Ce gestionnaire transmet chaque événement dispute.* et marque dispute.opened comme urgent. Les payloads de litige n’incluent pas les informations client. Aucun objet user n’est donc envoyé.

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

Cas d’usage courants d’Inngest

Payment Processing

Envoyer des e-mails de confirmation
Mettre à jour les fiches client
Traiter les remboursements
Générer des factures
Mettre à jour l’inventaire

Subscription Management

Accueillir les nouveaux abonnés
Traiter les annulations
Envoyer des rappels de renouvellement
Mettre à jour les cycles de facturation
Gérer les paiements échoués

Analytics & Reporting

Mettre à jour les indicateurs de revenus
Suivre le comportement des clients
Générer des rapports
Synchroniser les données avec les plateformes d’analyse
Calculer les taux d’attrition

Conseils

Utilisez des noms d’événements descriptifs. Inngest recommande de les préfixer avec la source, par exemple dodo/payment.succeeded.
Placez les informations client dans user, qu’Inngest chiffre au repos.
Définissez ts à partir de timestamp du webhook, en millisecondes, afin que les événements conservent leur ordre et leur heure d’origine.
Utilisez la même structure de données pour tous les événements.
Utilisez les fonctionnalités de nouvelle tentative et de gestion des erreurs d’Inngest.

Dépannage

Functions not triggering

Vérifiez que l’URL de l’endpoint correspond à votre URL de webhook Inngest et que le webhook est actif.
Vérifiez que votre fonction Inngest est déployée et active.
Vérifiez que les noms des événements correspondent aux déclencheurs de votre fonction.
Consultez les logs de la fonction Inngest pour identifier les erreurs.

Data not received correctly

Vérifiez que la structure du payload correspond au format d’événement Inngest.
Vérifiez que les noms des événements sont correctement formatés.
Vérifiez que la fonction de transformation du webhook Inngest conserve les champs définis par la transformation Dodo Payments.
Vérifiez que tous les champs obligatoires sont inclus.
Effectuez un test avec l’outil de test de webhook d’Inngest.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduction

Prise en main

Exemples de code de transformation

Payload d’événement de base

Gestionnaire d’événements d’abonnement

Gestionnaire d’événements de litige

Cas d’usage courants d’Inngest

Conseils

Dépannage

​Introduction

​Prise en main

​Exemples de code de transformation

​Payload d’événement de base

​Gestionnaire d’événements d’abonnement

​Gestionnaire d’événements de litige

​Cas d’usage courants d’Inngest

​Conseils

​Dépannage

Introduction

Prise en main

Exemples de code de transformation

Payload d’événement de base

Gestionnaire d’événements d’abonnement

Gestionnaire d’événements de litige

Cas d’usage courants d’Inngest

Conseils

Dépannage