# Bepaid (ru)

## كيفية التوصيل

لتوصيل نظام الدفع bePaid ستحتاج إلى معرّف المتجر والمفتاح السري والمفتاح العام. بعد الحصول عليها، ننتقل إلى الإعدادات في MaviBot.

في MaviBot نفتح قسم "الاستحواذ"، ونختار bePaid. يجب إدخال البيانات المستلمة.

<div data-with-frame="true"><figure><img src="/files/e299cc88b4c35ba1d609976c5d489a8fb91235a8" alt=""><figcaption></figcaption></figure></div>

يرجى ملاحظة أن الحقل الأخير هو مفتاح تبديل لاستضافة API حسب بلد الاستخدام: بيلاروسيا أو روسيا.

<div data-with-frame="true"><figure><img src="/files/44d996c8ccd3abd8471b63e6d373350a0af550df" alt=""><figcaption></figcaption></figure></div>

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

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

يكون الرابط بالشكل التالي: \
<https://checkout.bepaid.by/widget/hpp.html?token=a05eabd3f9368725efbc175614c7d469da08f198cc51916b07fb75e53f9a3e1a>

كذلك، قبل تعيين قيمة المتغير payment\_sum، يمكن تعيين المتغيرات الاختيارية التالية لإعداد الدفع.

{% hint style="info" %}
افتراضيًا يتم تعيين الروبل البيلاروسي، وإذا كانت هناك حاجة إلى عملة أخرى فيجب تعيين قيمة المتغير currency
{% endhint %}

<table><thead><tr><th width="209">معلمات الدالة</th><th width="242">وصف المعلمة</th><th>إضافيًا</th></tr></thead><tbody><tr><td><strong>currency</strong></td><td>عملة الدفع بصيغة <a href="http://en.wikipedia.org/wiki/ISO_4217">ISO-4217</a> تنسيق</td><td>على سبيل المثال USD</td></tr><tr><td><strong>language</strong></td><td><p>لغة صفحة الدفع</p><p>القيمة الافتراضية - en.</p></td><td><p>القيم المسموح بها:</p><p>en - الإنجليزية</p><p>es - الإسبانية</p><p>tr - التركية</p><p>de - الألمانية</p><p>it - الإيطالية</p><p>ru - الروسية</p><p>zh - الصينية</p><p>fr - الفرنسية</p><p>da - الدنماركية</p><p>sv - السويدية</p><p>no - النرويجية</p><p>fi - الفنلندية</p><p>pl - البولندية</p><p>ja - اليابانية</p><p>uk - الأوكرانية</p><p>be - البيلاروسية</p><p>ka - الجورجية</p><p>ro - الرومانية</p></td></tr><tr><td><strong>payment_description</strong></td><td>وصف الدفع</td><td></td></tr><tr><td><strong>link_expired</strong> </td><td><p>مدة صلاحية رابط الدفع، بصيغة يوم.شهر.سنة (على سبيل المثال 25.06.2025). </p><p>افتراضيًا يجب أن يتم الدفع خلال 24 ساعة</p></td><td><p>يمكن أيضًا في الحقل <strong>"تعيين المتغيرات عند الانتقال"</strong> تحديد: link_expired = current_date + 2 (سيكون الرابط صالحًا لمدة يومين حتى 00:00)</p><p><strong>link_expired</strong> كما يمكن أيضًا تحديد تاريخ مع وقت دقيق، مع ترك مسافة، بصيغة يوم.شهر.سنة ساعة:دقيقة (على سبيل المثال: 25.06.2025 12:23). افتراضيًا يجب أن يتم الدفع خلال 24 ساعة</p><p>يمكن أيضًا استخدام المتغيرات القياسية، على سبيل المثال لنعيّن مدة صلاحية الرابط 30 دقيقة:</p><p>time = current_time + 30</p><p>link_expired = "#{current_date} #{time}"</p></td></tr><tr><td>russian_host</td><td>مؤشر تسجيل المتجر على المضيف الروسي لـ bePaid. حدّد هذه المعلمة بالقيمة 1 إذا كان متجرك مسجلًا على موقع bepaid.tech</td><td>إذا كان من الضروري التبديل إلى المضيف البيلاروسي، فحدّد المعلمة بالقيمة ''</td></tr><tr><td><strong>test_payments</strong></td><td>هذا المتغير مطلوب للمدفوعات الاختبارية، وإذا كنت تحتاج إلى دفعة اختبارية فأضفه بأي قيمة.</td><td></td></tr><tr><td><strong>bepaid_attempts</strong> </td><td>يشير إلى عدد محاولات إتمام الدفع، ويتم منح محاولة واحدة افتراضيًا.</td><td></td></tr><tr><td><strong>сustomer_data</strong></td><td>مصفوفة تحتوي على <em>first_name و last_name و email</em> الخاصة بالدافع. هذه البيانات ضرورية لإرسال الإيصال إلى بريد الدافع الإلكتروني، وهي متاحة للتحرير في صفحة الدفع. </td><td><p>يجب تمرير المعلمة على شكل قائمة بصيغة json، تتكون من أزواج مفتاح-قيمة</p><p><strong>على سبيل المثال</strong>:</p><p>customer_data = ‘{“first_name”: “Vladimir”, “last_name”: “Popov”, “email”: “v.popov@mavibot.ai” }’</p></td></tr><tr><td>bepaid_contract (شرطيًا إلزامي)</td><td>غرض الدفع عبر الرمز المميز.</td><td>القيم المتوقعة: “recurring” (للمدفوعات المنتظمة ذات الدورية المحددة) أو “card_on_file” (للمدفوعات غير المنتظمة، مثل الدفع اللاحق مقابل خدمة مقدمة)</td></tr></tbody></table>

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

