لاستخدام منصة الدفع EBANX في Mavibot، يجب الحصول على مفتاح التكامل الخاص بك من حساب EBANX وإدخاله في إعدادات الدفع.

EBANX هو مجمع لطرق الدفع المحلية في جميع أنحاء أمريكا اللاتينية. تتم معالجة المدفوعات على صفحة دفع آمنة تستضيفها EBANX، حيث يتم عرض طرق الدفع المتاحة في بلد العميل (مثل PIX و boleto في البرازيل، OXXO و SPEI في المكسيك، PSE في كولومبيا، بطاقات الائتمان/الخصم، والمزيد).

الحصول على مفتاح التكامل

قم بتوقيع اتفاقية مع EBANX واحصل على حق الوصول إلى بوابة أعمال EBANX (لوحة التحكم الخاصة بالتاجر).

أثناء عملية الإعداد، حدد البلدان التي ترغب في قبول المدفوعات منها. سيتمكن العملاء من الدفع فقط من البلدان الممكّنة في حساب EBANX الخاص بك.

في إعدادات التكامل، انسخ مفتاح التكامل الخاص بك. ستحتاج إليه لتوصيل EBANX بـ Mavibot.

لأغراض الاختبار، توفر EBANX حساب اختبار منفصل بمفتاح التكامل الخاص به. راجع وضع الاختبار أدناه.

توصيل EBANX

في إعدادات أنظمة الدفع، حدد EBANX وأدخل ما يلي:

  • مفتاح التكامل — مفتاح تكامل EBANX الذي قمت بنسخه.
  • البلد — بلد الدفع الافتراضي (رمز البلد المكون من حرفين صغيرين: br للبرازيل، mx للمكسيك، co لكولومبيا، cl لتشيلي، pe لبيرو، ar للأرجنتين، إلخ). يحدد هذا طرق الدفع التي سيراها العملاء على صفحة الدفع. يجب أن يكون البلد المحدد ممكّنًا في حساب EBANX الخاص بك.
  • وضع الاختبار — قم بتمكين هذا الخيار لاختبار التكامل باستخدام بيئة الاختبار لـ EBANX. عند تمكين وضع الاختبار، استخدم مفتاح التكامل من حساب الاختبار الخاص بك. لقبول المدفوعات الحقيقية، قم بتعطيل وضع الاختبار واستخدم مفتاح التكامل المباشر الخاص بك.

اكتمل الإعداد الآن.

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

وظيفة الآلة الحاسبة:

get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)

المعلمات

  • amount — مبلغ الدفع. مطلوب.

  • customer_email — عنوان البريد الإلكتروني للعميل. مطلوب. لا يمكن لـ EBANX إنشاء دفعة بدونه. سيتلقى العميل أيضًا تأكيد الدفع على عنوان البريد الإلكتروني هذا.

  • full_name — الاسم الكامل للعميل. مطلوب.

  • description — وصف الدفع. اختياري.

  • currency — عملة الدفع. يمكنك استخدام:

    • العملة المحلية لبلد الدفع (مثل BRL، MXN، COP، CLP، PEN، ARS، إلخ)، أو
    • عملة حساب EBANX الخاص بك (عادةً USD)، وفي هذه الحالة ستقوم EBANX بتحويل المبلغ باستخدام سعر الصرف الخاص بها.

    اختياري. القيمة الافتراضية هي USD.

  • country — بلد الدفع (رمز البلد المكون من حرفين صغيرين). اختياري. إذا تم حذفه، سيتم استخدام البلد الافتراضي المحدد في إعدادات الدفع.

تقوم الوظيفة بإرجاع رابط الدفع.

ملاحظة: يجب أن تكون العملة المحددة متوافقة مع بلد الدفع. يجب أن تكون إما العملة المحلية للبلد أو عملة حساب EBANX الخاص بك. على سبيل المثال، بالنسبة لـ br (البرازيل)، BRL و USD صالحان، بينما MXN غير صالح.

زر رابط الدفع

لإرسال زر دفع، حدد نوع زر الدفع واختر EBANX كنظام دفع.

أدخل:

  • اسم المنتج؛
  • مبلغ الدفع؛
  • العملة؛
  • المتغيرات التي تحتوي على الاسم الكامل للعميل وعنوان بريده الإلكتروني.

اختياريًا، حدد بلد الدفع.

مثال 1: تكوين سير العمل

