# Paynow

* [كيفية ربط Paynow ](#how-to-connect-paynow)
* [كيفية إنشاء رابط للدفع](#how-to-form-a-link-for-payment) 
* [مثال على رابط للدفع ](#example-of-a-link-to-pay)
* [كيفية معالجة النتيجة](#how-to-process-the-result)

## كيفية ربط Paynow 

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

![](/files/78944927e25e3b2a330531245d6bf36d88f4a4da)

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

![](/files/9207f52599b1a5b4c56a1d3706930f0d5810bfee)

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

**<https://chatter.salebot.pro/paynow\\_callback/result>**

![](/files/8ba997ac9358e711a497b22768b71d6c4a71c707)

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

![](/files/3fdd0018d1fbdcb200c54c73a38ae93cf541e2dc)

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

&#x20;                                              ![](/files/09caa9e89785972fc2b9fb4c2ba1fb845bb8164b)

![](/files/547a32b5bad7a898020ac1fb21c9db4bd85a4cbf)

## كيفية إنشاء رابط للدفع&#x20;

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

{% hint style="warning" %}
قبل تحديد المتغير الخاص بمبلغ الدفع، يجب أن يكون لدى العميل متغير بريد إلكتروني يحتوي على عنوان بريده الإلكتروني
{% endhint %}

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

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

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

لإنشاء رابط للدفع، تحتاج إلى ضبط قيمة **payment\_sum** المتغير (مثل 150 أو 100.55 (باستخدام النقطة!))، وبعد ذلك مباشرة سيظهر المتغير **paynow\_pay\_url** . يمكن عرض هذا المتغير كرابط أو وضعه على زر بالنص "Pay".&#x20;

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

### المعلمات الاختيارية&#x20;

كذلك، قبل ضبط **payment\_sum** القيمة، يمكنك تحديد المتغيرات الاختيارية التالية لتكوين عملية الدفع.&#x20;

**الاسم الأول** - اسم المشتري&#x20;

**اسم العائلة** - اسم المشتري&#x20;

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

{% hint style="info" %}
**يرجى الملاحظة:**

* أولاً حدِّد البريد الإلكتروني
* الخيارات الاختيارية التالية **first\_name, payment\_description**، إلخ.
* وأخيرًا، عيّن قيمة **payment\_sum** variable
  {% endhint %}

## مثال على رابط للدفع&#x20;

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

![](/files/03baa8f1545501bab2b5150a68fc0ede1b4c0111)

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

![](/files/6ad5311a57d94a7d2f0055d16c67cda54961d4c2)

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

![](/files/8dfeb4d78439893ea2bdec6e3240a54ea25fd1f6)

![](/files/7946a247b1e98ac360f6d302ad3ba45a979a9701)

## كيفية معالجة النتيجة&#x20;

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

تظهر هذه الردود في النظام كرسائل من المستخدم، لذلك لا يمكن إرسالها من المستخدم، وهي تتكون من أول 10 أحرف من مفتاح السر ونجاح الحساب، على سبيل المثال: omc79l97u4\_success&#x20;

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

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

كذلك، بعد نجاح الدفع، يتم تعيين المتغير paynow\_payment\_completed إلى True.&#x20;

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

![](/files/b8ab307ab34e3985751f15584f1cf35b48a7bd2d)

![](/files/d6589ec5c54132afe1c7aee4c3ab7b09d14f1306)

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

{% hint style="warning" %}
لإجراء دفعة متكررة، يجب إعادة تعيين payment\_sum، والرابط الذي تم إنشاؤه مسبقًا، وبعد إعادة تعيين المتغير payment\_sum الحصول على رابط جديد. يمكنك تحديد قيمة سابقة.
{% endhint %}

&#x20;                                          ![](/files/977078d13917ced9f5a2ae58ad3b6dbb285ebaae)

{% hint style="warning" %}
تتحقق إشعارات الدفع من قيمة المتغير paynow\_payment\_id مع معرّف الدفع الوارد في الإشعار؛ وإذا لم يتطابقا فهذا يعني أن الدفع تم عبر رابط قديم. سترى إشعاراً بذلك في مراسلتك مع المستخدم.
{% endhint %}

{% hint style="warning" %}
نوصي بشدة ألا تعيد ربط الدفع إذا لم يكن السابق قد اكتمل أو أُلغي!
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ar/integrations/payment/paynow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.