## كيفية اختبار المدفوعات

لإجراء دفعة اختبارية، قبل تحديد المتغير payment\_sum، يجب تعيين المتغير test\_payments بأي قيمة.

لا تنسَ إزالته عند تشغيل البوت في الوضع الفعلي!

بطاقات للاختبارات:

4200000000000000      ناجح

4005550000000019        فاشل

إذا كان هناك شيء لا يعمل، فقارن البيانات بالبيانات الموجودة على الموقع الرسمي: <https://docs.bepaid.by/ru/test-integration#test-card-number>&#x20;

## مثال على إنشاء رابط الدفع

لننشئ رابط دفع بقيمة 100 روبل بيلاروسي (العملة الافتراضية)

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

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

## إدارة الاشتراكات

يوفر تكامل نظام الدفع إمكانية إنشاء اشتراكات لعملائك.

قبل البدء في استخدام وظائف MaviBot، أنشئ خطة اشتراك في الحساب الشخصي لـ bePaid.

{% hint style="warning" %}
إذا لم تظهر قائمتا “الخطط” و“الاشتراكات” في الحساب الشخصي، فتواصل مع مديرك.
{% endhint %}

### إنشاء اشتراك والحصول على رابط الدفع

استخدم الوظيفة **get\_bepaid\_subscription\_url**، مع تمرير المعلمة plan\_id إليها، حيث

<table><thead><tr><th width="233"></th><th></th></tr></thead><tbody><tr><td>plan_id</td><td>هو معرّف الخطة في نظام bePaid.</td></tr></tbody></table>

نتيجة التنفيذ، ستقوم الوظيفة بإنشاء اشتراك وإرجاع رابط دفعه.

أرسل الرابط إلى العميل وانتظر اكتمال الدفع.