الخطوة 1. أنشئ كتلة بداية.

كتلة البداية تُستخدم عادةً لعرض أول رسالة ترحيبية في سير العمل، إلى جانب أي معلومات تمهيدية يحتاجها المستخدم.

الخطوة 2. أنشئ الكتلة الموضحة أدناه.

الخطوة 3. انتقل إلى إعدادات الاتصال.

ستحتاج إلى التعبير النمطي التالي للتحقق من أن العميل قد أدخل عنوان بريد إلكتروني صالح:

^[-\w.]+@([A-z0-9][-A-z0-9]+.)+[A-z]{2,4}$

أيضًا، قم بتمكين خيار يدخل المستخدم البيانات وأدخل customer_email.

الخطوة 4. أدخل الرسالة في الكتلة الثانية.

الخطوة 5. أنشئ كتلة ثالثة وافتح إعدادات الاتصال بين الكتلتين الثانية والثالثة.

قم بتمكين المؤقت للانتقال تلقائيًا إلى الكتلة التالية.

الخطوة 6. في الكتلة الثالثة، أدخل الوظيفة في الآلة الحاسبة.

مثال للنسخ:

amount = 1000
description = "Product1 is product of great reliability!"
currency = "BRL"
link = get_ebanx_payment_url(amount, description, currency, customer_email, full_name, country)

إذا كنت ترغب في قبول المدفوعات بعملة غير USD، فحدد العملة كما هو موضح أدناه.

مثال 2. زر الفوترة

هذا المثال مطابق تقريبًا لـ المثال 1.

ومع ذلك، بدلاً من إنشاء كتلة ثالثة بوظيفة لإنشاء رابط الدفع، يمكنك إنشاء زر في الكتلة الثانية.

في النافذة التي تفتح:

  • أدخل نص الزر.
  • حدد وظيفة الفوترة.
  • حدد EBANX كمزود الدفع.

ثم أدخل ما يلي:

  • اسم المنتج.
  • مبلغ الدفع.
  • العملة (اختياري).
  • الاسم الكامل للعميل (اختياري). يمكنك تكوينه بنفس طريقة تكوين إدخال البريد الإلكتروني للعميل.
  • البريد الإلكتروني للعميل — أدخل المتغير #{customer_email}.

ثم انقر فوق إضافة.

الإشعارات بعد الدفع

بعد أن يفتح العميل رابط الدفع ويكمل الدفع، يتم إرسال رد الاتصال التالي إلى المحادثة عند نجاح الدفع:

SDJ91MTKTT_success 100

حيث:

  • SDJ91MTKTT هي أول 10 أحرف من مفتاح التكامل الخاص بك.
  • 100 هو مبلغ الدفع.

إذا تم إلغاء الدفع، يتم إرسال رد الاتصال التالي:

SDJ91MTKTT_fail 100

بالنسبة لطرق الدفع غير المتصلة بالإنترنت (مثل boleto، OXXO، إلخ)، لا يكون تأكيد الدفع فوريًا. ترسل EBANX رد الاتصال فقط بعد استلام الأموال، وقد يستغرق ذلك من 1 إلى 3 أيام عمل. سيتم تسليم رد الاتصال تلقائيًا بمجرد تأكيد الدفع.

كيفية إرسال رد على دفعة ناجحة أو فاشلة

الخطوة 1. أنشئ كتلة مشغل.

الخطوة 2. في حقل الشرط، أدخل نص الإشعار SDJ91MTKTT_success — بدون مبلغ الدفع — إذا كنت تريد التفاعل مع كل دفعة.

في هذه الحالة، يجب ضبط نوع المطابقة على بالكلمات المفتاحية.

بدلاً من ذلك، أدخل نص رد الاتصال بالكامل في حقل المشغل إذا كنت تريد التفاعل مع دفعة محددة. في هذه الحالة، يجب ضبط نوع المطابقة على المطابقة التامة.

إذا كنت ترغب في متابعة سير العمل بعد دفعة ناجحة، يمكنك إنشاء كتلة بداية بدلاً من كتلة مشغل ومواصلة بناء تدفق البوت الخاص بك من هناك.

متغيرات العميل بعد الدفع الناجح

المتغير القيمة
ebanx_callback_data معلومات الدفع المستلمة من نظام الدفع
ebanx_payment_completed "True" — تمت معالجة الدفع بنجاح
ebanx_payment_hash معرف الدفع في EBANX (hash)