Zapier

Introduction

Connectez Dodo Payments à des milliers d’applications via Zapier. Chaque événement Dodo Payments peut démarrer un Zap qui envoie un e-mail, ajoute une ligne à une feuille de calcul, crée une tâche ou met à jour un enregistrement CRM.

Le connecteur Zapier envoie chaque événement à l’URL webhook d’un Zap qui démarre avec Webhooks by Zapier. Webhooks by Zapier n’est pas disponible avec le forfait gratuit de Zapier ; vous devez donc disposer d’un forfait Zapier payant. Vous devez également avoir accès à Developer → Webhooks dans le tableau de bord Dodo Payments.

Prise en main

Open the Webhook Section

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

Boîte de dialogue d’ajout d’un endpoint avec Zapier sélectionné dans la liste déroulante Integration et les étapes How to connect Zapier

Select Zapier

Dans Integration, sélectionnez Zapier. Le tableau de bord charge le code de transformation Zapier et affiche les étapes de configuration dans le panneau How to connect Zapier.

Create Zap in Zapier

Dans Zapier, créez un Zap. Pour le déclencheur, sélectionnez Webhooks by Zapier, choisissez l’événement Catch Hook, puis cliquez sur Continue. Dans l’onglet Test du déclencheur, copiez l’URL webhook.

Paste Webhook URL

Collez l’URL webhook Zapier dans Endpoint URL. Le connecteur Zapier ne comporte pas de champ de clé API.

Select Events

Subscribed events répertorie les événements pris en charge par le connecteur Zapier. Conservez uniquement les événements gérés par votre transformation. Zapier accepte n’importe quel JSON ; ainsi, un événement laissé inchangé par la transformation démarre tout de même votre Zap avec la charge utile Dodo Payments d’origine.

Configure Transformation

Sous Transformation code, modifiez le handler afin d’envoyer les champs utilisés par votre Zap. Commencez par les exemples.

Test & Create

Sous Test this code, sélectionnez un type d’événement et cliquez sur Simulate pour prévisualiser la charge utile. Cliquez ensuite sur Create endpoint.

Done

Les événements abonnés sont désormais transmis à votre Zap. Pour charger des champs d’exemple dans Zapier, ouvrez l’onglet Testing de l’endpoint, sélectionnez un type d’événement, puis cliquez sur Send example. Dans Zapier, cliquez sur Test trigger, mappez les champs dans vos étapes d’action, puis publiez le Zap.

Exemples de code de transformation

Chaque handler remplace webhook.payload par un objet plat et conserve webhook.url, votre URL webhook Zapier. Les montants Dodo Payments sont exprimés dans la plus petite unité monétaire ; les exemples les divisent donc par 100 et envoient le résultat sous forme de chaîne, comme "25.00". Pour les devises sans décimales, comme JPY et KRW, utilisez le montant tel quel.

Charge utile webhook de base

Envoyez les détails d’un paiement réussi :

basic_webhook.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.payload = {
      event_type: webhook.eventType,
      payment_id: p.payment_id,
      amount: (p.total_amount / 100).toFixed(2),
      currency: p.currency,
      customer_email: p.customer.email,
      customer_name: p.customer.name,
      payment_method: p.payment_method || "unknown",
      timestamp: webhook.payload.timestamp
    };
  }
  return webhook;
}

Handler d’événement d’abonnement

Envoyez un événement subscription_started ou subscription_cancelled lorsqu’un abonnement devient actif ou est annulé :

subscription_webhook.js

function handler(webhook) {
  const s = webhook.payload.data;
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        event_type: "subscription_started",
        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),
        currency: s.currency,
        frequency: s.payment_frequency_interval,
        next_billing: s.next_billing_date,
        timestamp: webhook.payload.timestamp
      };
      break;
    case "subscription.cancelled":
      webhook.payload = {
        event_type: "subscription_cancelled",
        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,
        timestamp: webhook.payload.timestamp
      };
      break;
  }
  return webhook;
}

Handler d’alerte de litige

Envoyez chaque événement de litige, avec urgent défini sur true lorsqu’un litige est ouvert :

