Slack

Introduktion

Slack-integrationen skickar Dodo Payments-händelser, till exempel genomförda betalningar, prenumerationsändringar och tvister, till en Slack-kanal som du väljer. Ditt team kan följa betalningar och hantera tvister från Slack utan att kontrollera instrumentpanelen.

Slack-anslutningen omvandlar varje Dodo Payments-händelse till ett Slack-meddelande med en transformation: JavaScript-kod som körs på händelsen före leverans. Anslutningen levereras med transformationskod, så du behöver inte skriva någon kod för att komma igång. Du behöver åtkomst till Developer → Webhooks i Dodo Payments-instrumentpanelen och behörighet att lägga till appar i din Slack-arbetsyta.

Komma igång

Open the Webhook Section

Gå till Developer → Webhooks i Dodo Payments-kontrollpanelen och klicka på Add endpoint.

Dialogrutan Add endpoint med rullgardinsmenyn Integration inställd på Custom webhook

Select Slack Integration

Välj Slack under Integration. Kontrollpanelen läser in Slack-transformeringskoden och visar konfigurationssteg i panelen How to connect Slack.

Dialogrutan Add endpoint med Slack valt och stegen How to connect Slack

Create a Slack Webhook URL

Skapa en app i Slack med en inkommande webhook för den kanal som ska ta emot aviseringar:

Öppna api.slack.com/apps, klicka på Create New App och välj From scratch.
Ge appen ett namn, till exempel Dodo Payments Notifications, välj din arbetsyta och klicka på Create App.
Öppna Incoming Webhooks i sidofältet och aktivera Activate Incoming Webhooks.
Klicka på Add New Webhook to Workspace, välj kanalen och klicka på Allow.
Kopiera Webhook URL, som börjar med https://hooks.slack.com/services/.

Slack-behörighetsskärmen med en kanalväljare och knappen Allow

Paste the Webhook URL

Klistra in Slack-webhook-URL:en i Endpoint URL. Slack behöver ingen API-nyckel.

Select Events

Subscribed events visar de händelser som Slack-anslutningen stöder. Om du ändrar transformationen ska du bara behålla de händelser som den hanterar. Slack avvisar en begäran som inte är ett Slack-meddelande, så en händelse som transformationen lämnar oförändrad kan inte levereras.

Customize Transformation Code

Redigera hanteraren under Transformation code för att välja vilka händelser som ska publicera ett meddelande och hur varje meddelande ska se ut. Behåll anslutningens kod eller utgå från exemplen.

Redigerare för transformationskod med Slack-hanteraren för betalningshändelser

Test and Create

Under Test this code väljer du en händelsetyp och klickar på Simulate. Under Result visas meddelandet som Slack skulle ta emot. Klicka sedan på Create endpoint.

Panelen Test this code med payment.succeeded valt, en Simulate-knapp och knappen Create endpoint

Integration Complete!

Dodo Payments skickar nu varje prenumererad händelse till din Slack-kanal. Om du vill skicka ett testmeddelande öppnar du endpointens flik Testing, väljer en händelsetyp och klickar på Send example.

Exempel på transformeringskod

Varje hanterare ersätter webhook.payload med ett Slack-meddelande och behåller webhook.url, din inkommande webhook-URL. Belopp i Dodo Payments anges i den minsta valutaenheten, så exemplen dividerar med 100 och visar valutakoden. För valutor utan decimaler, som JPY och KRW, använder du beloppet som det är.

Grundläggande betalningsaviseringar

Publicera ett meddelande i klartext när en betalning lyckas, misslyckas eller behandlas:

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

Utförliga prenumerationsaviseringar

Publicera ett färgkodat meddelande med bifogade fält när en prenumeration aktiveras, avslutas eller förnyas:

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

Aviseringar om tvist- och reklamationshantering

Publicera ett rött meddelande när en tvist öppnas eller förloras, och ett grönt när den vinns:

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

Omfattande hanterare för alla händelser

Publicera ett meddelande i samma format för varje händelsetyp. Händelser utan en egen case får ett generiskt meddelande med händelsetyp och tid:

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

Bästa praxis

Följ dessa rekommendationer för att hålla Slack-aviseringarna användbara:

Använd meddelandebilagor med färger och fält, så att varje händelse blir tydlig och enkel att agera på.
Inkludera viktiga uppgifter som belopp, kundens e-postadress och ID:n, så att teamet snabbt kan hitta posten.
Anpassa färgen efter händelsetypen: grön (good) för lyckade händelser, röd (danger) för tvister eller misslyckanden, gul (warning) för avslut och blå (#3aa3e3) för informationshändelser.
Lägg till en tidsstämpel (ts), så att varje meddelande visar när händelsen inträffade.

Hantera känsliga data: Publicera inte känsliga värden, som fullständiga licensnycklar eller personuppgifter, i Slack. Korta ned eller maskera dem, på samma sätt som licensnyckelfältet i exemplet för alla händelser.

Felsökning

Notifications Not Appearing in Slack

Kontrollera att Slack-webhook-URL:en är korrekt och att Slack-appen fortfarande är installerad.
Kontrollera att transformeringskoden är giltig JavaScript.
Kontrollera att de prenumererade händelserna inträffar. Använd Send example på endpointens flik Testing för att skicka en.
Kontrollera att Slack-appen har Incoming Webhooks aktiverat och kan publicera i kanalen.

Transformation Errors

Öppna fliken Logs under Developer → Webhooks och kontrollera svaret för den misslyckade leveransen.
Kontrollera att payload-fälten som koden läser matchar event payload för den händelsetypen.
Testa koden med Simulate och en exempel-payload.
Kontrollera att varje fält som koden läser finns. Valfria fält, som error_message, kan vara null.

Missing Event Types

Kontrollera att händelsen är vald under Subscribed events. Öppna endpointen och klicka på Edit för att ändra urvalet.
Kontrollera att Slack-anslutningen stöder händelsen. Under Subscribed events visas endast händelser som anslutningen stöder.
Kontrollera att transformeringen har en case för händelsen. Exemplen lämnar andra händelser oförändrade, vilket Slack avvisar.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introduktion

Komma igång

Exempel på transformeringskod

Grundläggande betalningsaviseringar

Utförliga prenumerationsaviseringar

Aviseringar om tvist- och reklamationshantering

Omfattande hanterare för alla händelser

Bästa praxis

Felsökning

​Introduktion

​Komma igång

​Exempel på transformeringskod

​Grundläggande betalningsaviseringar

​Utförliga prenumerationsaviseringar

​Aviseringar om tvist- och reklamationshantering

​Omfattande hanterare för alla händelser

​Bästa praxis

​Felsökning

Introduktion

Komma igång

Exempel på transformeringskod

Grundläggande betalningsaviseringar

Utförliga prenumerationsaviseringar

Aviseringar om tvist- och reklamationshantering

Omfattande hanterare för alla händelser

Bästa praxis

Felsökning