Boucles

Introduction

L’intégration Loops convertit les événements de Dodo Payments en événements Loops, afin que les confirmations de paiement, les mises à jour d’abonnement et les notifications d’échec de paiement soient envoyées sous forme d’e-mails Loops. Une transformation associe chaque événement de paiement à un événement Loops, qui déclenche ensuite le workflow correspondant dans Loops.

Vous avez besoin d’une clé API Loops. Dans Loops, accédez à Settings → API et générez une clé.

Prise en main

Open the Webhook Section

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

Add endpoint dialog with Loops selected in the Integration dropdown

Select Loops

Dans la liste Integration, sélectionnez Loops.

Enter API Key

Collez votre clé API Loops dans le champ API key. Dodo Payments l’envoie en tant qu’en-tête Authorization à chaque livraison. L’intégration définit l’URL de destination, la clé est donc la seule valeur que vous devez fournir.

Configure Transformation

Modifiez le code sous Transformation code afin que chaque événement devienne un événement Loops. Commencez par les exemples ci-dessous. Sous Subscribed events, sélectionnez les événements gérés par votre code.

Test & Create

Sous Test this code, exécutez la transformation avec un exemple de payload, puis cliquez sur Create endpoint.

Done

Les événements de paiement déclenchent désormais des e-mails via Loops.

Exemples de code de transformation

Chaque exemple réécrit un type d’événement dans le corps de l’API Loops Envoyer un événement : un événement eventName, le email du contact et un eventProperties que vos e-mails Loops peuvent utiliser.

E-mail de confirmation de paiement

Cet exemple envoie un événement payment_confirmation lorsqu’un paiement est accepté.

payment_confirmation.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "payment_confirmation",
      email: p.customer.email,
      eventProperties: {
        customer_name: p.customer.name,
        payment_id: p.payment_id,
        amount: (p.total_amount / 100).toFixed(2),
        currency: p.currency || "USD",
        payment_method: p.payment_method || "unknown",
        payment_date: new Date(webhook.payload.timestamp).toLocaleDateString()
      }
    };
  }
  return webhook;
}

E-mail de bienvenue pour un abonnement

Cet exemple envoie un événement subscription_welcome lorsqu’un abonnement devient actif.

subscription_welcome.js

function handler(webhook) {
  if (webhook.eventType === "subscription.active") {
    const s = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "subscription_welcome",
      email: s.customer.email,
      eventProperties: {
        customer_name: s.customer.name,
        subscription_id: s.subscription_id,
        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
      }
    };
  }
  return webhook;
}

Notification d’échec de paiement

Cet exemple envoie un événement payment_failed avec le message d’erreur et un lien de nouvelle tentative. Remplacez yourdomain.com par votre propre domaine.

payment_failure.js

function handler(webhook) {
  if (webhook.eventType === "payment.failed") {
    const p = webhook.payload.data;
    webhook.url = "https://app.loops.so/api/v1/events/send";
    webhook.payload = {
      eventName: "payment_failed",
      email: p.customer.email,
      eventProperties: {
        customer_name: p.customer.name,
        payment_id: p.payment_id,
        amount: (p.total_amount / 100).toFixed(2),
        error_message: p.error_message || "Payment processing failed",
        retry_link: `https://yourdomain.com/retry-payment/${p.payment_id}`
      }
    };
  }
  return webhook;
}

Conseils

Donnez à chaque événement un nom descriptif, comme payment_confirmation, afin que vos e-mails Loops restent organisés.
Incluez les propriétés client utilisées par vos e-mails pour la personnalisation.
Dans Loops, configurez un workflow et un e-mail pour chaque nom d’événement que vous envoyez.
Utilisez les mêmes noms de propriétés pour tous les événements.
Testez l’envoi des e-mails avant la mise en production.

Dépannage

Emails Not Being Sent

Vérifiez que la clé API est correcte et active.
Vérifiez que chaque nom d’événement correspond à l’événement qui déclenche votre workflow Loops.
Vérifiez que les adresses e-mail des destinataires sont valides.
Consultez vos limites et quotas d’envoi Loops.

Transformation Errors

Vérifiez que le payload respecte le format de l’API Loops : un eventName, ainsi qu’un email ou userId.
Vérifiez que tous les champs obligatoires sont présents.
Vérifiez que les noms d’événements sont correctement formatés.
Attribuez à chaque propriété d’événement une valeur de type chaîne, nombre, booléen ou date.
Vérifiez les permissions de la clé API.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduction

Prise en main

Exemples de code de transformation

E-mail de confirmation de paiement

E-mail de bienvenue pour un abonnement

Notification d’échec de paiement

Conseils

Dépannage

​Introduction

​Prise en main

​Exemples de code de transformation

​E-mail de confirmation de paiement

​E-mail de bienvenue pour un abonnement

​Notification d’échec de paiement

​Conseils

​Dépannage

Introduction

Prise en main

Exemples de code de transformation

E-mail de confirmation de paiement

E-mail de bienvenue pour un abonnement

Notification d’échec de paiement

Conseils

Dépannage