> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Inngest
> Déclenchez des fonctions sans serveur et des tâches en arrière-plan dans Inngest en fonction des événements de Dodo Payments.
## Introduction
Exécutez automatiquement des fonctions sans serveur et des tâches en arrière-plan lorsque des événements de paiement se produisent. Traitez les paiements, envoyez des notifications, mettez à jour des bases de données et exécutez des workflows complexes avec la plateforme d'exécution de fonctions fiable d'Inngest.
Cette intégration nécessite l'URL du webhook Inngest provenant de la configuration de votre fonction.
## Prise en main
Dans votre tableau de bord Dodo Payments, allez à Webhooks → + Ajouter un point de terminaison et développez le menu déroulant des intégrations.
Choisissez la carte d’intégration Inngest.
Dans Inngest, créez une nouvelle fonction et copiez l’URL du webhook depuis la configuration de la fonction.
Collez l’URL du webhook Inngest dans la configuration du point de terminaison.
Modifiez le code de transformation pour formater les événements pour votre fonction Inngest.
Testez avec des exemples de charges utiles et cliquez sur Créer pour activer l’intégration.
🎉 Les événements de paiement déclencheront désormais automatiquement vos fonctions Inngest.
## Exemples de code de transformation
### Charge utile d'événement de base
```javascript basic_event.js icon="js" expandable theme={null}
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: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
};
}
return webhook;
}
```
### Gestionnaire d'événements d'abonnement
```javascript subscription_event.js icon="js" expandable theme={null}
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: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
};
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: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
};
break;
}
return webhook;
}
```
### Gestionnaire d'événements de litige
```javascript dispute_event.js icon="js" expandable theme={null}
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"
},
user: {
email: d.customer?.email || "unknown"
},
ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
};
}
return webhook;
}
```
## Cas d'utilisation courants d'Inngest
* Envoyer des e-mails de confirmation
* Mettre à jour les dossiers clients
* Traiter les remboursements
* Générer des factures
* Mettre à jour l’inventaire
* 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
* 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 pour une meilleure organisation des fonctions
* Incluez le contexte utilisateur pour l'exécution des fonctions
* Définissez des horodatages appropriés pour l'ordre des événements
* Structurez les données de manière cohérente à travers les événements
* Utilisez les fonctionnalités de réessai et de gestion des erreurs d'Inngest
## Dépannage
* Vérifiez que l’URL du webhook est correcte et active
* Assurez-vous que la fonction Inngest est déployée et active
* Vérifiez que les noms des événements correspondent aux déclencheurs de la fonction
* Consultez les journaux de la fonction Inngest pour détecter les erreurs
* Vérifiez que la structure de la charge utile correspond aux attentes d’Inngest
* Vérifiez que les noms des événements sont correctement formatés
* Assurez-vous que tous les champs requis sont inclus
* Testez avec l’outil de test de webhook d’Inngest