Slack

Einführung

Die Slack-Integration veröffentlicht Dodo Payments-Ereignisse wie erfolgreiche Zahlungen, Abonnementänderungen und Disputes in einem von dir ausgewählten Slack-Kanal. Dein Team kann Zahlungen verfolgen und von Slack aus auf Disputes reagieren, ohne das Dashboard zu prüfen.

Der Slack-Connector wandelt jedes Dodo Payments-Ereignis mithilfe einer Transformation in eine Slack-Nachricht um: JavaScript-Code, der vor der Übermittlung für das Ereignis ausgeführt wird. Der Connector enthält bereits Transformationscode, sodass du ohne Programmieraufwand beginnen kannst. Du benötigst Zugriff auf Developer → Webhooks im Dodo Payments-Dashboard sowie die Berechtigung, Apps zu deinem Slack-Workspace hinzuzufügen.

Erste Schritte

Open the Webhook Section

Gehen Sie im Dodo Payments-Dashboard zu Developer → Webhooks und klicken Sie auf Add endpoint.

Add endpoint dialog with the Integration dropdown set to Custom webhook

Select Slack Integration

Wählen Sie unter Integration die Option Slack aus. Das Dashboard lädt den Slack-Transformationscode und zeigt die Einrichtungsschritte im Bereich How to connect Slack an.

Add endpoint dialog with Slack selected and the How to connect Slack steps

Create a Slack Webhook URL

Erstelle in Slack eine App mit einem eingehenden Webhook für den Kanal, der Benachrichtigungen empfangen soll:

Öffne api.slack.com/apps, klicke auf Create New App und wähle From scratch aus.
Benenne die App, zum Beispiel Dodo Payments Notifications, wähle deinen Workspace aus und klicke auf Create App.
Öffne in der Seitenleiste Incoming Webhooks und aktiviere Activate Incoming Webhooks.
Klicke auf Add New Webhook to Workspace, wähle den Kanal aus und klicke auf Allow.
Kopiere die Webhook URL, die mit https://hooks.slack.com/services/ beginnt.

Slack-Berechtigungsbildschirm mit einer Kanalauswahl und einer Schaltfläche Allow

Paste the Webhook URL

Füge die Slack-Webhook-URL in Endpoint URL ein. Slack benötigt keinen API-Schlüssel.

Select Events

Subscribed events enthält die Ereignisse, die der Slack-Connector unterstützt. Wenn du die Transformation änderst, behalte nur die Ereignisse bei, die sie verarbeitet. Slack lehnt eine Anfrage ab, die keine Slack-Nachricht ist. Daher kann ein Ereignis, das von der Transformation unverändert bleibt, nicht übermittelt werden.

Customize Transformation Code

Bearbeite unter Transformation code den Handler, um auszuwählen, welche Ereignisse eine Nachricht veröffentlichen und wie die einzelnen Nachrichten aussehen. Behalte den Code des Connectors bei oder beginne mit den Beispielen.

Editor für Transformationscode mit dem Slack-Handler für Zahlungsereignisse

Test and Create

Wählen Sie unter Test this code einen Ereignistyp aus und klicken Sie auf Simulate. Unter Result wird die Nachricht angezeigt, die Slack empfangen würde. Klicken Sie anschließend auf Create endpoint.

Test this code panel with payment.succeeded selected, a Simulate button, and the Create endpoint button

Integration Complete!

Dodo Payments veröffentlicht nun jedes abonnierte Ereignis in deinem Slack-Kanal. Um eine Testnachricht zu veröffentlichen, öffne im Endpunkt den Tab Testing, wähle einen Ereignistyp aus und klicke auf Send example.

Beispiele für Transformationscode

Jeder Handler ersetzt webhook.payload durch eine Slack-Nachricht und behält webhook.url, Ihre eingehende Webhook-URL, bei. Die Beträge in Dodo Payments werden in der kleinsten Währungseinheit angegeben. Daher teilen die Beispiele durch 100 und zeigen den Währungscode an. Verwenden Sie bei Währungen ohne Nachkommastellen wie JPY und KRW den Betrag unverändert.

Grundlegende Zahlungsbenachrichtigungen

Senden Sie eine Nur-Text-Nachricht, wenn eine Zahlung erfolgreich ist, fehlschlägt oder verarbeitet wird:

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

Aussagekräftige Abonnementbenachrichtigungen

