- التسجيل السريع وتأكيد التاجر
- تسجيل التاجر للأفراد بدون موقع إلكتروني
- نسبة موحدة للأفراد والكيانات القانونية – 2.5%
- توفر Google Play و Apple Pay
كيفية الاتصال
لاتصال بنظام الدفع Wayforpay، ستحتاج إلى 3 قيم:
- اسم المستخدم للتاجر
- المفتاح السري للتاجر
- اسم نطاق موقع التاجر.
انتقل إلى حسابك الشخصي -> إعدادات المتجر https://m.wayforpay.com/mportal/merchant/list
انسخ البيانات وانتقل إلى الإعدادات في Mavibot.
افتح قسم "Acquiring"، واختر 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 الذي يحتوي على رابط (على سبيل المثال، رابط في النص):
سيعمل البوت على النحو التالي:
كيفية معالجة النتيجة
بعد الدفع الناجح، سيتم إرسال ردود الاتصال إلى البوت، والتي ستخبرك بأن الدفع كان ناجحًا. ترى هذه الردود في النظام كرسائل من المستخدم، بحيث لا يمكن للمستخدم إرسالها، فهي تتكون من أول 10 أحرف من المفتاح السري واللاحقة _success، على سبيل المثال: flk3409ref_success
هذه الردود غير مرئية للمستخدم، يتم عرضها فقط للمشغل.
يجب أن يكون نوع المقارنة "مطابقة تامة"
أيضًا، بعد الدفع الناجح، يتم تعيين المتغير wayforpay_payment_completed إلى True.
على سبيل المثال، يمكنك معالجة الدفع الناجح في كتلة شرطية وعرض الرسالة المناسبة للمستخدم:
إذا كنت لا ترغب في إخراج العميل من مخطط البوت الرئيسي، استخدم كتلة "Non state with a condition". لا يمكن الدخول إلى هذه الكتلة، لذلك لن يتم إخراج العميل من المسار الرئيسي بعد الدفع وسيتلقى إشعارًا بالدفع الناجح.
وإذا كنت بحاجة إلى متابعة المسار مع رد فعل على الدفع الناجح، فاستخدم كتلة "Start condition"، عندها سينتقل العميل من كتلة الدفع إلى كتلة "Start 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) - ينشئ رابطًا للدفع المتكرر.
إلغاء الدفع المتكرر
wayforpay_delete_recurrent() - يلغي المدفوعات الآلية المستقبلية للعميل. يُرجع "Ok" عند التنفيذ الناجح.
يمكنك أيضًا استخدام كتل "Starting trigger" و "State" (المثال يستخدم كتل "Non-state with condition" و "Non-state").
إذا كنت لا ترغب في إزالة العميل من تدفق البوت الرئيسي، استخدم كتلة "Non-state with condition" — لا يمكن الدخول إلى هذه الكتلة يدويًا، لذلك سيبقى العميل في المسار الرئيسي بعد الدفع مع تلقي إشعار بالدفع الناجح.
إذا كنت بحاجة إلى متابعة المسار بناءً على الدفع الناجح، استخدم كتلة "Starting trigger". في هذه الحالة، سينتقل العميل من كتلة الدفع إلى كتلة "Starting trigger condition"، حيث يمكنك متابعة المسار.