Paynow

نظام الدفع البولندي

• كيفية ربط Paynow

• كيفية إنشاء رابط للدفع

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

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

كيفية ربط Paynow

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

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

في الأسفل ضمن إعدادات المتجر في سطر Adres powiadomień - نحدد عنوان URL لاستلام إشعار ردّ الدفع (callback):

https://chatter.salebot.pro/paynow_callback/result

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

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

كيفية إنشاء رابط للدفع

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

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

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

البريد الإلكتروني - بريد المشتري الإلكتروني (إذا لم يُحدَّد فسيكون افتراضياً)

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

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

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

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

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

الاسم الأول - اسم المشتري

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

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

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

• أولاً حدِّد البريد الإلكتروني

• الخيارات الاختيارية التالية first_name, payment_description، إلخ.

• وأخيرًا، عيّن قيمة payment_sum variable

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

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

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

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

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

بعد الدفع الناجح في البوت ستصل kolbeks، والتي يمكنك من خلالها فهم أن الدفع تم بنجاح.

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

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

يجب أن يكون نوع المطابقة "Full match"

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

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

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

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

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

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