زر وظيفة الدفع يبسط العمل مع أنظمة الدفع المتصلة من خلال توفير رابط دفع.
صورة
يرجى ملاحظة أنه في العديد من تطبيقات المراسلة، يمكن وضع الروابط فقط في الأزرار المضمنة داخل النص. لا تنسَ تحديد نوع الزر المناسب في إعدادات الكتلة بعد إنشاء الزر.
زر وظيفة الدفع متاح لأنظمة الدفع التالية:
- Stripe
ضمن كتلة واحدة، يمكنك إنشاء أزرار "دفع" لأنظمة دفع مختلفة بمبالغ دفع مختلفة.
إذا لم تكن أي أنظمة دفع متصلة بالمشروع، فلن يكون هذا النوع من الأزرار متاحًا.
صورة
الحقول الرئيسية لزر الدفع:
- حقل النص: سيظهر هذا النص على الزر مع رابط الدفع في الرسالة.
- الوظيفة: حدد نوع الزر دفع.
- حقل الوظيفة: لإنشاء زر يوفر رابط دفع، اختر وظيفة الدفع.
- حقل نظام الدفع: تعرض القائمة أنظمة الدفع المتصلة بالمشروع.
اعتمادًا على نظام الدفع المختار، ستختلف الحقول المطلوبة لإنشاء الرابط وإنشاء الإيصال.
يمكنك عرض إعدادات زر وظيفة الدفع لأنظمة الدفع المختلفة هنا:
الحقول المطلوبة لإنشاء رابط الدفع هي المبلغ و اسم المنتج/وصف المنتج.
- حقل المبلغ: أدخل مبلغ الدفع هنا.
- حقل اسم المنتج: أدخل اسم المنتج الذي سيظهر على صفحة الدفع.
لا يمكن استخدام علامات الاقتباس المزدوجة في اسم المنتج.
يمكنك استبدالها بعلامات اقتباس مفردة أو فواصل عليا.
اعتمادًا على نظام الدفع المختار، ستظهر قوائم منسدلة بعنوان "بيانات الإيصال" و/أو "معلومات إضافية" في إعدادات الزر. النقر عليها سيكشف عن حقول إضافية:
صورة
المتغيرات عند استخدام زر وظيفة الدفع
بمجرد أن يتلقى المستخدم الكتلة التي تحتوي على زر "الدفع"، يتم إنشاء متغيرات العميل التالية تلقائيًا:
-
متغير العميل النظامي
__payments– يخزن هذا المتغير مبلغ الدفع ومعرف رابط الدفع الذي تم إنشاؤه. يُستخدم لتحديد استجابة webhook من نظام الدفع.
يجب عدم حذف أو تعديل متغير العميل النظامي __payments!
يتم إنشاء متغير العميل error_payment_button في حالة حدوث خطأ أثناء إنشاء زر الدفع.
ستحتوي قيمته إما على رسالة الخطأ أو استجابة الخطأ التي أرجعها نظام الدفع.
تصبح قيم المتغيرات نشطة (محدثة) عندما ينتقل المستخدم إلى الكتلة التالية.
كيفية التعامل مع النتيجة
الدفع الناجح
بعد الدفع الناجح، سيتلقى البوت رد اتصال يتكون من أول 10 أحرف من المفتاح السري لنظام الدفع، وكلمة _success، ومبلغ الدفع مفصولة بمسافة. على سبيل المثال: ovg58keefc_success 44، حيث:
-
ovg58keefc: أول 10 أحرف من المفتاح السري لنظام الدفع -
_success: يشير إلى نتيجة الطلب (دفع ناجح) -
44: مبلغ الدفع
ردود الاتصال (الإشعارات) من نظام الدفع غير مرئية للمستخدم. تظهر فقط في علامة التبويب العملاء وتكون مرئية للمشغل.
مثال على الاستخدام: الخطوة 1. في الكتلة التي تحتوي على زر الدفع، أضف أزرارًا بوظيفة الدفع. الخطوة 2. في حقل شرط الاتصال من هذه الكتلة إلى كتلة الدفع الناجح، حدد رد الاتصال. يعمل هذا بنفس الطريقة إذا قمت بتحديد رد اتصال الدفع الناجح في حقل الشرط لكتلة فحص الشرط الأساسي.
ملاحظة! اختيار نوع المطابقة — مطابقة تامة أو مطابقة كلمة مفتاحية.
نصيحة مفيدة
لإرسال إشعار حول الدفع الناجح إلى العميل دون مقاطعة تقدمه عبر المسار الرئيسي، قم بإنشاء "كتل غير حالة مع شروط."
الدفع مع خطأ
إذا حدث خطأ في الدفع، سيتلقى البوت رد اتصال يتكون من أول 10 أحرف من المفتاح السري لنظام الدفع، وكلمة _fail، ومبلغ الدفع مفصولة بمسافة. على سبيل المثال: ovg58keefc_fail 44، حيث:
-
ovg58keefc: أول 10 أحرف من المفتاح السري لنظام الدفع -
_fail: نتيجة معالجة الطلب — فشل الدفع أو واجه خطأ -
44: مبلغ الدفع
هذا يعتمد على نظام الدفع. ليست كل أنظمة الدفع ترسل رد اتصال لأخطاء الدفع.
إذا كان المبلغ المحدد في إعدادات الزر يختلف عن المبلغ الذي دفعه العميل فعليًا، سيتلقى البوت رد اتصال يتكون من أول 10 أحرف من المفتاح السري لنظام الدفع، والعبارة _different_amounts، ومعرف دفع فريد مفصولة بمسافة. على سبيل المثال: ovg58keefc_different_amounts 123456، حيث:
-
ovg58keefc: أول 10 أحرف من المفتاح السري لنظام الدفع -
_different_amounts: نتيجة معالجة الطلب (مبلغ الدفع يختلف عن المبلغ في الرابط) -
123456: معرف دفع فريد