Slack

परिचय

Slack integration Dodo Payments events, जैसे successful payments, subscription changes और disputes, को आपके चुने हुए Slack channel पर पोस्ट करता है। आपकी team Slack से payments को follow कर सकती है और disputes पर कार्रवाई कर सकती है, dashboard जाँचे बिना।

Slack connector प्रत्येक Dodo Payments event को transformation के साथ Slack message में बदलता है: यह JavaScript code होता है जो delivery से पहले event पर चलता है। Connector में transformation code शामिल होता है, इसलिए शुरुआत करने के लिए coding की आवश्यकता नहीं है। आपको Dodo Payments dashboard में Developer → Webhooks का access और अपने Slack workspace में apps जोड़ने की permission चाहिए।

प्रारंभ करना

Open the Webhook Section

Dodo Payments dashboard में Developer → Webhooks पर जाएँ और Add endpoint पर क्लिक करें।

Add endpoint dialog with the Integration dropdown set to Custom webhook

Select Slack Integration

Integration में Slack चुनें। dashboard Slack transformation code लोड करता है और How to connect Slack panel में setup steps दिखाता है।

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

Create a Slack Webhook URL

Slack में उस channel के लिए incoming webhook वाला app बनाएँ जिसे notifications प्राप्त करनी हैं:

api.slack.com/apps खोलें, Create New App पर click करें और From scratch चुनें।
App का नाम रखें, उदाहरण के लिए Dodo Payments Notifications, अपना workspace चुनें और Create App पर click करें।
Sidebar में Incoming Webhooks खोलें और Activate Incoming Webhooks चालू करें।
Add New Webhook to Workspace पर click करें, channel चुनें और Allow पर click करें।
Webhook URL copy करें, जो https://hooks.slack.com/services/ से शुरू होता है।

Channel picker और Allow button वाली Slack permission screen

Paste the Webhook URL

Slack webhook URL को Endpoint URL में paste करें। Slack को API key की आवश्यकता नहीं है।

Select Events

Subscribed events उन events की सूची देता है जिन्हें Slack connector support करता है। यदि आप transformation बदलते हैं, तो केवल वही events रखें जिन्हें यह handle करता है। Slack ऐसी request को reject करता है जो Slack message नहीं होती, इसलिए transformation द्वारा अपरिवर्तित छोड़ा गया event deliver होने में विफल रहता है।

Customize Transformation Code

Transformation code के अंतर्गत handler को edit करके चुनें कि कौन से events message पोस्ट करें और प्रत्येक message कैसा दिखे। Connector का code रखें या examples से शुरुआत करें।

Payment events के लिए Slack handler वाला Transformation code editor

Test and Create

Test this code के अंतर्गत, कोई event type चुनें और Simulate पर क्लिक करें। Result में वह message दिखता है जो Slack को प्राप्त होगा। फिर Create endpoint पर क्लिक करें।

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

Integration Complete!

Dodo Payments अब प्रत्येक subscribed event को आपके Slack channel पर पोस्ट करता है। Test message पोस्ट करने के लिए endpoint का Testing tab खोलें, event type चुनें और Send example पर click करें।

Transformation Code Examples

हर handler webhook.payload को Slack message से बदलता है और webhook.url, आपके incoming webhook URL को बनाए रखता है। Dodo Payments की राशियाँ currency की सबसे छोटी इकाई में होती हैं, इसलिए examples 100 से भाग देकर currency code दिखाते हैं। JPY और KRW जैसी zero-decimal currencies के लिए राशि को यथावत उपयोग करें।

Basic Payment Notifications

किसी payment के सफल होने, विफल होने या processing में होने पर plain-text message post करें:

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

Rich Subscription Notifications

जब कोई subscription active हो, cancel हो या renew हो, तब attachment fields के साथ color-coded message post करें:

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

Dispute Management Notifications

जब कोई dispute open हो या lost हो, तब red message post करें और जब वह won हो, तब green message post करें:

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

Comprehensive All-Events Handler

हर event type के लिए समान format में message post करें। जिन events का अपना case नहीं है, उन्हें event type और time वाला generic message मिलता है:

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

Slack notifications को उपयोगी बनाए रखने के लिए इन practices का पालन करें:

colors और fields वाले message attachments का उपयोग करें, ताकि प्रत्येक event स्पष्ट हो और उस पर आसानी से कार्रवाई की जा सके।
amount, customer email और IDs जैसे महत्वपूर्ण data शामिल करें, ताकि आपकी team record तुरंत ढूँढ सके।
color को event type से मिलाएँ: success के लिए green (good), disputes या failures के लिए red (danger), cancellations के लिए yellow (warning), और informational events के लिए blue (#3aa3e3)।
timestamp (ts) जोड़ें, ताकि प्रत्येक message में event का समय दिखे।

Handle Sensitive Data: full license keys या personal data जैसे sensitive values Slack पर post न करें। उन्हें truncate या mask करें, जैसा कि all-events example में license key field के लिए किया गया है।

Troubleshooting

Notifications Not Appearing in Slack

जाँचें कि Slack webhook URL सही है और उसका Slack app अभी भी installed है।
जाँचें कि transformation code valid JavaScript है।
जाँचें कि subscribed events घटित हो रहे हैं। किसी event को भेजने के लिए endpoint के Testing tab में Send example का उपयोग करें।
जाँचें कि आपके Slack app में Incoming Webhooks turned on है और वह channel पर post कर सकता है।

Transformation Errors

Developer → Webhooks में Logs tab खोलें और failed delivery की response जाँचें।
जाँचें कि आपका code जिन payload fields को पढ़ता है, वे उस event type के event payload से मेल खाते हैं।
Simulate और sample payload के साथ अपने code का परीक्षण करें।
जाँचें कि आपका code जिन fields को पढ़ता है, वे सभी मौजूद हैं। error_message जैसे optional fields null हो सकते हैं।

Missing Event Types

जाँचें कि event Subscribed events में selected है। selection बदलने के लिए endpoint खोलें और Edit पर क्लिक करें।
जाँचें कि Slack connector उस event को support करता है। Subscribed events में केवल connector द्वारा supported events सूचीबद्ध होते हैं।
जाँचें कि आपके transformation में उस event के लिए case है। examples अन्य events को unchanged छोड़ते हैं और Slack उन्हें reject करता है।

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

परिचय

प्रारंभ करना

Transformation Code Examples

Basic Payment Notifications

Rich Subscription Notifications

Dispute Management Notifications

Comprehensive All-Events Handler

Best Practices

Troubleshooting

​परिचय

​प्रारंभ करना

​Transformation Code Examples

​Basic Payment Notifications

​Rich Subscription Notifications

​Dispute Management Notifications

​Comprehensive All-Events Handler

​Best Practices

​Troubleshooting

परिचय

प्रारंभ करना

Transformation Code Examples

Basic Payment Notifications

Rich Subscription Notifications

Dispute Management Notifications

Comprehensive All-Events Handler

Best Practices

Troubleshooting