عند نجاح الدفع، سيتم تفعيل الاشتراك، وستُضاف إلى الصفقة المتغيرات bepaid\_subscription\_id و bepaid\_subscription\_status، كما سيصل إلى البوت رد نداء (انظر القسم “[كيفية معالجة النتيجة](#kak-obrabotat-rezultat)”).

### الحصول على معلومات الاشتراك

للحصول على بيانات اشتراك العميل الحالي، استدعِ الوظيفة get\_bepaid\_subscription\_info، مع تمرير المعلمة subscription\_id إليها (يمكن أخذ القيمة من المتغير bepaid\_subscription\_id).

### إلغاء الاشتراك

لإلغاء الاشتراك، استخدم الوظيفة cancel\_bepaid\_subscription.&#x20;

تقبل هذه الوظيفة معلمة واحدة فقط هي subscription\_id (يمكن أخذ القيمة من المتغير bepaid\_subscription\_id).

عند الإلغاء الناجح، سيأخذ المتغير bepaid\_subscription\_status القيمة “canceled”، كما سيصل إلى البوت رد نداء (انظر القسم “[كيفية معالجة النتيجة](#kak-obrabotat-rezultat)”).

### حالات الاشتراكات

<table data-header-hidden><thead><tr><th width="270"></th><th></th></tr></thead><tbody><tr><td>trial</td><td>اشتراك تجريبي نشط أو ملغى.</td></tr><tr><td>active</td><td>اشتراك نشط تم فيه السداد في الموعد المحدد.</td></tr><tr><td>failed</td><td>اشتراك فاشل. لم يتمكن bePaid من إجراء الدفعة التالية.</td></tr><tr><td>error</td><td>حدث خطأ عند محاولة bePaid إجراء الدفع.</td></tr><tr><td>canceled</td><td>تم إلغاء الاشتراك ولم يعد ساريًا.</td></tr></tbody></table>

### المدفوعات المتكررة

يمكنك أيضًا تنظيم نظام اشتراكات دون إنشاء خطة في الحساب الشخصي لـ bePaid.

ولهذا ستحتاج إلى رمز بطاقة العميل.

للحصول على رمز البطاقة، يجب على العميل إجراء دفعة تأسيسية عبر الرابط الذي تم إنشاؤه من خلال payment\_sum.

قبل تعيين قيمة payment\_sum، عيّن المتغير bepaid\_contract، وحدد فيه غرض المدفوعات المستقبلية عبر الرمز: “recurring” للمدفوعات المنتظمة ذات الدورية المحددة أو “card\_on\_file” للمدفوعات غير المنتظمة (على سبيل المثال، الدفع اللاحق مقابل خدمة مقدمة).

{% hint style="warning" %}
الخيار “card\_on\_file” غير مدعوم من جميع جهات الاستحواذ. إذا كنت ترغب في استخدامه، فتواصل مع مدير الحساب الخاص بك.
{% endhint %}

بعد نجاح الدفع، سيُضاف إلى الصفقة المتغير bepaid\_client\_card\_token، الذي سيتم فيه حفظ رمز بطاقة العميل. يتيح هذا الرمز خصم الأموال من بطاقة العميل دون مشاركته.

بعد ذلك قم بإعداد القمع وحدد التاريخ أو الشرط للخصم التلقائي واستدعِ وظيفة الآلة الحاسبة make\_bepaid\_token\_payment، مع تمرير المعلمات المطلوبة إليها.

**ترتيب المعلمات**:

amount -> currency -> description -> contract

#### وصف المعلمات:

<table><thead><tr><th width="286"></th><th></th></tr></thead><tbody><tr><td>amount (إلزامي)</td><td>مبلغ الدفع، والقيمة المتوقعة عدد صحيح أو عشري، على سبيل المثال 100 أو 100.5؛</td></tr><tr><td>currency (إلزامي)</td><td>عملة الدفع بصيغة<a href="http://en.wikipedia.org/wiki/ISO_4217"> ISO-4217</a> بصيغة، على سبيل المثال “USD”</td></tr><tr><td>description (إلزامي)</td><td>وصف سبب الخصم، على سبيل المثال، “دفع اشتراك أسبوعي للمشاركة في نادي الهوايات”;</td></tr><tr><td>contract (إلزامي)</td><td>غرض الدفع عبر الرمز. القيم المتوقعة: “recurring” أو “card_on_file”. </td></tr></tbody></table>

{% hint style="warning" %}
يجب أن تتطابق قيمة contract بالضرورة مع القيمة المحددة عند إنشاء رابط الدفعة التأسيسية!
{% endhint %}

إذا تم الدفع بنجاح، فستُرجع الوظيفة الرسالة “خصم ناجح عبر رمز bePaid“، وستتلقى رد نداء عن الدفع الناجح، وسيأخذ متغير الصفقة bepaid\_token\_payment\_completed القيمة “True”.

إذا لم ينجح الدفع، فستُرجع الوظيفة رسالة تشير إلى سبب فشل الدفع، وسيصل إلى البوت رد نداء مع اللاحقة “\_fail”، وسيأخذ متغير الصفقة bepaid\_token\_payment\_completed القيمة “False”.

{% hint style="warning" %}
قد يطلب البنك من العميل إكمال الدفع. في هذه الحالة، ستُرجع الوظيفة رابطًا مع طلب اجتياز مصادقة 3-D Secure.
{% endhint %}

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

استجابةً لإجراءات العميل، ستصل إلى البوت ردود نداء تتكون من أول 20 رمزًا من المفتاح السري ولاحقة تعتمد على نوع العملية ونتيجتها.

في النظام، يبدو رد النداء كرسالة من المستخدم، إلا أن المستخدم نفسه لا يراها.

### للمدفوعات

نتيجة دفعة لا تتعلق بالاشتراك، ستصلك إحدى الرسائل التالية:

<mark style="color:green;">**رقم\_المفتاح\_success**</mark> - عند نجاح الدفع؛

<mark style="color:red;">**رقم\_المفتاح\_fail**</mark> - عند فشل الدفع؛

يمكن أيضًا تتبع حالة آخر دفعة من خلال المتغيرين bepaid\_payment\_completed (للمدفوعات بمشاركة العميل) و bepaid\_token\_payment\_completed (للمدفوعات غير المقبولة مسبقًا عبر رمز البطاقة)

### للاشتراكات

بعد التفعيل الناجح للاشتراك عند الدفعة الأولى أو المتكررة، ستصل إلى البوت رسالة <mark style="color:green;">**رقم\_المفتاح\_success**</mark>.

إذا تم إلغاء الاشتراك، فستتلقى <mark style="color:orange;">**رقم\_المفتاح\_canceled**</mark>.

في حالة فشل الدفع الخاص بالاشتراك، ستصلك رسالة *<mark style="color:red;">**رقم\_المفتاح**</mark>*<mark style="color:red;">\_fail.</mark>


---

# 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/bepaid/bepaid-ru.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.