كيفية ربط Paynow

أدخل حساب Paynow الخاص بك. انتقل إلى الإعدادات بالنقر على الترس.

بعد ذلك نذهب إلى Sklepy i punkty płatności

أدناه في إعدادات سطر المتجر Adres powiadomień - نحدد عنوان URL لاستلام رد الاتصال بالدفع:

https://chatter.salebot.pro/paynow\\_callback/result

أدناه تحتاج إلى نسخ مفتاح API (Klucz dostępu do API) والمفتاح السري (Klucz obliczania podpisu)

انتقل إلى مشروعك على mavibot.pro وفي قسم أنظمة الدفع - Paynow قم بتدوين المفاتيح التي وجدتها.

كيفية تكوين رابط للدفع

الإعدادات المطلوبة

قبل تحديد المتغير بمبلغ الدفع، يجب أن يكون لدى العميل متغير بريد إلكتروني مع عنوان بريده الإلكتروني

مثال على كيفية طلب وحفظ عنوان البريد الإلكتروني أدناه.

email - البريد الإلكتروني للمشتري (إذا لم يتم تحديده، استخدم بريدًا وهميًا)

payment_description - وصف الدفع يظهر في الواجهة الإلكترونية (انتبه! سيتم استبدال الأحرف السيريلية تلقائيًا بالأحرف اللاتينية، بحد أقصى 255 حرفًا). إذا لم يتم تحديده، سيتم ملؤه تلقائيًا: دفع الفاتورة رقم "رقم هنا"

لإنشاء رابط للدفع، تحتاج إلى تعيين قيمة متغير payment_sum (مثل 150 أو 100.55 (باستخدام النقطة!))، وبعد ذلك مباشرة سيظهر متغير paynow_pay_url. يمكن عرض هذا المتغير مع رابط أو وضعه على زر مع نص "دفع".

الرابط يكون بالشكل: https://paywall.paynow.pl/NOH0-0LT-SEY-XOI?token=eyJraWQiOiJhMDAyNjJjYS02NTU3LTRjOTktOGU0NC1kMTFlMTAxYjhhNTIiLCJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJOT0gwLTBMVC1TRVktWE9JIiwiYXVkIjoicGF5d2FsbC5zYW5kYm94LnBheW5vdy5wbCIsImlzcyI6InNhbmRib3gucGF5bm93LnBsIiwiZXhwIjoxNjE5NTkyOTc4LCJpYXQiOjE2MTk1MDY1Nzh9.dnCfjADHiTynvXk41TVxsQEVfDAnHFDC\\_9sdzWF4G2s

المعلمات الاختيارية

أيضًا، قبل تعيين قيمة payment_sum، يمكنك تحديد المتغيرات الاختيارية التالية لتكوين الدفع.

first_name - اسم المشتري

last_name - اسم عائلة المشتري

language - لغة صفحة الدفع بتنسيق BCP47/RFC5646 (مثل pl-PL، en-US)currency - رمز عملة الدفع ISO 4217. إذا لم يتم تحديده، يتم استخدام القيمة الافتراضية (PLN).

يرجى الملاحظة:

  • أولاً حدد البريد الإلكتروني
  • بعد ذلك المعلمات الاختيارية first_name, payment_description، إلخ.
  • وأخيرًا، قم بتعيين قيمة متغير payment_sum

مثال على رابط الدفع

أولاً، سنطلب ونحفظ البريد الإلكتروني للعميل. سننشئ كتلة لطلب إدخال البريد الإلكتروني وحفظ الإدخال في السهم:

في الكتلة التالية، لن يتم عرض الرسالة، سنحدد وصف الدفع وبعده سنقوم فورًا بتعيين المتغير بمبلغ دفع 10 زلوتي (الزلوتي الافتراضي)

بعد ذلك، في المكان المناسب، اطبع متغير paynow_pay_url الذي يحتوي على الرابط. في المثال، هذه هي الكتلة التالية.

كيفية معالجة النتيجة

بعد الدفع الناجح، سيصل إلى البوت ردود اتصال (callbacks) يمكنك من خلالها فهم أن الدفع تم بنجاح.

ترى هذه الردود في النظام كرسائل من المستخدم، بحيث لا يمكن للمستخدم إرسالها، وتتكون من أول 10 أحرف من المفتاح السري وكلمة success، على سبيل المثال: omc79l97u4_success

هذه الردود لا يراها المستخدم، بل تظهر فقط للمشغل.

يجب أن يكون نوع المقارنة "مطابقة تامة"

أيضًا، بعد الدفع الناجح، يتم تعيين متغير paynow_payment_completed إلى True.

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

عند اكتمال الدفع، سيتم إضافة متغير paynow_callback_data إلى العميل، والذي يحتوي على بيانات استجابة نظام الدفع للمعاملة المكتملة. يمكنك استخراج البيانات اللازمة من القاموس باستخدام طريقة get.

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

يقارن إشعار الدفع قيمة متغير paynow_payment_id مع معرف الدفع من الإشعار، إذا لم يتطابقا فهذا يعني أن الدفع تم باستخدام رابط قديم. في مراسلاتك مع المستخدم، سترى إشعارًا بذلك.

نوصي بشدة بعدم إعادة استخدام رابط الدفع إذا لم يتم إكمال الدفع السابق أو إلغاؤه!