Slack

Introduction

L’intégration Slack publie les événements Dodo Payments, tels que les paiements réussis, les changements d’abonnement et les litiges, dans le canal Slack de votre choix. Votre équipe peut suivre les paiements et gérer les litiges depuis Slack, sans consulter le tableau de bord.

Le connecteur Slack transforme chaque événement Dodo Payments en message Slack grâce à une transformation : du code JavaScript qui s’exécute sur l’événement avant sa livraison. Le connecteur inclut du code de transformation : aucune programmation n’est donc nécessaire pour commencer. Vous devez avoir accès à Developer → Webhooks dans le tableau de bord Dodo Payments et disposer de l’autorisation d’ajouter des applications à votre espace de travail Slack.

Commencer

Open the Webhook Section

Dans le tableau de bord Dodo Payments, accédez à Développeur → Webhooks, puis cliquez sur Ajouter un endpoint.

Boîte de dialogue d’ajout d’un endpoint avec la liste déroulante Intégration définie sur Webhook personnalisé

Select Slack Integration

Dans Intégration, sélectionnez Slack. Le tableau de bord charge le code de transformation Slack et affiche les étapes de configuration dans le panneau Comment connecter Slack.

Boîte de dialogue d’ajout d’un endpoint avec Slack sélectionné et les étapes de connexion à Slack

Create a Slack Webhook URL

Dans Slack, créez une application avec un webhook entrant pour le canal qui doit recevoir les notifications :

Ouvrez api.slack.com/apps, cliquez sur Create New App, puis choisissez From scratch.
Nommez l’application, par exemple Dodo Payments Notifications, sélectionnez votre espace de travail, puis cliquez sur Create App.
Dans la barre latérale, ouvrez Incoming Webhooks et activez Activate Incoming Webhooks.
Cliquez sur Add New Webhook to Workspace, choisissez le canal, puis cliquez sur Allow.
Copiez l’Webhook URL, qui commence par https://hooks.slack.com/services/.

Écran des autorisations Slack avec un sélecteur de canal et un bouton Allow

Paste the Webhook URL

Collez l’URL du webhook Slack dans Endpoint URL. Slack n’a pas besoin de clé API.

Select Events

Subscribed events répertorie les événements pris en charge par le connecteur Slack. Si vous modifiez la transformation, ne conservez que les événements qu’elle gère. Slack rejette une requête qui n’est pas un message Slack ; un événement laissé inchangé par la transformation ne peut donc pas être livré.

Customize Transformation Code

Sous Transformation code, modifiez le handler pour choisir les événements qui publient un message et définir l’apparence de chaque message. Conservez le code du connecteur ou partez des exemples.

Éditeur de code de transformation avec le handler Slack pour les événements de paiement

Test and Create

Sous Tester ce code, sélectionnez un type d’événement, puis cliquez sur Simuler. Le Résultat affiche le message que Slack recevrait. Cliquez ensuite sur Créer un endpoint.

Panneau Tester ce code avec payment.succeeded sélectionné, un bouton Simuler et le bouton Créer un endpoint

Integration Complete!

Dodo Payments publie désormais chaque événement sélectionné dans votre canal Slack. Pour publier un message de test, ouvrez l’onglet Testing de l’endpoint, sélectionnez un type d’événement, puis cliquez sur Send example.

Exemples de code de transformation

Chaque gestionnaire remplace webhook.payload par un message Slack et conserve webhook.url, votre URL de webhook entrante. Les montants de Dodo Payments sont exprimés dans la plus petite unité monétaire. Les exemples les divisent donc par 100 et affichent le code devise. Pour les devises sans décimales, comme JPY et KRW, utilisez le montant tel quel.

Notifications de paiement de base

Publiez un message en texte brut lorsqu’un paiement réussit, échoue ou est en cours de traitement :

payment_notifs.js

