لاستخدام كليپ في MaviBot، تحتاج إلى إنشاء زوج من بيانات الاعتماد في حسابك في كليپ وإدخالها في إعدادات نظام الدفع.
كليپ هي خدمة دفع مكسيكية.
الحصول على بيانات الاعتماد
وقع اتفاقية مع كليپ واحصل على الوصول إلى لوحة تحكم المطور في حسابك في كليپ.
في قسم بيانات الاعتماد، انقر على Crear credencial (إنشاء بيانات اعتماد)، وأدخل اسمًا، وأكد الإنشاء.
انسخ بيانات الاعتماد التالية:
- مفتاح API
- المفتاح السري (Clave secreta)
مهم! يتم عرض المفتاح السري مرة واحدة فقط، مباشرة بعد إنشاء بيانات الاعتماد. احفظه في مكان آمن. لا يمكنك عرضه مرة أخرى في حسابك في كليپ. إذا فقدته، ستحتاج إلى إنشاء زوج جديد من بيانات الاعتماد.
يتم إنشاء بيانات الاعتماد بشكل منفصل لبيئات الإنتاج والاختبار. يمكنك إنشاء ما يصل إلى 6 تطبيقات لكل حساب.
لاختبار التكامل، قم بإنشاء زوج اختبار من بيانات الاعتماد. لقبول المدفوعات الحقيقية، استخدم بيانات اعتماد الإنتاج.
لا تحتاج إلى تكوين عنوان URL لإشعار الدفع في حسابك في كليپ. يرسل MaviBot تلقائيًا عنوان URL للإشعار عند إنشاء كل دفعة.
ربط كليپ
في علامة التبويب الاستحواذ، حدد كليپ وأدخل:
| الحقل | الوصف |
|---|---|
| مفتاح API | معرف التطبيق. |
| المفتاح السري (Clave secreta) | المفتاح السري للتطبيق. |
اكتمل الاتصال الآن.
إنشاء رابط دفع
استخدم دالة الآلة الحاسبة التالية:
get_clip_payment_url(amount, description, currency, customer_email, customer_phone, full_name, product_name, language)
المعاملات
| المعامل | الوصف |
|---|---|
amount |
مبلغ الدفع. مطلوب. الحد الأدنى للمبلغ هو 1 بوحدة العملة الرئيسية. حدد المبلغ كـ 100.55، وليس 10055. |
description |
وصف الدفع. اختياري. الحد الأقصى للطول: 250 حرفًا. يمكن للعميل رؤيته على صفحة الدفع والإيصال. |
currency |
رمز العملة المكون من ثلاثة أحرف (MXN والعملات الأخرى المتاحة لحسابك في كليپ). اختياري. الافتراضي: MXN. |
customer_email |
عنوان البريد الإلكتروني للعميل. اختياري. يتم إدراجه تلقائيًا في نموذج الدفع. |
customer_phone |
رقم هاتف العميل. اختياري. يتم إدراجه تلقائيًا في نموذج الدفع. |
full_name |
اسم العميل. اختياري. يتم إدراجه تلقائيًا في نموذج الدفع. |
product_name |
اسم المنتج. اختياري. |
language |
لغة صفحة الدفع: es للإسبانية (الافتراضي) أو en للإنجليزية. |
ترجع الدالة عنوان URL للدفع.
زر رابط الدفع
لإرسال زر دفع إلى العميل:
- أنشئ زرًا باستخدام وظيفة الدفع.
- حدد كليپ كنظام دفع.
- حدد اسم المنتج والمبلغ والعملة.
- إذا لزم الأمر، حدد المتغيرات التي تحتوي على اسم العميل وعنوان بريده الإلكتروني ورقم هاتفه.
استدعاءات الدفع
بعد أن يتبع العميل رابط الدفع ويكمل الدفع، يتلقى MaviBot استدعاءً.
دفع ناجح
مثال:
SDJ91MTKTT_success 100.55
حيث:
-
SDJ91MTKTT— أول 10 أحرف من مفتاح API الخاص بك. -
100.55— مبلغ الدفع.
دفع فاشل
إذا كان الدفع غير ناجح، يتم إرسال الاستدعاء التالي:
SDJ91MTKTT_fail 100.55
مهم! يتم إرسال استدعاء الدفع الفاشل فقط بعد إغلاق رابط الدفع بشكل دائم: بعد 5 محاولات دفع غير ناجحة أو عند انتهاء صلاحية الرابط.
طالما أن العميل لا يزال لديه محاولات دفع متاحة، يظل الرابط نشطًا ولا يتم إرسال استدعاء الدفع الفاشل.
متغيرات العميل بعد الدفع الناجح
| المتغير | الوصف |
|---|---|
clip_callback_data |
معلومات الدفع المستلمة من نظام الدفع كليپ. |
clip_payment_completed |
"True" إذا تمت معالجة الدفع بنجاح. |
clip_payment_request_id |
معرف رابط الدفع في كليپ. |
clip_receipt_no |
رقم إيصال كليپ. |