dispute_webhook.js

function handler(webhook) {
  if (webhook.eventType.startsWith("dispute.")) {
    const d = webhook.payload.data;
    webhook.payload = {
      event_type: webhook.eventType,
      dispute_id: d.dispute_id,
      payment_id: d.payment_id,
      amount: (d.amount / 100).toFixed(2),
      currency: d.currency,
      status: d.dispute_status,
      stage: d.dispute_stage,
      remarks: d.remarks || "",
      urgent: webhook.eventType === "dispute.opened",
      timestamp: webhook.payload.timestamp
    };
  }
  return webhook;
}

Cas d’utilisation Zapier courants

Email Notifications

Envoyer des e-mails Gmail ou Outlook pour confirmer les paiements
Ajouter des clients à des séquences d’e-mails dans Mailchimp ou ConvertKit
Envoyer des notifications Slack ou Discord
Ajouter des lignes à Google Sheets

CRM Updates

Ajouter des contacts à HubSpot ou Salesforce
Créer des opportunités dans Pipedrive ou Close
Mettre à jour les fiches clients dans Airtable
Consigner des activités dans Monday.com

Task Management

Créer des tâches dans Asana ou Trello
Ajouter des éléments à faire dans Notion
Créer des événements de calendrier
Envoyer des SMS via Twilio

Conseils

Gardez la charge utile à plat afin que chaque champ soit facile à trouver lorsque vous le mappez dans Zapier.
Utilisez les mêmes noms de champs pour tous les événements afin qu’un seul Zap puisse gérer plusieurs types d’événements.
Incluez timestamp afin que votre Zap puisse enregistrer le moment où chaque événement s’est produit.
Après avoir modifié la transformation, envoyez un nouvel exemple et testez à nouveau le déclencheur dans Zapier afin qu’il charge les nouveaux champs.
Pour n’exécuter les étapes suivantes que pour certains événements, ajoutez une étape Filter by Zapier qui vérifie event_type.
Pour ignorer un événement dans le code, définissez webhook.cancel = true avant de retourner le webhook. Les journaux enregistrent une livraison ignorée comme réussie.

Résolution des problèmes

Zap Not Triggering

Vérifiez que Endpoint URL correspond à l’URL webhook affichée dans l’onglet Test du déclencheur. L’URL change lorsque le Zap est transféré à un autre utilisateur Zapier.
Vérifiez que le Zap est publié et activé. Zapier renvoie 404 pour un Zap désactivé ou supprimé, mais l’URL peut continuer à renvoyer 200 pendant plusieurs heures après la modification.
Ouvrez l’onglet Logs dans Developer → Webhooks pour voir la réponse de Zapier à chaque livraison.
Vérifiez que l’événement est sélectionné dans Subscribed events. Pour modifier la sélection, ouvrez l’endpoint et cliquez sur Edit.

Data Not Mapping Correctly

Vérifiez que les noms de champs de vos étapes d’action correspondent aux clés envoyées par votre transformation.
Vérifiez que chaque valeur possède le type attendu par votre action. Les exemples envoient les montants sous forme de chaînes.
Vérifiez que le handler retourne webhook et que webhook.payload est un objet JSON. Si la charge utile est un tableau, Zapier exécute le Zap une fois pour chaque élément.
Utilisez Test trigger dans Zapier pour voir les champs du dernier événement.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduction

Prise en main

Exemples de code de transformation

Charge utile webhook de base

Handler d’événement d’abonnement

Handler d’alerte de litige

Cas d’utilisation Zapier courants

Conseils

Résolution des problèmes

​Introduction

​Prise en main

​Exemples de code de transformation

​Charge utile webhook de base

​Handler d’événement d’abonnement

​Handler d’alerte de litige

​Cas d’utilisation Zapier courants

​Conseils

​Résolution des problèmes

Introduction

Prise en main

Exemples de code de transformation

Charge utile webhook de base

Handler d’événement d’abonnement

Handler d’alerte de litige

Cas d’utilisation Zapier courants

Conseils

Résolution des problèmes