function handler(webhook) {
  switch (webhook.eventType) {
    case "payment.succeeded":
      webhook.payload = {
        text: `✅ Payment Successful\nAmount: ${(webhook.payload.data.total_amount / 100).toFixed(2)} ${webhook.payload.data.currency}\nCustomer: ${webhook.payload.data.customer.email}\nPayment ID: ${webhook.payload.data.payment_id}`
      };
      break;
      
    case "payment.failed":
      webhook.payload = {
        text: `❌ Payment Failed\nAmount: ${(webhook.payload.data.total_amount / 100).toFixed(2)} ${webhook.payload.data.currency}\nCustomer: ${webhook.payload.data.customer.email}\nReason: ${webhook.payload.data.error_message || 'Unknown'}`
      };
      break;
      
    case "payment.processing":
      webhook.payload = {
        text: `⏳ Payment Processing\nAmount: ${(webhook.payload.data.total_amount / 100).toFixed(2)} ${webhook.payload.data.currency}\nCustomer: ${webhook.payload.data.customer.email}`
      };
      break;
  }

  return webhook;
}

Notifications enrichies d’abonnement

Publiez un message avec un code couleur et des champs de pièce jointe lorsqu’un abonnement devient actif, est annulé ou est renouvelé :

subscription_notifs.js

