كيفية إعداد PayPal
للعمل مع PayPal، تحتاج إلى الحصول على مفتاحين: client_id و secret
انتقل إلى الصفحة https://developer.paypal.com/developer/applications/
واختر من القائمة أو أنشئ تطبيقًا جديدًا:
في الأعلى، قم بتغيير المفتاح إلى وضع Live واختر التطبيق الذي تريده. سيتم فتح صفحة تحتوي على الإعدادات حيث يمكنك العثور على البيانات المطلوبة:
انسخ البيانات والصقها في الحقول المقابلة في إعدادات Mavibot - أنظمة الدفع - PayPal:
بهذا ينتهي الاتصال.
كيفية إنشاء رابط دفع
لإنشاء رابط دفع، تحتاج إلى تعيين قيمة المتغير payment_sum وسيظهر المتغير paypal_pay_url فورًا.
المتغير payment_title ليس إلزاميًا، وهو اسم المنتج. إذا لم تحدده، سيتم ملؤه بالنص: "طلب دفع account order_id" (order_id - معرف الطلب في الخادم)
المتغير payment_description - وصف المنتج، اختياري
بالإضافة إلى ذلك، قبل تحديد payment_sum، يمكنك تحديد اللغة التي ستظهر بها صفحة الدفع. للقيام بذلك، تحتاج إلى تعيين المتغير locale، الافتراضي هو الروسية (ru-RU). جميع الخيارات الممكنة: da-DK, he-IL, id-ID, ja-JP, no-NO, pt-BR, ru-RU, sv-SE, th-TH, zh-CN, zh-HK, zh-TW.
والمعامل الإضافي الثالث هو company_name - اسم شركتك، يظهر في أعلى الصفحة (مثال أدناه، company).
يمكنك أيضًا تحديد العملة التي يتم بها قبول الدفع، لذلك نحدد المتغير currency، الافتراضي هو الروبل (RUB)، للدولار حدد قيمته USD (currency = USD). يمكن العثور على أنواع العملات الممكنة تحت الرابط https://developer.paypal.com/docs/api/reference/currency-codes/
والمعامل الإضافي الثالث هو company_name - اسم شركتك، يظهر في أعلى الصفحة (مثال أدناه، company)
يمكن عرض المتغير paypal_pay_url كرابط أو وضعه على زر "دفع".
الرابط يكون بالشكل: https://ww.paypal.com/checkoutnow?token=07N53571YM296381N
مثال على التنفيذ.
حدد مبلغ الدفع 444 واسم الشركة
ملاحظة: يتم تعيين المتغير payment_sum كآخر متغير، بعد المتغيرات الاختيارية payment_title، company_name، إلخ.
كيفية معالجة النتيجة
بعد الدفع الناجح، سيصل إلى البوت استجابات (callbacks) يمكنك من خلالها فهم أن الدفع تم بنجاح. ترى هذه الاستجابات في النظام كرسائل من المستخدم، بحيث لا يمكن للمستخدم إرسالها، وتتكون من أول 10 رموز سرية وصفحة رئيسية مع الحالة، على سبيل المثال: EHsWHYOoWV_success.
أيضًا، بعد الدفع الناجح، يتم تعيين المتغير paypal_payment_completed إلى True.
هذه الاستجابات غير مرئية للمستخدم، بل تظهر فقط للمشغل.
يجب أن يكون نوع المقارنة "مطابقة تامة"
لإجراء دفع متكرر، يجب إعادة تعيين payment_sum، الرابط الذي تم إنشاؤه مسبقًا، وبعد إعادة تعيين المتغير payment_sum للحصول على رابط جديد. يمكنك تحديد قيمة سابقة.
تصل الاستجابات مع تأخير، لذا بعد إرسال رابط الدفع للمستخدم، نوصي بإرسال رسالة مثل: "بعد الدفع، انتظر رسالة تأكيد إتمام الدفع بنجاح"
على سبيل المثال، يمكنك إنشاء كتلة معالجة دفع ناجح مع شرط وطباعة الرسالة المناسبة للمستخدم:
يجب أن يكون نوع المقارنة "مطابقة تامة"
عند اكتمال الدفع، سيتم إضافة المتغير paypal_callback_data إلى العميل، والذي يحتوي على بيانات استجابة نظام الدفع للمعاملة المكتملة. يمكنك استخراج البيانات المطلوبة من القاموس باستخدام طريقة get.