Skip to main content

المقدمة

أرسل رسائل البريد الإلكتروني للمعاملات تلقائيًا عند حدوث أحداث الدفع والاشتراك. تُرسل تأكيدات الدفع وتحديثات الاشتراك وإشعارات الفشل عبر Keplars من دون خادم وسيط: يستدعي Dodo Payments واجهة Keplars API مباشرةً باستخدام معالج تحويل JavaScript.
تتطلب هذه العملية التكاملية المصادقة باستخدام مفتاح Keplars API الخاص بك. اعثر عليه في لوحة معلومات Keplars ضمن Settings → API Keys، وتحقق من نطاق أو عنوان مُرسل ضمن Domains.

كيفية البدء

1

Open the Webhook Section

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

Select Keplars

في Integration، اختر Keplars. يملأ القالب عنوان URL لـ Keplars API ورمز التحويل.
مربع حوار إضافة نقطة نهاية مع تحديد Keplars في القائمة المنسدلة Integration
3

Enter API Key

الصق مفتاح Keplars API في API key. يرسل Dodo Payments المفتاح كرمز Bearer في كل طلب. ضمن Subscribed events، حدد الأحداث التي يجب أن ترسل بريدًا إلكترونيًا.
عنوان URL لنقطة نهاية Keplars مملوء، وحقل API key، وقائمة Subscribed events
4

Configure Transformation

في Transformation code، عدّل الرمز لتنسيق رسائل البريد الإلكتروني لـ Keplars. استبدل معرّفات القوالب النائبة بالمعرّفات الخاصة بك.
5

Test & Create

ضمن Test this code، حدد نوع حدث وانقر على Simulate لتشغيل التحويل باستخدام حمولة نموذجية. ثم انقر على Create endpoint لبدء إرسال رسائل البريد الإلكتروني.
6

Done

ترسل أحداث Dodo Payments الآن رسائل البريد الإلكتروني للمعاملات عبر Keplars.

أمثلة كود التحويل

يعيّن كل معالج webhook.url إلى نقطة نهاية الإرسال ذات الأولوية العالية في Keplars، ويعيد كتابة webhook.payload إلى طلب Keplars. يضيف Dodo Payments مفتاح API كرمز Bearer. استبدل your-keplars-*-template-id بمعرّفات القوالب الخاصة بك. لا تتضمن Keplars send API حقل from، لذلك ترسل Keplars كل رسالة بريد إلكتروني من مُرسل أعددته في لوحة تحكم Keplars.
يجب أن يكون to مصفوفة، حتى مع مستلم واحد. عند استخدام template_id، لا ترسل أيضًا subject أو body، لأن القالب يوفّرهما.

رسالة تأكيد الدفع

payment_succeeded.js

إشعار بفشل الدفع

payment_failed.js

رسالة ترحيب بالاشتراك

subscription_active.js

رسالة إلغاء الاشتراك

subscription_cancelled.js

نصائح

  • أرسل من نطاق أو عنوان تم التحقق منه لتحسين قابلية التسليم.
  • أنشئ قالب Keplars واحدًا لكل نوع من الأحداث، حتى تظل كل رسالة متوافقة مع علامتك التجارية وموضوعها.
  • خصّص كل رسالة بريد إلكتروني بتمرير بيانات العميل، مثل الاسم والمبلغ ومعرّف الدفع، في params.
  • اختبر أولًا في وضع sandbox. تسجّل Keplars عمليات الإرسال في sandbox داخل Test Inbox بدلًا من تسليمها.

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

  • تحقق من صحة مفتاح API ونشاطه في Keplars ضمن Settings → API Keys.
  • تحقق من التحقق من نطاق المُرسل أو عنوانه.
  • في لوحة تحكم Dodo Payments، افتح الرسالة في علامة التبويب Logs ضمن Developer → Webhooks. تعرض كل محاولة تسليم استجابة الخطأ الأولية من Keplars.
  • يجب أن يطابق template_id في المعالج قالبًا نشطًا في حساب Keplars الخاص بك. تحقق من المعرّف ومن أن القالب نشط في لوحة تحكم Keplars.
  • يتحقق كل معالج من webhook.eventType ويعيد webhook دون تغيير إذا لم يتطابق الحدث. تحقق من أن Subscribed events لنقطة النهاية تتضمن الأحداث التي تريدها فقط.
آخر تعديل في ٢٦ سبتمبر ٢٠٢٦