انتقل إلى المحتوى الرئيسي

Xendit

تعليمات لربط Xendit​

تدعم منصة OneEntry التكامل مع نظام الدفع Xendit. اختر هذا النوع من حسابات الدفع إذا كنت ترغب في قبول المدفوعات عبر Xendit.

أنشئ حساب دفع من نوع Xendit​

تم وصف كيفية إنشاء حساب دفع هنا (يفتح في علامة تبويب جديدة). في حقل "النوع"، اختر القيمة Xendit.

املأ إعدادات الحساب​

افتح حساب الدفع الذي تم إنشاؤه للتعديل. في قسم Details، حدد:

  • Success URL — العنوان الذي سيعود إليه المشتري بعد الدفع الناجح.
  • Cancel URL — العنوان الذي سيعود إليه المشتري عند إلغاء الدفع.
  • Session timeout — مدة صلاحية جلسة الدفع، بعد انتهاء هذه المدة تصبح الجلسة غير صالحة. يجب أن تكون القيمة لـ Xendit أكبر من 10.

قم بتوصيل Xendit​

في قسم Connect Xendit، أدخل بيانات الاعتماد من لوحة التحكم الخاصة بـ Xendit (Xendit Dashboard → Settings → Developers):

  • Testing mode — وضع الاختبار. طالما كانت هذه الخانة محددة، فإن الاتصال يعمل بمفاتيح اختبار Xendit؛ قم بإلغاء تحديدها لقبول المدفوعات الحقيقية.
  • API Key — مفتاح API السري لحسابك في Xendit (قسم API Keys).
  • Callback Token — رمز التحقق من ردود Xendit (قسم Callbacks). يُستخدم للتحقق من صحة الإشعارات الواردة عن الدفع.
  • Available payment methods — طرق الدفع التي ستكون متاحة للمشتري. هذا الحقل إلزامي — اختر على الأقل طريقة واحدة. من بين الخيارات المتاحة: CARDS، الحسابات المصرفية الافتراضية (BCA_VIRTUAL_ACCOUNT, BNI_VIRTUAL_ACCOUNT, BRI_VIRTUAL_ACCOUNT, MANDIRI_VIRTUAL_ACCOUNT, PERMATA_VIRTUAL_ACCOUNT, CIMB_VIRTUAL_ACCOUNT)، المحافظ الإلكترونية (OVO, DANA, LINKAJA, SHOPEEPAY, ASTRAPAY)، QRIS، بالإضافة إلى ALFAMART و INDOMARET.

يتم حفظ التغييرات تلقائيًا.

قم بإعداد التحديث التلقائي لحالات الطلب​

انتقل إلى Payments → Statuses، اختر مستودع الطلبات المطلوب و قم بربط (يفتح في علامة تبويب جديدة) حالات الدفع المسبقة بحالات مستودع الطلبات الخاص بك. عندها، ستتحدث حالة الطلب تلقائيًا عند حدوث أحداث الدفع من Xendit.

معلمات مخصصة لواجهة برمجة تطبيقات الدفع​

كما هو الحال مع مقدمي الخدمة الآخرين، يمكن إضافة معلمات مخصصة لحساب الدفع Xendit، وهي محددة لواجهة برمجة تطبيقات Xendit (قسم «المعلمات المخصصة لواجهة برمجة تطبيقات الدفع»). لمزيد من التفاصيل حول هذه الآلية — في قسم «الحسابات» (يفتح في علامة تبويب جديدة).