Senden Sie eine farbcodierte Nachricht mit Anhangfeldern, wenn ein Abonnement aktiv wird, gekündigt wird oder sich verlängert:

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

Benachrichtigungen zur Streitfallverwaltung

Senden Sie eine rote Nachricht, wenn ein Streitfall eröffnet wird oder verloren geht, und eine grüne Nachricht, wenn er gewonnen wird:

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

Umfassender Handler für alle Ereignisse

Senden Sie für jeden Ereignistyp eine Nachricht im gleichen Format. Ereignisse ohne eigenes case erhalten eine allgemeine Nachricht mit dem Ereignistyp und dem Zeitpunkt:

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

Best Practices

Befolgen Sie diese Empfehlungen, damit Slack-Benachrichtigungen nützlich bleiben:

Verwenden Sie Nachrichtenanhänge mit Farben und Feldern, damit jedes Ereignis klar und einfach bearbeitbar ist.
Fügen Sie wichtige Daten wie den Betrag, die E-Mail-Adresse des Kunden und IDs ein, damit Ihr Team den Datensatz schnell finden kann.
Stimmen Sie die Farbe auf den Ereignistyp ab: Grün (good) für erfolgreiche Vorgänge, Rot (danger) für Streitfälle oder Fehler, Gelb (warning) für Kündigungen und Blau (#3aa3e3) für informative Ereignisse.
Fügen Sie einen Zeitstempel (ts) hinzu, damit jede Nachricht den Zeitpunkt des Ereignisses anzeigt.

Umgang mit vertraulichen Daten: Posten Sie keine vertraulichen Werte wie vollständige Lizenzschlüssel oder personenbezogene Daten in Slack. Kürzen oder maskieren Sie diese, wie es das Feld für den Lizenzschlüssel im Beispiel für alle Ereignisse tut.

Fehlerbehebung

Notifications Not Appearing in Slack

Prüfen Sie, ob die Slack-Webhook-URL korrekt ist und die zugehörige Slack-App noch installiert ist.
Prüfen Sie, ob der Transformationscode gültiges JavaScript ist.
Prüfen Sie, ob die abonnierten Ereignisse auftreten. Verwenden Sie zum Senden eines Ereignisses Send example auf dem Tab Testing des Endpunkts.
Prüfen Sie, ob Incoming Webhooks in Ihrer Slack-App aktiviert ist und Nachrichten im Kanal posten kann.

Transformation Errors

Öffnen Sie den Tab Logs unter Developer → Webhooks und prüfen Sie die Antwort der fehlgeschlagenen Zustellung.
Prüfen Sie, ob die Payload-Felder, die Ihr Code liest, mit der event payload für diesen Ereignistyp übereinstimmen.
Testen Sie Ihren Code mit Simulate und einer Beispiel-Payload.
Prüfen Sie, ob jedes von Ihrem Code gelesene Feld vorhanden ist. Optionale Felder wie error_message können null sein.

Missing Event Types

Prüfen Sie, ob das Ereignis unter Subscribed events ausgewählt ist. Um die Auswahl zu ändern, öffnen Sie den Endpunkt und klicken Sie auf Edit.
Prüfen Sie, ob der Slack-Connector das Ereignis unterstützt. Unter Subscribed events werden nur die vom Connector unterstützten Ereignisse aufgeführt.
Prüfen Sie, ob Ihre Transformation ein case für das Ereignis enthält. Die Beispiele lassen andere Ereignisse unverändert, und Slack weist sie zurück.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Einführung

Erste Schritte

Beispiele für Transformationscode

Grundlegende Zahlungsbenachrichtigungen

Aussagekräftige Abonnementbenachrichtigungen

Benachrichtigungen zur Streitfallverwaltung

Umfassender Handler für alle Ereignisse

Best Practices

Fehlerbehebung

​Einführung

​Erste Schritte

​Beispiele für Transformationscode

​Grundlegende Zahlungsbenachrichtigungen

​Aussagekräftige Abonnementbenachrichtigungen

​Benachrichtigungen zur Streitfallverwaltung

​Umfassender Handler für alle Ereignisse

​Best Practices

​Fehlerbehebung

Einführung

Erste Schritte

Beispiele für Transformationscode

Grundlegende Zahlungsbenachrichtigungen

Aussagekräftige Abonnementbenachrichtigungen

Benachrichtigungen zur Streitfallverwaltung

Umfassender Handler für alle Ereignisse

Best Practices

Fehlerbehebung