Paytabs

ربط PayTabs بـ Mavibot

لربط PayTabs مع Mavibot، تحتاج إلى تهيئة عدة إعدادات في حساب PayTabs الخاص بك.

1. إنشاء مفتاح API

في لوحة تحكم PayTabs الخاصة بك، انتقل إلى:

المطورون ← مفاتيح API

أنشئ مفتاح API جديدًا.

بعد إنشاء مفتاح API، احفظ التفاصيل التالية:

• مفتاح الخادم — مطلوب لإعداد التكامل.

• معرّف الملف الشخصي — مطلوب أيضًا لإعداد الاتصال.

2. تهيئة إشعارات الدفع

انتقل إلى:

المطورون ← الإعدادات

قم بتمكين إشعارات الدفع (استدعاءات الرجوع).

انقر "+" وأضف رابط callback التالي:

https://chatter.mavibot.ai/paytabs_callback/result

يُستخدم هذا الرابط لإرسال تحديثات حالة الدفع إلى Mavibot.

3. تهيئة PayTabs في Mavibot

في إعدادات Mavibot:

1. انتقل إلى قسم التحصيل القسم

2. اختر PayTabs كمزوّد الدفع

3. أدخل التفاصيل التالية:

   • معرّف الملف الشخصي

   • مفتاح الخادم

4. اختر منطقة حساب PayTabs الخاصة بك

يرجى الملاحظة! يجب أن تتطابق المنطقة المحددة مع المنطقة التي تم تسجيل حساب PayTabs الخاص بك فيها.

بمجرد حفظ الإعدادات، سيكتمل إعداد التكامل.

إنشاء رابط دفع

لإنشاء رابط دفع، استخدم الدالة التالية:

get_paytabs_payment_url(amount, description, currency, customer_email, customer_phone, full_name, language)

معلمات الدالة

المعلمة	الوصف
! amount	مبلغ الدفع. معلمة مطلوبة
description	وصف الدفع. معلمة اختيارية
currency	عملة الدفع. معلمة اختيارية
customer_email	عنوان البريد الإلكتروني للعميل. معلمة اختيارية
customer_phone	رقم هاتف العميل. معلمة اختيارية
full_name	الاسم الكامل للعميل. معلمة اختيارية
language	لغة صفحة الدفع. معلمة اختيارية

العملات المتاحة

رموز العملات التالية مدعومة:

SAR, AED, BHD, EGP, EUR, GBP, HKD, IDR,INR, IQD, JOD, JPY, KWD, MAD, OMR,PKR, QAR, USD

اللغات المتاحة

en — الإنجليزيةar — العربيةfr — الفرنسية

تُرجع الدالة رابط URL للدفع.

إذا لم يتم توفير المعلمة currency فسيتم اختيار العملة تلقائيًا بناءً على المنطقة المُهيأة.

استخدام رابط الدفع في زر

لإرسال زر دفع إلى العميل:

1. أنشئ زرًا من النوع الدفع النوع

2. اختر PayTabs كمزوّد الدفع

3. حدّد:

   • وصف الدفع؛

   • مبلغ الدفع؛

   • العملة.

---

معالجة حالة الدفع

بعد أن يفتح العميل رابط الدفع ويُكمل الدفع، سيتم إرسال حدث callback إلى المحادثة.

دفعة ناجحة

مثال:

SDJ91MTKTT_success 100

حيث:

• SDJ91MTKTT — أول 10 أحرف من مفتاح الخادم

• 100 — مبلغ الدفع

لإنشاء إجراء لعملية دفع ناجحة، انتقل إلى المنشئ وأنشئ كتلة تحتوي على مُشغّل (يمكن أن تكون كتلة بدء أو كتلة مُشغّل ).

ثم، في الحقل مُشغّل ، أدخل:

• قيمة callback الكاملة (إذا كنت تريد تشغيل الإجراء فقط لمبلغ دفع محدد)، أو

• فقط قيمة callback قبل مبلغ الدفع (إذا كنت تريد تشغيل الإجراء لجميع المدفوعات الناجحة).

كتلة "بدء"

كتلة "المُشغّل"

دفعة فاشلة

مثال:

SDJ91MTKTT_fail 100

تتم تهيئة معالجة الدفع الفاشل بالطريقة نفسها التي تتم بها تهيئة معالجة الدفع الناجح.

أنشئ كتلة تحتوي على مُشغّل وأدخل قيمة callback في الحقل مُشغّل يتيح لك هذا تحديد الإجراءات التي سيتم تنفيذها عند فشل الدفع.

المتغيرات المحفوظة بعد إتمام الدفع بنجاح

بعد إتمام الدفع بنجاح، يتم حفظ المتغيرات التالية تلقائيًا للعميل:

paytabs_callback_data يحتوي على حمولة webhook الكاملة المستلمة من نظام الدفع.

paytabs_payment_completed

القيمة:

صحيح

يشير إلى أن الدفع قد اكتمل بنجاح.