المقدمة
أرسل رسائل البريد الإلكتروني للمعاملات تلقائيًا عند حدوث أحداث الدفع والاشتراك. تُرسل تأكيدات الدفع وتحديثات الاشتراك وإشعارات الفشل عبر 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 ورمز التحويل.

3
Enter API Key
الصق مفتاح Keplars API في API key. يرسل Dodo Payments المفتاح كرمز Bearer في كل طلب. ضمن 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.
رسالة تأكيد الدفع
payment_succeeded.js
إشعار بفشل الدفع
payment_failed.js
رسالة ترحيب بالاشتراك
subscription_active.js
رسالة إلغاء الاشتراك
subscription_cancelled.js
نصائح
- أرسل من نطاق أو عنوان تم التحقق منه لتحسين قابلية التسليم.
- أنشئ قالب Keplars واحدًا لكل نوع من الأحداث، حتى تظل كل رسالة متوافقة مع علامتك التجارية وموضوعها.
- خصّص كل رسالة بريد إلكتروني بتمرير بيانات العميل، مثل الاسم والمبلغ ومعرّف الدفع، في
params. - اختبر أولًا في وضع sandbox. تسجّل Keplars عمليات الإرسال في sandbox داخل Test Inbox بدلًا من تسليمها.
استكشاف الأخطاء وإصلاحها
Emails not being sent
Emails not being sent
- تحقق من صحة مفتاح API ونشاطه في Keplars ضمن Settings → API Keys.
- تحقق من التحقق من نطاق المُرسل أو عنوانه.
- في لوحة تحكم Dodo Payments، افتح الرسالة في علامة التبويب Logs ضمن Developer → Webhooks. تعرض كل محاولة تسليم استجابة الخطأ الأولية من Keplars.
Template not found
Template not found
- يجب أن يطابق
template_idفي المعالج قالبًا نشطًا في حساب Keplars الخاص بك. تحقق من المعرّف ومن أن القالب نشط في لوحة تحكم Keplars.
Wrong event triggered
Wrong event triggered
- يتحقق كل معالج من
webhook.eventTypeويعيد webhook دون تغيير إذا لم يتطابق الحدث. تحقق من أن Subscribed events لنقطة النهاية تتضمن الأحداث التي تريدها فقط.