Wayforpay
التسجيل السريع وتأكيد التاجر
تسجيل التاجر للأفراد الذين لا يملكون موقعًا إلكترونيًا
نسبة موحّدة للأفراد والكيانات القانونية – 2.5%
إتاحة Google Play و ApplePay
كيفية الربط
لربط نظام الدفع wayforpay، ستحتاج إلى 3 قيم:
اسم دخول التاجر
المفتاح السري للتاجر
اسم نطاق موقع التاجر الإلكتروني.
انتقل إلى حسابك الشخصي -> إعدادات المتجر https://m.wayforpay.com/mportal/merchant/list
انسخ البيانات وانتقل إلى الإعدادات في Mavibot.
افتح قسم "التحصيل"، واختر wayforpay.
تحتاج إلى إدخال البيانات المستلمة في النموذج الذي يفتح:
لإنشاء رابط دفع، تحتاج إلى تعيين قيمة payment_sum متغير (على سبيل المثال، 150 أو 100.55، وإذا كان المبلغ كسريًا، فيُفصل المبلغ بنقطة):
مباشرة بعد ذلك، سيظهر المتغير wayforpay_pay_url هذا المتغير. يمكن عرض هذا المتغير في الرسالة مع رابط أو وضعه على الزر بالنص "Pay":
الخيار 1. رابط الدفع في الزر:
الخيار 2. رابط الدفع موجود في حقل url الخاص بالمرفق:
يبدو الرابط كما يلي:
https://secure.wayforpay.com/invoice/id1bbb2ad0375
افتراضيًا، USD (دولارات) مُعيّن، وإذا كنت بحاجة إلى عملة أخرى، فعليك ضبط قيمة متغير العملة.
كذلك، قبل تعيين قيمة payment_sum المتغير، يمكنك تعيين المتغيرات الاختيارية التالية لتكوين الدفع.
currency - هي العملة الافتراضية للطلب، UAH (القيم الممكنة هي USD وEUR وRUB)
session_timeout - مدة صلاحية الرابط بالثواني، والقيمة الافتراضية هي 3600 (ساعة واحدة)
product_name - اسم المنتج
language - لغة صفحة الدفع، والقيمة الافتراضية هي UA (القيم الممكنة هي RU وEN) buyer_name - اسم العميل
buyer_email - بريد العميل الإلكتروني
buyer_first_name - اسم العميل
buyer_last_name - اسم عائلة العميل
هكذا يكون لدى صفحة الدفع رابط.
لننشئ رابطًا للدفع بمبلغ 1 USD وبمدة صلاحية ساعتين:
انتبه: - أولًا، حدّد المعلمات الاختيارية product_name إلخ. - وأخيرًا، عيّن قيمة الـ payment_sum .
يرجى ملاحظة أننا نضبط أولًا المتغيرات للإعدادات، ثم payment_sum. يمكن ضبط المتغيرات في وقت أبكر ضمن السلسلة، وليس في كتلة واحدة، وهذا مثال.
بعد ذلك، في الكتلة التالية، نعرض wayforpay_pay_url المتغير، الذي يحتوي على رابط (على سبيل المثال، رابط في النص):
سيعمل الروبوت على النحو التالي:
كيفية معالجة النتيجة
بعد نجاح الدفع، سيتم إرسال callbacks إلى البوت، والتي ستُعلمك بأن الدفع قد تم بنجاح. سترى هذه callbacks في النظام كرسائل من المستخدم، حتى لا يتمكن المستخدم من إرسالها، وهي تتكون من أول 10 أحرف من المفتاح السري واللاحقة _success، على سبيل المثال: flk3409ref_success
هذه callbacks غير مرئية للمستخدم، وتُعرض فقط للمشغّل.
يجب أن يكون نوع المقارنة "Complete Match"
كما أنه بعد نجاح الدفع، يتم تعيين المتغير wayforpay_payment_completed إلى True.
على سبيل المثال، يمكنك معالجة الدفع الناجح داخل كتلة شرطية وعرض الرسالة المناسبة للمستخدم:
إذا كنت لا تريد إخراج العميل من المخطط الرئيسي للـ chatbot، فاستخدم كتلة "Non state with a condition". لا يمكنك الانتقال إلى هذه الكتلة، لذلك لن يتم إخراج العميل من المسار الرئيسي بعد الدفع وسيتلقى إشعارًا بنجاح الدفع.
وإذا كنت بحاجة إلى متابعة القمع مع تفاعل على الدفع الناجح، فاستخدم كتلة "شرط البدء"، ثم سينتقل العميل من كتلة الدفع إلى كتلة "شرط البدء"، ومن خلالها يمكنك متابعة القمع.
تتوفر معلومات أكثر عن الكتل الشرطية في المقال الذي يحمل الاسم نفسه
بعد إكمال الدفع، ستتم إضافة المتغير wayforpay_callback_data سيتم إضافة متغير إلى العميل يحتوي على بيانات استجابة نظام الدفع للمعاملة المكتملة. يمكنك استخراج البيانات المطلوبة من القاموس الناتج باستخدام get .
دوال للعمل مع الحاسبة
للدفعات المتكررة
wayforpay_recurrent_payment(amount, currency, session_timeout, product_name, language, buyer_name, buyer_email, regular_date_next, regular_date_end, regular_count, regular_mode) - ينشئ رابطًا لدفع متكرر.
amount
مبلغ الدفع
currency
العملة. الافتراضي: UAH (القيم الممكنة: USD، EUR، RUB). معلمة اختيارية.
session_timeout
مدة صلاحية الرابط بالثواني. الافتراضي: 3600 (ساعة واحدة). معلمة اختيارية.
product_name
اسم المنتج. معلمة اختيارية.
language
لغة صفحة الدفع. الافتراضي: UA (القيم الممكنة: RU، EN). معلمة اختيارية.
buyer_name
اسم العميل. اسم اختياري.
buyer_email
بريد العميل الإلكتروني. معلمة اختيارية.
regular_date_next
تاريخ المعاملة الآلية التالية. الافتراضي: بعد شهر واحد من إنشاء الرابط. معلمة اختيارية.
regular_date_end
تاريخ انتهاء المعاملة الآلية. الافتراضي: بعد سنة واحدة من إنشاء الرابط. يمكن حذفها إذا تم تحديد المعلمة regular_count. معلمة اختيارية.
regular_count
عدد المعاملات الآلية. إذا تم تحديده، فسيتم تجاهل المعلمة regular_date_end. معلمة اختيارية.
regular_mode
فترة الدفع المتكرر. معلمة اختيارية. القيم الممكنة: - once - دفعة لمرة واحدة - daily - يوميًا - weekly - أسبوعيًا - quarterly - كل 3 أشهر بعد تاريخ أول دفعة - monthly - شهريًا - bimonthly - مرة كل شهرين - halfyearly - مرة كل 6 أشهر - yearly - مرة كل سنة
إلغاء الدفع المتكرر
wayforpay_delete_recurrent() - يلغي الدفعات التلقائية المستقبلية للعميل. يعيد "Ok" عند التنفيذ بنجاح.
يمكنك أيضًا استخدام كتلتي "Starting trigger" و"State" (يستخدم المثال كتلتي "Non-state with condition" و"Non-state").
إذا كنت لا تريد إزالة العميل من مسار الـ chatbot الرئيسي، فاستخدم كتلة "Non-state with condition" — لا يمكن الدخول إلى هذه الكتلة يدويًا، لذلك سيبقى العميل في المسار الرئيسي بعد الدفع مع تلقي إشعار بنجاح الدفع.
إذا كنت بحاجة إلى متابعة المسار بناءً على نجاح الدفع، فاستخدم كتلة "Starting trigger". في هذه الحالة، سينتقل العميل من كتلة الدفع إلى كتلة "Starting trigger condition"، ومنها يمكنك متابعة المسار.
آخر تحديث