ديسكورد

المقدمة

ينشر تكامل Discord أحداث Dodo Payments المتعلقة بالمدفوعات والاشتراكات والنزاعات وغيرها في قناة Discord تختارها. يرى فريقك كل حدث في المكان الذي يتعاون فيه بالفعل، من دون الاستعلام المتكرر من API أو التحقق من لوحة المعلومات.

تحتاج إلى الوصول إلى Developer → Webhooks في لوحة معلومات Dodo Payments، وإلى إذن Manage Webhooks في خادم Discord.

البدء

Create a Discord Webhook

في Discord، افتح القناة التي ينبغي أن تتلقى الإشعارات وانقر على Edit Channel. انتقل إلى Integrations → Webhooks → New Webhook، وسمِّ webhook، وأكّد القناة، ثم انقر على Copy Webhook URL.

Open the Webhook Section

في لوحة تحكم Dodo Payments، انتقل إلى Developer → Webhooks وانقر على Add endpoint.

مربع حوار إضافة نقطة نهاية مع تحديد Discord في القائمة المنسدلة للتكامل

Select Discord

ضمن Integration، اختر Discord. تكرّر لوحة How to connect Discord خطوات إنشاء Discord webhook.

Paste the Webhook URL

الصق عنوان URL الخاص بـ Discord webhook، الذي يبدأ بـ https://discord.com/api/webhooks/، في Endpoint URL. لا يحتاج Discord إلى API key.

Select Events

ضمن Subscribed events، اختر الأحداث التي يتعامل معها التحويل. يرفض Discord رسالة لا تحتوي على content أو embeds، لذلك يفشل تسليم أي حدث لا يحوّله التحويل.

Edit Transformation Code

ضمن Transformation code، خصّص طريقة تعيين كل حدث إلى embed في Discord، أو ابدأ من الأمثلة.

Test & Create

ضمن Test this code، انقر على Simulate لمعاينة embed لحمولة نموذجية. ثم انقر على Create endpoint.

Done

ستتلقى قناة Discord لديك الآن رسالة لكل حدث مشترك فيه.

أمثلة على Transformation Code

يستبدل كل handler القيمة webhook.payload برسالة Discord تحتوي على embed واحد. تكون مبالغ Dodo Payments بوحدة العملة الأصغر، لذلك تقسم الأمثلة المبلغ على 100 وتعرض رمز العملة.

Minimal Payment Embed

انشر embed عند نجاح دفعة (payment.succeeded):

payment_embed.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.payload = {
      embeds: [{
        title: "✅ Payment Successful",
        description: `**Amount:** ${(p.total_amount / 100).toFixed(2)} ${p.currency}\n**Customer:** ${p.customer.email}`,
        color: 0x2ecc71 // green
      }]
    };
  }
  return webhook;
}

أحداث الاشتراك

انشر embed عند تفعيل اشتراك (subscription.active) أو إلغائه (subscription.cancelled):

subscription_embed.js

function handler(webhook) {
  const s = webhook.payload.data;
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        embeds: [{
          title: "📄 Subscription Activated",
          fields: [
            { name: "Customer", value: s.customer.email, inline: true },
            { name: "Product", value: s.product_id, inline: true },
            { name: "Next Billing", value: new Date(s.next_billing_date).toLocaleDateString(), inline: true }
          ],
          color: 0x2ecc71
        }]
      };
      break;
    case "subscription.cancelled":
      webhook.payload = {
        embeds: [{
          title: "⚠️ Subscription Cancelled",
          fields: [
            { name: "Customer", value: s.customer.email, inline: true },
            { name: "Product", value: s.product_id, inline: true }
          ],
          color: 0xf1c40f
        }]
      };
      break;
  }
  return webhook;
}

تنبيهات النزاعات

انشر embed لكل حدث من أحداث النزاع، مثل dispute.opened وdispute.won وdispute.lost. يتبع العنوان واللون قيمة dispute_status الخاصة بالنزاع:

dispute_embed.js

function handler(webhook) {
  if (webhook.eventType.startsWith("dispute.")) {
    const d = webhook.payload.data;
    webhook.payload = {
      embeds: [{
        title: d.dispute_status === "dispute_won" ? "🏆 Dispute Won" : d.dispute_status === "dispute_lost" ? "❌ Dispute Lost" : "🚨 Dispute Update",
        fields: [
          { name: "Payment ID", value: d.payment_id, inline: true },
          { name: "Amount", value: `${(d.amount / 100).toFixed(2)} ${d.currency}`, inline: true },
          { name: "Status", value: d.dispute_status, inline: true }
        ],
        color: d.dispute_status === "dispute_won" ? 0x2ecc71 : d.dispute_status === "dispute_lost" ? 0xe74c3c : 0xe67e22
      }]
    };
  }
  return webhook;
}

نصائح

استخدم التضمينات للتنسيق المتقدم والألوان.
اجعل العناوين قصيرة، وضع التفاصيل في الحقول.
استخدم ألوانًا تشير إلى النتيجة: الأخضر للنجاح، والأحمر للفشل، والبرتقالي للتحذيرات.

استكشاف الأخطاء وإصلاحها

No Messages in Discord

تأكد من أن webhook لا يزال موجودًا ضمن Integrations → Webhooks للقناة، وأن Endpoint URL يطابق عنوان URL الخاص به.
تحقق من أن التحويل يُرجع كائن JSON مع embeds.
تحقق من أن Subscribed events تتضمن الأحداث التي تتوقعها.
افتح محاولات تسليم نقطة النهاية ضمن علامة التبويب Logs في Developer → Webhooks للاطلاع على رمز استجابة Discord.

Transformation Errors

تحقّق من صحة التعليمات البرمجية في المحرر. تمنع أخطاء بناء الجملة التسليم.
تحقق من تطابق أسماء الحقول مع بنية حمولة webhook.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

المقدمة

البدء

أمثلة على Transformation Code

Minimal Payment Embed

أحداث الاشتراك

تنبيهات النزاعات

نصائح

استكشاف الأخطاء وإصلاحها

​المقدمة

​البدء

​أمثلة على Transformation Code

​Minimal Payment Embed

​أحداث الاشتراك

​تنبيهات النزاعات

​نصائح

​استكشاف الأخطاء وإصلاحها

المقدمة

البدء

أمثلة على Transformation Code

Minimal Payment Embed

أحداث الاشتراك

تنبيهات النزاعات

نصائح

استكشاف الأخطاء وإصلاحها