# Wayforpay

* [كيفية الربط ](#how-to-connect)
* [كيفية معالجة النتيجة ](#how-to-process-the-result)

{% hint style="info" %}

* تسجيل سريع وتأكيد التاجر دون الرقص مع الماس 
* تسجيل تاجر لشخص بدون موقع إلكتروني 
* نسبة مئوية متساوية للأشخاص الطبيعيين والاعتباريين - 2.5 
* إتاحة GooglePay وApplePay
  {% endhint %}

## كيفية الربط 

لربط نظام wayforpay تحتاج إلى 3 قيم: 

1. تسجيل دخول التاجر 
2. المفتاح السري للتاجر 
3. اسم نطاق التاجر.

انتقل إلى حسابك الشخصي -> [https://m.wayforpay.com/mportal/merchant/list ](<https://m.wayforpay.com/mportal/merchant/list >)إعدادات المتجر

انسخ البيانات وانتقل إلى الإعدادات في Salebot.&#x20;

افتح قسم أنظمة الدفع، واختر wayforpay. تحتاج إلى إدخال البيانات المستلمة.

![](/files/99d1e78db0b5c62ad36eecbc745fbf9d47de68af)

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

يكون الرابط بالشكل التالي: <https://secure.wayforpay.com/invoice/id1bbb2ad0375> &#x20;

{% hint style="warning" %}
الإعداد الافتراضي هو UAH (الهريفنيا)، وإذا كنت تحتاج إلى عملة أخرى فعليك تعيين قيمة المتغير currency
{% endhint %}

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

**currency** - ترتيب العملة افتراضيًا UAH (القيم الممكنة USD, EUR, RUB)&#x20;

**session\_timeout** - مدة صلاحية الرابط بالثواني، والقيمة الافتراضية هي 3600 (ساعة واحدة)&#x20;

**product\_name** - اسم المنتج&#x20;

**language** - لغة صفحة الدفع، افتراضيًا UA (القيم الممكنة RU, EN)

**buyer\_name** - اسم المشتري&#x20;

**buyer\_email** - بريد المشتري الإلكتروني&#x20;

**buyer\_first\_name** - اسم المشتري&#x20;

**buyer\_last\_name** - اسم المشتري

يحتوي هذا العرض على صفحة لرابط الدفع.

&#x20;                                          ![](/files/30333aab435324070cb117b534a33aef40dc22dc)

إنشاء رابط لدفع 1 UAH وبمدة صلاحية ساعتين

&#x20;                                             ![](/files/eb25919f17b7371e1367a2d63984c3f84fb3b45c)

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

* أولًا حدّد المعلمات الاختيارية product\_name، إلخ.
* وأخيرًا، عيّن قيمة المتغير payment\_sum
  {% endhint %}

ملاحظة: أولًا نعيّن المتغيرات الخاصة بالإعدادات، ثم payment\_sum. يمكنك تعريف المتغيرات في وقت أبكر ضمن السلسلة، وليس في كتلة واحدة؛ هذا مثال.

بعد ذلك، وفي المكان المناسب، اطبع المتغير wayforpay\_pay\_url الذي يحتوي على الرابط

![](/files/59306f0ba5f87b902db2f6b3e70d033ed4bfce84)

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

بعد نجاح الدفع في البوت ستصل webhooks، وبناءً عليها يمكنك فهم أنه تم الدفع بنجاح. هذه الـwebhooks تظهر في النظام على أنها رسائل من المستخدم، لذلك لا يمكن أن يرسلها المستخدم، وهي تتكون من أول 10 أحرف من المفتاح السري مع اللاحقة \_success، على سبيل المثال: **flk3409ref\_success**

&#x20;                                         ![](/files/21463052ff92d7487f88a640df0b6b2e576fde6d)

{% hint style="info" %}
هذه الاستدعاءات العكسية لا يراها المستخدم، بل تظهر فقط للمشغّل
{% endhint %}

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

أيضًا، بعد نجاح الدفع، يتم تعيين المتغير **wayforpay\_payment\_completed** إلى true&#x20;

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

&#x20;                                      ![](/files/62719a47671bff8bece13be3014d43adf3f0e074)

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


---

# 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/wayforpay.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.