ربط PayTabs بـ Mavibot
لربط PayTabs مع Mavibot، تحتاج إلى تكوين عدة إعدادات في حساب PayTabs الخاص بك.
1. إنشاء مفتاح API
في لوحة تحكم PayTabs، انتقل إلى:
المطورون ← مفاتيح API
أنشئ مفتاح API جديد.
بعد إنشاء مفتاح API، احفظ التفاصيل التالية:
- مفتاح الخادم — مطلوب لإعداد التكامل.
- معرف الملف الشخصي — مطلوب أيضًا لإعداد الاتصال.
2. تكوين إشعارات الدفع
انتقل إلى:
المطورون ← التكوين
قم بتمكين إشعارات الدفع (الاستدعاءات).
انقر على "+" وأضف عنوان URL للاستدعاء التالي:
https://chatter.mavibot.ai/paytabs_callback/result
يُستخدم عنوان URL هذا لإرسال تحديثات حالة الدفع إلى Mavibot.
3. تكوين PayTabs في Mavibot
في إعدادات Mavibot:
- انتقل إلى قسم الاستحواذ
- اختر PayTabs كمزود الدفع
- أدخل التفاصيل التالية:
- معرف الملف الشخصي
- مفتاح الخادم
- اختر منطقة حساب 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 — الفرنسية
تقوم الوظيفة بإرجاع رابط الدفع.
إذا لم يتم توفير معامل currency، فسيتم اختيار العملة تلقائيًا بناءً على المنطقة المكونة.
استخدام رابط الدفع في زر
لإرسال زر دفع إلى عميل:
- أنشئ زرًا من نوع الدفع
- اختر PayTabs كمزود الدفع
- حدد:
- وصف الدفع؛
- مبلغ الدفع؛
- العملة.
معالجة حالة الدفع
بعد أن يفتح العميل رابط الدفع ويكمل الدفع، سيتم إرسال حدث استدعاء إلى المحادثة.
الدفع الناجح
مثال:
SDJ91MTKTT_success 100
حيث:
- SDJ91MTKTT — أول 10 أحرف من مفتاح الخادم
- 100 — مبلغ الدفع
لإنشاء إجراء للدفع الناجح، انتقل إلى المنشئ وأنشئ كتلة بمشغل (يمكن أن تكون كتلة بداية أو كتلة مشغل).
ثم، في حقل المشغل، أدخل:
- قيمة الاستدعاء الكاملة (إذا كنت تريد تشغيل الإجراء لمبلغ دفع محدد فقط)، أو
- قيمة الاستدعاء فقط قبل مبلغ الدفع (إذا كنت تريد تشغيل الإجراء لجميع المدفوعات الناجحة).
الدفع الفاشل
مثال:
SDJ91MTKTT_fail 100
يتم تكوين معالجة الدفع الفاشل بنفس طريقة معالجة الدفع الناجح.
أنشئ كتلة بمشغل وأدخل قيمة الاستدعاء في حقل المشغل. يتيح لك ذلك تحديد الإجراءات التي سيتم تنفيذها عند فشل الدفع.
المتغيرات المحفوظة بعد الدفع الناجح
بعد الدفع الناجح، يتم حفظ المتغيرات التالية تلقائيًا للعميل:
paytabs_callback_data
يحتوي على حمولة webhook الكاملة المستلمة من نظام الدفع.
paytabs_payment_completed
القيمة:
True
تشير إلى أن الدفع قد اكتمل بنجاح.