# Wallet pay

<figure><img src="/files/d2e6f92262d48e591282a1f117a0ef6796d6362d" alt="" width="319"><figcaption></figcaption></figure>

## الاتصال بنظام الدفع

### الاتصال من جهة تيليغرام

**الخطوة 1.** سجّل الدخول إلى حساب الشريك الخاص بك

{% hint style="info" %}
[للقيام بذلك، اتبع الرابط](https://pay.wallet.tg/)
{% endhint %}

في الصفحة التي تفتح، انقر على "تسجيل الدخول عبر تيليغرام"، ثم أدخل رقم هاتفك في النافذة المنبثقة "يظهر oauth.telegram.org" وانقر على "تطبيق".

من الضروري توصيل نظام الدفع عبر متصفح الويب وعبر التطبيق أيضًا:

* ستتلقى رسالة من تيليغرام تطلب التفويض - انقر **"تطبيق".**
* تحتاج أيضًا إلى النقر على "تطبيق" في النافذة المنبثقة **"oauth.telegram.org" في متصفح الويب.**

{% hint style="success" %}
يُنصح باستخدام حساب يمكن لمسؤول المالية الوصول إليه. بالنسبة للكيانات القانونية – ممثل مخوّل.
{% endhint %}

**الخطوة 2.** أجرِ استطلاعًا قصيرًا

<figure><img src="/files/86e44b54ce5f4a7aec43834420d96e3db58169e5" alt=""><figcaption><p>الشكل 1. تعبئة معلومات عن التاجر</p></figcaption></figure>

إذا كنت تسجّل الدخول لأول مرة أو كنت بحاجة إلى بعض المعلومات الإضافية، فإن WalletPay يتيح لك الإجابة عن بعض الأسئلة للحصول على معلومات أكثر تفصيلاً. هناك خطوتان:

#### 1. الاستبيان

#### 2. فحوصات KYB (اعرف عملك) أو KYC (اعرف عميلك)

بعد الانتهاء، ستتم مراجعة طلبك قريبًا وسيتم إخطارك بالنتائج. إذا تمت العملية بنجاح، فسترى العمولة التي يفرضها الخِدمة وستحصل على إمكانية الوصول إلى حسابك حيث يمكنك بدء التكامل.

{% hint style="warning" %}
بالنسبة للكيانات القانونية، لا يمكن تعبئة النموذج إلا من قبل شخص موثوق: مدير أو موظف بتوكيل.
{% endhint %}

**الخطوة 3.** *أنشئ "المتجر" الأول.*

بعد إكمال "الاستبيان" بنجاح، سيُقترح عليك إنشاء متجرك الأول.

**الخطوة 4.** *أنشئ "مفتاح API"*

بعد اسم المتجر الأول، سيُقترح عليك إعداده:

* قم بإنشاء مفتاح API.
* انسخ مفتاح API الخاص بك وابدأ التكامل مع Mavibot.

**الخطوة 5**. *أنشئ طلبًا وتلقَّ رابط دفع*

إذا أردت وضع رابط داخل زر، فاستخدم **زرًا مضمّنًا.**

يرجى ملاحظة أن "customerTelegramUserId" المحدد فقط يمكنه فتح صفحة الدفع.

**الخطوة 6.** *سحب الأموال*

بعد أن يؤكد العميل الدفع، تُقيد الأموال في أصولك وتُحتجز افتراضيًا لمدة 48 ساعة. بعد هذه المدة، ستتمكن من سحب الأموال إلى رصيد محفظتك، التي استخدمتها لتسجيل الدخول إلى خدمة محفظة Paypal.

**الخطوة 7.** *إرجاع الأموال*

حاليًا، سحب الأموال متاح من حساب محفظتك، الذي تستخدمه لتسجيل الدخول إلى WalletPay. لكنه سيكون متاحًا في حساب التاجر الخاص بك قريبًا.

### كيف يبدو زر الدفع؟

عند دمج روبوت تيليغرام الخاص بك مع "Wallet Pay API"، تأكد من أن زر الدفع يتوافق مع التوصيات التالية:

1. يُسمّى بإحدى طريقتين:

* :purse: Wallet Pay
* :purse: الدفع عبر Wallet

2. يوضع أعلى الأزرار الأخرى (إن وجدت).

> ملاحظة. :purse: — هذه إيموجي (انظر <https://emojipedia.org/purse/>).
>
> انظر المثال في \[[Demo Store Bot](https://t.me/PineAppleDemoWPStoreBot)].

## الاتصال بـ Mavibot

سجّل الدخول إلى المشروع وانقر على الزر **"اتصال"** الخاصة بـ Wallet Pay في قسم "أنظمة الدفع".

<figure><img src="/files/ef06272c7896e1780f65b85a49d5cc9e008dffdf" alt=""><figcaption><p>الشكل 2. قسم "الاستحواذ" لربط الخدمة بـ Mavibot</p></figcaption></figure>

في النافذة التي تفتح، أدخل مفتاح API الذي تم إنشاؤه لمتجر WalletPay الخاص بك.

<figure><img src="/files/a5ae7e2f504c8097363cf6931c1c59ab61828157" alt=""><figcaption><p>الشكل 3. نموذج يحتوي على حقل إدخال مفتاح API</p></figcaption></figure>

* [x] تم! الآن يمكن للعملاء الدفع مقابل المشتريات في متجرك بالعملات الرقمية (USDT وToncoin وBitcoin) باستخدام خدمة محفظة Paypal.

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

أنشئ كتلة منشئ القمع واستدعِ **"wallet\_pay\_generate\_payment\_url"** في الحاسبة، مع تمرير المعلمات اللازمة إليها:

| المعلمات             | وصف المعلمات                                                                                |
| -------------------- | ------------------------------------------------------------------------------------------- |
| **amount**           | مبلغ الدفع بالعملة المشفرة أو بأي عملة ورقية أخرى متاحة للتحويل إلى "TON".                  |
| **رمز العملة**       | عملة الدفع الافتراضية هي "RUB". قائمة العملات المتاحة: "TON" "BTC" "USDT" "EUR" "USD" "RUB" |
| **description**      | وصف قصير للطلب من 5 إلى 100 حرف.                                                            |
| **timeout\_seconds** | مدة صلاحية الرابط بالثواني، والافتراضي هو 3600 ثانية.                                       |

<figure><img src="/files/1bebd065bc90506231ccfcb4a437fc40b32a8d5a" alt=""><figcaption><p>الشكل 4. مثال على تمرير المعلمات</p></figcaption></figure>

عند تشغيل الكتلة في محادثة مع روبوت، سيتلقى العميل رابط دفع، و **wallet\_pay\_payment\_completed** بالقيمة <mark style="color:red;">**False.**</mark>

{% hint style="warning" %}
يمكن فتح هذا الرابط فقط في محادثة مع روبوت متصل بحساب فوترة WalletPay.
{% endhint %}

### التحقق من الدفع

بعد نجاح الدفع، سيتم تعيين متغير العميل إلى **wallet\_pay\_payment\_completed** سيُعيَّن المتغير إلى <mark style="color:green;">**True،**</mark> وسيتلقى البائع ردًا آليًا على شكل **4690FE98\_success**، والذي يتكون من:

* "4690FE98" - هذه هي أول 8 أحرف من مفتاح Wallet Pay API.
* كلمات عن النجاح

<mark style="color:red;">**!**</mark> إذا حدث خطأ في الدفع، فستتلقى **callback** مع اللاحقة "<mark style="color:red;">**\_fail**</mark>".

عنوان الإشعارات (callbacks): <https://chatter.salebot.pro/wallet_pay/payment_callback> - يُدرج في إعدادات نظام الدفع

يمكن تضمين رد آلي في شرط الكتلة لإرسال رسالة إلى العميل بشأن نجاح الدفع (أو خطأ في الدفع):

<figure><img src="/files/b0fbbe5d9843ea01de8bc46b1b0770c574a34951" alt=""><figcaption><p>الشكل 5. مثال على التفاعل مع رد آلي في كتلة "شرط البدء"</p></figcaption></figure>

<figure><img src="/files/7b9c3889c4f57c2e729cbd43cc64d3c7e5943575" alt=""><figcaption><p>الشكل 6. مثال على رد على callback في كتلة "شرط الحالة غير النشطة"</p></figcaption></figure>

{% hint style="info" %}
إذا كنت لا تريد إخراج العميل من المخطط الرئيسي للروبوت الدردشة، فاستخدم كتلة "شرط الحالة غير النشطة". لا يمكنك الانتقال إلى هذه الكتلة، لذلك لن يتم إخراج العميل من القمع الرئيسي بعد الدفع وسيتلقى إشعارًا بنجاح الدفع.\
إشعار بنجاح الدفع.

وإذا كنت بحاجة إلى متابعة القمع مع تفاعل على الدفع الناجح، فاستخدم كتلة "شرط البدء"، ثم سينتقل العميل من كتلة الدفع إلى كتلة "شرط البدء"، ومن خلالها يمكنك متابعة القمع.
{% endhint %}

{% hint style="info" %}
مزيد من المعلومات حول الكتل الشرطية موضحة في المقالة التي تحمل الاسم نفسه. ссылка[блоках с условием рассказали](broken://pages/fbd5b316dbf191d7c4928912a5ac514468d6432a)&#x20;
{% endhint %}

### روابط مفيدة

\[[دعم أعمال Wallet Pay](https://t.me/WalletPay_supportbot)]

\[[Demo Store Bot](https://t.me/PineAppleDemoWPStoreBot)]

\[[مجتمع التجار](https://t.me/+6TReWBEyZxI5Njli)]


---

# 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/aldfa/wallet-pay.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.