Slack

Pendahuluan

Integrasi Slack memposting event Dodo Payments, seperti pembayaran yang berhasil, perubahan subscription, dan dispute, ke channel Slack yang Anda pilih. Tim Anda dapat memantau pembayaran dan menangani dispute dari Slack tanpa memeriksa dashboard.

Slack connector mengubah setiap event Dodo Payments menjadi pesan Slack dengan transformation: kode JavaScript yang berjalan pada event sebelum delivery. Connector dilengkapi dengan transformation code, sehingga Anda tidak perlu coding untuk memulainya. Anda memerlukan akses ke Developer → Webhooks di dashboard Dodo Payments dan izin untuk menambahkan app ke Slack workspace Anda.

Memulai

Open the Webhook Section

Di dashboard Dodo Payments, buka Developer → Webhooks lalu klik Add endpoint.

Dialog Add endpoint dengan dropdown Integration yang disetel ke Custom webhook

Select Slack Integration

Di Integration, pilih Slack. Dashboard memuat kode transformasi Slack dan menampilkan langkah-langkah penyiapan di panel How to connect Slack.

Dialog Add endpoint dengan Slack yang dipilih dan langkah-langkah How to connect Slack

Create a Slack Webhook URL

Di Slack, buat app dengan incoming webhook untuk channel yang akan menerima notifikasi:

Buka api.slack.com/apps, klik Create New App, lalu pilih From scratch.
Beri nama app, misalnya Dodo Payments Notifications, pilih workspace Anda, lalu klik Create App.
Di sidebar, buka Incoming Webhooks dan aktifkan Activate Incoming Webhooks.
Klik Add New Webhook to Workspace, pilih channel, lalu klik Allow.
Salin Webhook URL, yang dimulai dengan https://hooks.slack.com/services/.

Layar izin Slack dengan pemilih channel dan tombol Allow

Paste the Webhook URL

Tempel Slack webhook URL ke Endpoint URL. Slack tidak memerlukan API key.

Select Events

Subscribed events mencantumkan event yang didukung Slack connector. Jika Anda mengubah transformation, pertahankan hanya event yang ditanganinya. Slack menolak request yang bukan pesan Slack, sehingga event yang dibiarkan tidak berubah oleh transformation gagal dikirim.

Customize Transformation Code

Di bawah Transformation code, edit handler untuk memilih event mana yang memposting pesan dan seperti apa tampilan setiap pesan. Pertahankan code connector, atau mulai dari examples.

Editor transformation code dengan Slack handler untuk event pembayaran

Test and Create

Di bawah Test this code, pilih jenis event lalu klik Simulate. Result menampilkan pesan yang akan diterima Slack. Kemudian klik Create endpoint.

Panel Test this code dengan payment.succeeded yang dipilih, tombol Simulate, dan tombol Create endpoint

Integration Complete!

Dodo Payments sekarang memposting setiap event yang di-subscribe ke channel Slack Anda. Untuk memposting pesan pengujian, buka tab Testing pada endpoint, pilih jenis event, lalu klik Send example.

Contoh Kode Transformasi

Setiap handler mengganti webhook.payload dengan pesan Slack dan mempertahankan webhook.url, yaitu URL incoming webhook Anda. Jumlah Dodo Payments menggunakan unit mata uang terkecil, sehingga contoh-contoh ini membaginya dengan 100 dan menampilkan kode mata uang. Untuk mata uang tanpa angka desimal seperti JPY dan KRW, gunakan jumlah tersebut apa adanya.

Notifikasi Pembayaran Dasar

Kirim pesan teks biasa saat pembayaran berhasil, gagal, atau sedang diproses:

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

Notifikasi Subscription yang Kaya

Kirim pesan berkode warna dengan kolom lampiran saat subscription menjadi aktif, dibatalkan, atau diperpanjang:

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

Notifikasi Manajemen Dispute

Kirim pesan merah saat dispute dibuka atau kalah, dan pesan hijau saat dimenangkan:

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

Handler Semua Event yang Komprehensif

Kirim pesan dalam format yang sama untuk setiap jenis event. Event yang tidak memiliki case sendiri akan mendapatkan pesan umum yang berisi jenis dan waktu event:

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

Praktik Terbaik

Ikuti praktik berikut agar notifikasi Slack tetap bermanfaat:

Gunakan lampiran pesan dengan warna dan kolom, sehingga setiap event jelas dan mudah ditindaklanjuti.
Sertakan data penting seperti jumlah, email pelanggan, dan ID, sehingga tim Anda dapat menemukan catatan tersebut dengan cepat.
Sesuaikan warna dengan jenis event: hijau (good) untuk keberhasilan, merah (danger) untuk dispute atau kegagalan, kuning (warning) untuk pembatalan, dan biru (#3aa3e3) untuk event informasional.
Tambahkan timestamp (ts), sehingga setiap pesan menampilkan waktu terjadinya event.

Tangani Data Sensitif: Jangan kirim nilai sensitif seperti kunci lisensi lengkap atau data pribadi ke Slack. Potong atau samarkan nilai tersebut, seperti yang dilakukan pada kolom kunci lisensi dalam contoh semua event.

Pemecahan Masalah

Notifications Not Appearing in Slack

Periksa apakah URL Slack webhook sudah benar dan aplikasi Slack-nya masih terpasang.
Periksa apakah kode transformasi merupakan JavaScript yang valid.
Periksa apakah event yang di-subscribe sedang terjadi. Untuk mengirim salah satunya, gunakan Send example pada tab Testing endpoint.
Periksa apakah aplikasi Slack Anda telah mengaktifkan Incoming Webhooks dan dapat mengirim pesan ke channel tersebut.

Transformation Errors

Buka tab Logs di Developer → Webhooks dan periksa respons delivery yang gagal.
Periksa apakah field payload yang dibaca kode Anda sesuai dengan event payload untuk jenis event tersebut.
Uji kode Anda dengan Simulate dan payload contoh.
Periksa apakah setiap field yang dibaca kode Anda tersedia. Field opsional, seperti error_message, dapat berupa null.

Missing Event Types

Periksa apakah event dipilih di Subscribed events. Untuk mengubah pilihan, buka endpoint lalu klik Edit.
Periksa apakah konektor Slack mendukung event tersebut. Subscribed events hanya mencantumkan event yang didukung konektor.
Periksa apakah transformasi Anda memiliki case untuk event tersebut. Contoh-contoh ini membiarkan event lain tetap apa adanya, dan Slack akan menolaknya.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Pendahuluan

Memulai

Contoh Kode Transformasi

Notifikasi Pembayaran Dasar

Notifikasi Subscription yang Kaya

Notifikasi Manajemen Dispute

Handler Semua Event yang Komprehensif

Praktik Terbaik

Pemecahan Masalah

​Pendahuluan

​Memulai

​Contoh Kode Transformasi

​Notifikasi Pembayaran Dasar

​Notifikasi Subscription yang Kaya

​Notifikasi Manajemen Dispute

​Handler Semua Event yang Komprehensif

​Praktik Terbaik

​Pemecahan Masalah

Pendahuluan

Memulai

Contoh Kode Transformasi

Notifikasi Pembayaran Dasar

Notifikasi Subscription yang Kaya

Notifikasi Manajemen Dispute

Handler Semua Event yang Komprehensif

Praktik Terbaik

Pemecahan Masalah