function handler(webhook) {
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        attachments: [{
          color: "good",
          title: "🎉 Subscription Activated",
          fields: [
            {
              title: "Customer",
              value: webhook.payload.data.customer.email,
              short: true
            },
            {
              title: "Product ID",
              value: webhook.payload.data.product_id,
              short: true
            },
            {
              title: "Amount",
              value: `${(webhook.payload.data.recurring_pre_tax_amount / 100).toFixed(2)} ${webhook.payload.data.currency}/${webhook.payload.data.payment_frequency_interval}`,
              short: true
            },
            {
              title: "Next Billing",
              value: new Date(webhook.payload.data.next_billing_date).toLocaleDateString(),
              short: true
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
      
    case "subscription.cancelled":
      webhook.payload = {
        attachments: [{
          color: "warning",
          title: "⚠️ Subscription Cancelled",
          fields: [
            {
              title: "Customer",
              value: webhook.payload.data.customer.email,
              short: true
            },
            {
              title: "Product ID",
              value: webhook.payload.data.product_id,
              short: true
            },
            {
              title: "Cancellation Date",
              value: new Date(webhook.payload.data.cancelled_at).toLocaleDateString(),
              short: true
            },
            {
              title: "Cancel at Next Billing",
              value: webhook.payload.data.cancel_at_next_billing_date ? "Yes" : "No",
              short: true
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
      
    case "subscription.renewed":
      webhook.payload = {
        attachments: [{
          color: "good",
          title: "🔄 Subscription Renewed",
          fields: [
            {
              title: "Customer",
              value: webhook.payload.data.customer.email,
              short: true
            },
            {
              title: "Product ID",
              value: webhook.payload.data.product_id,
              short: true
            },
            {
              title: "Amount",
              value: `${(webhook.payload.data.recurring_pre_tax_amount / 100).toFixed(2)} ${webhook.payload.data.currency}`,
              short: true
            },
            {
              title: "Next Billing",
              value: new Date(webhook.payload.data.next_billing_date).toLocaleDateString(),
              short: true
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
  }

  return webhook;
}

Notifications de gestion des litiges

Publiez un message rouge lorsqu’un litige est ouvert ou perdu, et un message vert lorsqu’il est gagné :

dispute_notifs.js

function handler(webhook) {
  switch (webhook.eventType) {
    case "dispute.opened":
      webhook.payload = {
        attachments: [{
          color: "danger",
          title: "🚨 New Dispute Opened",
          fields: [
            {
              title: "Payment ID",
              value: webhook.payload.data.payment_id,
              short: true
            },
            {
              title: "Amount",
              value: `${(webhook.payload.data.amount / 100).toFixed(2)} ${webhook.payload.data.currency}`,
              short: true
            },
            {
              title: "Status",
              value: webhook.payload.data.dispute_status,
              short: true
            },
            {
              title: "Stage",
              value: webhook.payload.data.dispute_stage,
              short: true
            },
            {
              title: "Remarks",
              value: webhook.payload.data.remarks || "No remarks",
              short: false
            }
          ],
          footer: "Dodo Payments - Action Required",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
      
    case "dispute.won":
      webhook.payload = {
        attachments: [{
          color: "good",
          title: "✅ Dispute Won",
          fields: [
            {
              title: "Payment ID",
              value: webhook.payload.data.payment_id,
              short: true
            },
            {
              title: "Amount",
              value: `${(webhook.payload.data.amount / 100).toFixed(2)} ${webhook.payload.data.currency}`,
              short: true
            },
            {
              title: "Status",
              value: webhook.payload.data.dispute_status,
              short: true
            },
            {
              title: "Resolution",
              value: "Dispute resolved in your favor",
              short: false
            }
          ],
          footer: "Dodo Payments",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
      
    case "dispute.lost":
      webhook.payload = {
        attachments: [{
          color: "danger",
          title: "❌ Dispute Lost",
          fields: [
            {
              title: "Payment ID",
              value: webhook.payload.data.payment_id,
              short: true
            },
            {
              title: "Amount",
              value: `${(webhook.payload.data.amount / 100).toFixed(2)} ${webhook.payload.data.currency}`,
              short: true
            },
            {
              title: "Status",
              value: webhook.payload.data.dispute_status,
              short: true
            },
            {
              title: "Impact",
              value: "The disputed amount stays deducted from your balance",
              short: false
            }
          ],
          footer: "Dodo Payments - Review Required",
          ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
        }]
      };
      break;
  }

  return webhook;
}

Gestionnaire complet de tous les événements

Publiez un message au même format pour chaque type d’événement. Les événements qui ne disposent pas de leur propre case reçoivent un message générique indiquant le type et l’heure de l’événement :

all_events_notifs.js

function handler(webhook) {
  const event = webhook.payload.data;
  const timestamp = new Date(webhook.payload.timestamp).toLocaleString();
  
  let color, emoji, title, fields = [];
  
  switch (webhook.eventType) {
    case "payment.succeeded":
      color = "good";
      emoji = "✅";
      title = "Payment Successful";
      fields = [
        { title: "Amount", value: `${(event.total_amount / 100).toFixed(2)} ${event.currency}`, short: true },
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Payment ID", value: event.payment_id, short: true },
        { title: "Method", value: event.payment_method || "Unknown", short: true }
      ];
      break;
      
    case "payment.failed":
      color = "danger";
      emoji = "❌";
      title = "Payment Failed";
      fields = [
        { title: "Amount", value: `${(event.total_amount / 100).toFixed(2)} ${event.currency}`, short: true },
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Reason", value: event.error_message || "Unknown", short: false }
      ];
      break;
      
    case "subscription.active":
      color = "good";
      emoji = "🎉";
      title = "Subscription Activated";
      fields = [
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Product ID", value: event.product_id, short: true },
        { title: "Amount", value: `${(event.recurring_pre_tax_amount / 100).toFixed(2)} ${event.currency}/${event.payment_frequency_interval}`, short: true },
        { title: "Next Billing", value: new Date(event.next_billing_date).toLocaleDateString(), short: true }
      ];
      break;
      
    case "subscription.cancelled":
      color = "warning";
      emoji = "⚠️";
      title = "Subscription Cancelled";
      fields = [
        { title: "Customer", value: event.customer.email, short: true },
        { title: "Product ID", value: event.product_id, short: true },
        { title: "Cancellation Date", value: new Date(event.cancelled_at).toLocaleDateString(), short: true },
        { title: "Cancel at Next Billing", value: event.cancel_at_next_billing_date ? "Yes" : "No", short: true }
      ];
      break;
      
    case "refund.succeeded":
      color = "good";
      emoji = "💰";
      title = "Refund Processed";
      fields = [
        { title: "Amount", value: `${(event.amount / 100).toFixed(2)} ${event.currency || ""}`, short: true },
        { title: "Refund ID", value: event.refund_id, short: true },
        { title: "Payment ID", value: event.payment_id, short: true },
        { title: "Reason", value: event.reason || "Not specified", short: true }
      ];
      break;
      
    case "dispute.opened":
      color = "danger";
      emoji = "🚨";
      title = "New Dispute Opened";
      fields = [
        { title: "Payment ID", value: event.payment_id, short: true },
        { title: "Amount", value: `${(event.amount / 100).toFixed(2)} ${event.currency}`, short: true },
        { title: "Status", value: event.dispute_status, short: true },
        { title: "Stage", value: event.dispute_stage, short: true },
        { title: "Remarks", value: event.remarks || "No remarks", short: false }
      ];
      break;
      
    case "license_key.created":
      color = "good";
      emoji = "🔑";
      title = "License Key Created";
      fields = [
        { title: "License ID", value: event.id, short: true },
        { title: "Product ID", value: event.product_id, short: true },
        { title: "License Key", value: event.key.substring(0, 8) + "****", short: true },
        { title: "Expires", value: event.expires_at ? new Date(event.expires_at).toLocaleDateString() : "Never", short: true }
      ];
      break;
      
    default:
      // Handle any other events with a generic format
      color = "#3aa3e3";
      emoji = "ℹ️";
      title = webhook.eventType.replace(/_/g, ' ').replace(/\b\w/g, l => l.toUpperCase());
      fields = [
        { title: "Event Type", value: webhook.eventType, short: true },
        { title: "Timestamp", value: timestamp, short: true }
      ];
  }
  
  webhook.payload = {
    attachments: [{
      color: color,
      title: `${emoji} ${title}`,
      fields: fields,
      footer: "Dodo Payments",
      ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
    }]
  };

  return webhook;
}

Bonnes pratiques

Suivez ces pratiques pour que les notifications Slack restent utiles :

Utilisez des pièces jointes de message avec des couleurs et des champs afin que chaque événement soit clair et facile à traiter.
Incluez les données importantes, comme le montant, l’adresse e-mail du client et les ID, afin que votre équipe puisse trouver rapidement l’enregistrement.
Faites correspondre la couleur au type d’événement : vert (good) pour une réussite, rouge (danger) pour les litiges ou les échecs, jaune (warning) pour les annulations et bleu (#3aa3e3) pour les événements informatifs.
Ajoutez un horodatage (ts) afin que chaque message indique la date et l’heure auxquelles l’événement s’est produit.

Gérez les données sensibles : ne publiez pas de valeurs sensibles, telles que des clés de licence complètes ou des données personnelles, dans Slack. Tronquez-les ou masquez-les, comme le fait le champ de clé de licence dans l’exemple couvrant tous les événements.

Résolution des problèmes

Notifications Not Appearing in Slack

Vérifiez que l’URL du webhook Slack est correcte et que son application Slack est toujours installée.
Vérifiez que le code de transformation est un JavaScript valide.
Vérifiez que les événements auxquels vous êtes abonnés se produisent. Pour en envoyer un, utilisez Envoyer un exemple dans l’onglet Tests de l’endpoint.
Vérifiez que les Webhooks entrants sont activés dans votre application Slack et qu’elle peut publier dans le canal.

Transformation Errors

Ouvrez l’onglet Journaux dans Développeur → Webhooks et vérifiez la réponse de la livraison ayant échoué.
Vérifiez que les champs de payload lus par votre code correspondent au payload de l’événement pour ce type d’événement.
Testez votre code avec Simuler et un payload d’exemple.
Vérifiez que chaque champ lu par votre code est présent. Les champs facultatifs, comme error_message, peuvent être null.

Missing Event Types

Vérifiez que l’événement est sélectionné dans Événements abonnés. Pour modifier la sélection, ouvrez l’endpoint et cliquez sur Modifier.
Vérifiez que le connecteur Slack prend en charge l’événement. Événements abonnés répertorie uniquement les événements pris en charge par le connecteur.
Vérifiez que votre transformation comporte un case pour l’événement. Les exemples laissent les autres événements inchangés, et Slack les rejette.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduction

Commencer

Exemples de code de transformation

Notifications de paiement de base

Notifications enrichies d’abonnement

Notifications de gestion des litiges

Gestionnaire complet de tous les événements

Bonnes pratiques

Résolution des problèmes

​Introduction

​Commencer

​Exemples de code de transformation

​Notifications de paiement de base

​Notifications enrichies d’abonnement

​Notifications de gestion des litiges

​Gestionnaire complet de tous les événements

​Bonnes pratiques

​Résolution des problèmes

Introduction

Commencer

Exemples de code de transformation

Notifications de paiement de base

Notifications enrichies d’abonnement

Notifications de gestion des litiges

Gestionnaire complet de tous les événements

Bonnes pratiques

Résolution des problèmes