> For the complete documentation index, see [llms.txt](https://docs.mavibot.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mavibot.ai/doc/ar/integrations/payment/rwbwkasa-kz.md).

# روبوكاسا (KZ)

## كيفية إعداد Robokassa

لننظر في كيفية تنفيذ استقبال المدفوعات في البوت عبر خدمة Robokassa.

1. أنشئ متجرًا إلكترونيًا في الحساب الشخصي لخدمة Robokassa وحدد بيانات الإعدادات التقنية:

\- خوارزمية حساب الهاش: MD5\
\- Result Url: <https://chatter.mavibot.ai/robokassa\\_callback/result\\>
\- طريقة إرسال البيانات عبر Result Url: GET\
\- Success Url: <https://chatter.mavibot.ai/robokassa\\_callback/success\\>
\- طريقة إرسال البيانات عبر Success Url: GET\
\- Fail Url: <https://chatter.mavibot.ai/robokassa\\_callback/fail\\>
\- طريقة إرسال البيانات عبر Fail Url: GET

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

{% hint style="warning" %}
أنشئ كلمات مرور تجريبية وقم بالإعداد الأولي في الوضع التجريبي.
{% endhint %}

## كيف تربط Robokassa بـ MaviBot؟

انتقل إلى قسم "التحصيل" واضغط "توصيل" على لوحة Robokassa:

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

وإملأ النموذج في النافذة التي ستفتح:

1. **حقل معرّف المتجر —** Shop ID، والذي يمكنك العثور عليه في إعدادات المتجر في الحساب الشخصي لـ Robokassa.
2. كلمتا المرور #1 و#2 — سلاسل فريدة مولدة من أرقام+حروف.&#x20;
3. **حقل معدل ضريبة القيمة المضافة.** يجب تحديد الرمز المناسب لنقل قيمة ضريبة القيمة المضافة. يحدد هذا الحقل معدل الضريبة في جهاز الدفع النقدي. يتم تحديده لكل نوع من السلع على حدة، ولكن لجميع وحدات المنتج المحدد معًا.

تُستخدم بالقيم:

* بدون ضريبة قيمة مضافة.
* ضريبة قيمة مضافة بنسبة 0%.
* ضريبة قيمة مضافة بنسبة 5%
* ضريبة قيمة مضافة على الإيصال بالمعدل الحسابي 12%.
* ضريبة قيمة مضافة على الإيصال بالمعدل الحسابي 16%.

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

{% hint style="success" %}
يمكن إنشاء رابط الدفع في البلوك **بأحد** الطرق المتاحة:

* [زر بوظيفة الدفع ](#knopka-s-funkciei-oplata)أو
* [وظيفة get\_robokassa\_payment\_url في الحاسبة](#funkciya-get_robokassa_payment_url-v-kalkulyatore) أو
* [إنشاء رابط باستخدام المتغير payment\_sum والمعلمات الإضافية](#sozdanie-ssylki-s-pomoshyu-peremennoi-payment_sum-i-dopolnitelnykh-parametrov) (نسخة عاملة قديمة)
  {% endhint %}

## زر بوظيفة الدفع

يمكن إنشاء رابط الدفع في الزر ذو وظيفة "الدفع".&#x20;

{% hint style="info" %}
شرح كيفية إنشاء زر بوظيفة "الدفع" هنا
{% endhint %}

لننظر في جميع المعلمات الممكنة لهذا الزر. وقد تم شرح كيفية إنشاء زر بوظيفة الدفع في هذه المقالة:

### **المعلمات الإلزامية لزر الدفع**

لإنشاء رابط الدفع في إعدادات الزر، يجب تحديد  <mark style="color:أخضر;">**المعلمات الإلزامية: المبلغ واسم المنتج.**</mark>

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

**حقل المبلغ.**  في هذا الحقل نحدد قيمة المنتج بالروبل

**حقل اسم المنتج.**  في هذا الحقل يمكن استخدام أحرف من الأبجدية الإنجليزية أو الروسية، والأرقام وعلامات الترقيم فقط. الحد الأقصى للطول — 100 رمز. تظهر هذه المعلومات في واجهة Robokassa وفي الإيصال الإلكتروني الذي يحصل عليه العميل بعد الدفع الناجح.&#x20;

{% hint style="danger" %}
**ممنوع** استخدام **علامات الاقتباس المزدوجة** في اسم المنتج: احذفها أو استبدلها بعلامات اقتباس مفردة.&#x20;
{% endhint %}

**مربع اختيار الدفع التلقائي.** لربط الدفع التلقائي&#x20;

**مربع اختيار إشعار النقر.** لتتبع الانتقال عبر رابط الدفع يمكن وضع علامة. في هذه الحالة، عند النقر على الزر في محادثة العميل في Salebot ستصل رسالة إشعار تفيد بأنه تم الانتقال عبر الرابط

يمكن إعداد منطق لاحق لتشغيل البوت بناءً على هذا الإشعار.

{% hint style="info" %}
تدعم العديد من أنظمة الدفع صناديق نقدية سحابية عبر الإنترنت، وهي مطلوبة بموجب القانون 54-ФЗ.\
اقرأ خصائص إعداد الإيصالات على موقع نظام الدفع المختار حتى لا تقع في موقف محرج مع مصلحة الضرائب.
{% endhint %}

### **لإنشاء الإيصال**

**قائمة "البيانات اللازمة لإنشاء الإيصال".** عند النقر ستفتح قائمة منسدلة تحتوي على معلمات إنشاء الإيصال:

<div data-with-frame="true"><figure><img src="/files/5bdcabf55569ab37ec2333ca987639691ae0d7eb" alt="" width="563"><figcaption></figcaption></figure></div>

**حقل اسم المنتج**. <mark style="color:أحمر;">**إلزامي لإنشاء الإيصال.**</mark>&#x20;

{% hint style="danger" %}
**ممنوع** استخدام **علامات الاقتباس المزدوجة** في اسم المنتج: احذفها أو استبدلها بعلامات اقتباس مفردة.&#x20;
{% endhint %}

**حقل المبلغ الكامل بالروبل.** في هذا الحقل يجب تحديد المبلغ المطلوب دفعه مع مراعاة عدد المنتجات. إذا كان العدد يساوي 1، فإن المبلغ الكامل بالروبل يساوي القيمة في حقل المبلغ ضمن الحقل الإلزامي لإعداد الزر

**حقل الكمية.** كمية أو وزن المنتج. يمكن تمرير عدد صحيح أو كسري باستخدام النقطة. مثال: 5 أو 10.3

### متغيرات العميل التي سيتم إنشاؤها تلقائيًا عند استخدام الزر بوظيفة الدفع

فور أن يحصل المستخدم على البلوك الذي يحتوي على زر "الدفع" سيتم إنشاء متغيرات العميل تلقائيًا:

<div data-with-frame="true"><figure><img src="/files/90de62db5e41a485d8c5b13a6baf260a5c0d65b8" alt="" width="563"><figcaption><p>شكل 9. المتغير payments</p></figcaption></figure></div>

متغير خدمة العميل **`__payments`** ، الذي يخزن المبلغ ومعرّف الرابط المنشأ، وهو مطلوب للتعرف على الويب هوك من نظام الدفع.

{% hint style="danger" %}
لا يمكن حذف أو تعديل متغير خدمة العميل \_\_payments!
{% endhint %}

متغير العميل **`error_payment_button`** يتم إنشاؤه إذا حدث خطأ أثناء إنشاء الزر.

سيتم تسجيل إما نص الخطأ أو رد نظام الدفع الذي يحتوي على الخطأ في قيمة المتغير error\_payment\_button.

{% hint style="warning" %}
تصبح قيم المتغيرات فعّالة عند الانتقال إلى البلوك التالي&#x20;
{% endhint %}

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

{% hint style="warning" %}
نلفت الانتباه!

ترسل Robokassa إشعارًا فقط عن المعاملات الناجحة عبر المعلمة Result URL. <mark style="color:أحمر;">**لا توجد في خدمة Robokassa أي كولباكات للمدفوعات غير الناجحة.**</mark>&#x20;

Fail URL — هي فقط صفحة الدفع غير الناجح، حيث سيُعاد توجيه الدافع إليها في حال حدوث خطأ برمجي في صفحة الدفع.&#x20;
{% endhint %}

**دفع ناجح.**

بعد أن تقوم بإعداد الدفع بشكل صحيح وتوليد رابط لإجراء الدفع، اختبر الإعدادات التي تم إنشاؤها. إذا تم الدفع بنجاح، فسيصل إلى محادثة العميل (قسم "العملاء") <mark style="color:برتقالي;">**تلقائيًا**</mark> سيصل كولباك يتكون من 10 أحرف من المفتاح السري لنظام الدفع، وكلمة \_success ثم مبلغ الدفع بعد مسافة. **يتم توليد الكولباك تلقائيًا**، ولا تحتاج إلى تكوينه بنفسك أو طلبه من دعم نظام الدفع،

<div data-with-frame="true"><figure><img src="/files/91a91307cfe778966fb4fd9a00cf7e756861c7de" alt="" width="563"><figcaption></figcaption></figure></div>

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

مثلًا: `ovg58keefc_success 2999`، حيث:&#x20;

ovg58keefc : 10 أحرف من المفتاح السري لنظام الدفع

\_success : نتيجة معالجة الطلب (دفعة ناجحة)

2999 : مبلغ الدفع

تشغيل البلوك:

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

كولباك:

<div data-with-frame="true"><figure><img src="/files/59882a87675682a21179d7a638e57ae1d4b9745a" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
الكولباكات (الإشعارات) من نظام الدفع لا يراها المستخدم. تظهر فقط في تبويب "العملاء" وتكون مرئية للمشغل/المدير.
{% endhint %}

### مثال على إعداد التفاعل مع الكولباك

في البلوك الذي يحتوي على شرط (يمكن أن يكون إما بلوك "الشرط الابتدائي" أو بلوك "عدم الحالة مع شرط") يجب تحديد الكولباك الذي يصل عند الدفع.&#x20;

{% hint style="warning" %}
مهم: اختر المطابقة "تطابق تام" أو "حسب وجود الكلمات المفتاحية"
{% endhint %}

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

بعد ذلك، عند الدفع سيصل إلى العميل نص الرسالة من البلوك الذي تم إعداد التفاعل مع الكولباك فيه:

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

**دفعة بها خطأ**

إذا كان المبلغ المحدد في إعدادات الزر <mark style="color:أزرق;">**يختلف عن المبلغ الذي دفعه العميل**</mark>، فسيصل إلى البوت <mark style="color:برتقالي;">**تلقائيًا**</mark> كولباك يتكون من 10 أحرف من المفتاح السري لنظام الدفع، وكلمة \_different\_amounts ثم معرّف الدفع الفريد بعد مسافة

مثلًا: `ovg58keefc_different_amounts 123456` ، حيث:&#x20;

`ovg58keefc` : 10 أحرف من المفتاح السري لنظام الدفع

`_different_amounts` : نتيجة معالجة الطلب (مبلغ الدفع يختلف عن المبلغ في الرابط)

`123456` : معرّف الدفع الفريد

## وظيفة get\_robokassa\_payment\_url في الحاسبة

لإنشاء رابط الدفع يمكنك استخدام الوظيفة `get_robokassa_payment_url` في بلوك الحاسبة.

في حقل الحاسبة سنسند للمتغير قيمة الدالة `get_robokassa_payment_url`&#x20;

{% hint style="info" %}
تحدد اسم المتغير بنفسك. في لقطات الشاشة توجد أمثلة على أسماء المتغيرات.&#x20;
{% endhint %}

سيُسجَّل رابط الدفع في هذا المتغير. ويمكن عرض المتغير على الشاشة كرابط في رسالة أو وضعه في زر يحمل النص "الدفع".&#x20;

**مثال على رابط الدفع:**: `https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=test_salebot&OutSum=800&InvId=1412&IsTest=1&SignatureValue=0427369c3bd068bae30935f896060dda`

{% hint style="info" %}
تدعم العديد من أنظمة الدفع صناديق نقدية سحابية عبر الإنترنت، وهي مطلوبة بموجب القانون 54-ФЗ.\
اقرأ خصائص إعداد الإيصالات على موقع نظام الدفع المختار حتى لا تقع في موقف محرج مع مصلحة الضرائب.
{% endhint %}

{% tabs %}
{% tab title="الحاسبة" %}
مثال 1:&#x20;

<div data-with-frame="true"><figure><img src="/files/77afd05957b0c6a3a9489f14b2102bae33de6ae0" alt=""><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="وصف المعلمات" %}
`get_robokassa_payment_url(amount, description, products_for_receipt, recurrent, currency)`

#### معلمات الوظيفة:

<table><thead><tr><th width="190">المعلمة</th><th>قيمة المعلمة</th></tr></thead><tbody><tr><td><strong><code>amount</code></strong></td><td><p><mark style="background-color:blue;">مبلغ الدفع.</mark>  في هذا الحقل نحدد قيمة المنتج بالروبل. </p><p><strong>(معلمة إلزامية)</strong></p></td></tr><tr><td><strong><code>description</code></strong></td><td><mark style="background-color:blue;">اسم المنتج.</mark>  في هذا الحقل يمكن استخدام أحرف من الأبجدية الإنجليزية أو الروسية، والأرقام وعلامات الترقيم فقط. الحد الأقصى للطول — 100 رمز. تظهر هذه المعلومات في واجهة Robokassa وفي الإيصال الإلكتروني الذي يحصل عليه العميل بعد الدفع الناجح. <br><strong>(معلمة إلزامية)</strong></td></tr><tr><td><p><strong><code>products_for_</code></strong></p><p><strong><code>receipt</code></strong></p></td><td><p><mark style="background-color:blue;">معلمات إنشاء الإيصالات.</mark> </p><p>اقرأ المزيد <a href="#dlya-funkcii-get_robokassa_payment_url-i-robokassa_recurrent_payment">هنا.</a> </p></td></tr><tr><td><strong><code>recurrent</code></strong></td><td><mark style="background-color:blue;">تفعيل الدفع التلقائي.</mark> إذا كان الدفع التلقائي مفعّلًا، فمرِّر القيمة 1، وإذا كان معطلاً فمرِّر القيمة None</td></tr><tr><td><strong><code>currency</code></strong></td><td><p><mark style="background-color:blue;">رمز العملة المكون من ثلاثة أحرف.</mark></p><p>يجب تمرير القيمة بدقة وفقًا للمعلمات التي يقبلها خدمة Robokassa.<br>USD - دولار؛<br>EUR - يورو؛<br>KZT - تينغي.</p></td></tr></tbody></table>
{% endtab %}

{% tab title="مثال على الكود للنسخ" %} <mark style="color:أخضر;">مثال 1: رابط الدفع بدون إيصال</mark>\
\
`res = get_robokassa_payment_url(100, 'اشترِني')`

<mark style="color:أخضر;">مثال 2: رابط الدفع مع إيصال</mark>\
\
`receipt = [{"name":"DDDDDDDD","amount":"44","quantity":"1","vat_code":"5","method":"full_payment","object":"commodity"}]`

`res = get_robokassa_payment_url(100, 'اشترِني', receipt, '3', 1, 1)`
{% endtab %}
{% endtabs %}

{% hint style="info" %}
يمكن عرض المتغير كرابط في رسالة أو وضعه في زر يحتوي على نص، مثلًا، "شراء".&#x20;
{% endhint %}

{% hint style="warning" %}
إذا كانت هناك عدة وظائف في البلوك للحصول على الرابط وحدث خطأ، فسيتم تسجيل قيمة الخطأ في المتغير  **`error_payment_func`**

\
سيتم تسجيل الخطأ وفقًا لآخر وظيفة في الحاسبة
{% endhint %}

بعد أن تقوم بإعداد الدفع بشكل صحيح وتوليد رابط لإجراء الدفع، اختبر الإعدادات التي تم إنشاؤها.&#x20;

## كيفية إضافة وصف للدفع

يمكنك إضافة وصف إلى الدفع عبر تعيين المتغير **payment\_description**

<div data-with-frame="true"><figure><img src="/files/1643448d768a1d3865bf2cc64f8fcdf16a3ed6d4" alt="" width="563"><figcaption></figcaption></figure></div>

سيظهر هذا الوصف في نموذج الدفع وكذلك في الإيصال.

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

إذا تم الدفع بنجاح، فسيصل إلى محادثة العميل (قسم "العملاء") <mark style="color:برتقالي;">**تلقائيًا**</mark> سيصل كولباك يتكون من 10 أحرف من المفتاح السري لنظام الدفع، وكلمة \_success ثم مبلغ الدفع بعد مسافة. **يتم توليد الكولباك تلقائيًا**، ولا تحتاج إلى تكوينه بنفسك أو طلبه من دعم نظام الدفع،&#x20;

مثلًا: `ovg58keefc_success 1500`، حيث:&#x20;

ovg58keefc : 10 أحرف من المفتاح السري لنظام الدفع

\_success : نتيجة معالجة الطلب (دفعة ناجحة)

1500 : مبلغ الدفع

{% hint style="success" %}
نلفت الانتباه!&#x20;

الكولباك مرئي لك فقط في المحادثة مع العميل.&#x20;

لا يرى العميل الكولباك، لكن يمكنك إعداد رد فعل على المعالجة الناجحة للدفع.
{% endhint %}

### مثال

إعدادات البلوك مع الوظيفة `get_robokassa_payment_url:`

1. إذا كنت تعرض الرابط في النص:

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

{% hint style="warning" %}
مهم!&#x20;

رابط الدفع فريد: لا يمكن نسخه ثم إرساله إلى عملاء آخرين!&#x20;

أرسل رابط الدفع عبر متغير في البوت (انظر الشكل 17).&#x20;
{% endhint %}

الكولباك عند الدفع الناجح:

<div data-with-frame="true"><figure><img src="/files/3ef64a316743e7177f74af1cfcc8ae7ff095206b" alt="" width="563"><figcaption></figcaption></figure></div>

2. الرابط في الزر:

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

تشغيل البلوك:

<div data-with-frame="true"><figure><img src="/files/8bafbf565145e6d4f6ef56d17c5b314128699a72" alt="" width="563"><figcaption></figcaption></figure></div>

الكولباك عند الدفع الناجح:

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

## إنشاء رابط باستخدام المتغير payment\_sum والمعلمات الإضافية

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

{% hint style="info" %}
**انتبه:** للمتغير **payment\_sum** تُسند القيمة في النهاية، بعد المتغيرات الاختيارية **payment\_description, product\_name** إلخ.&#x20;
{% endhint %}

لتوليد رابط الدفع، عليك تعيين قيمة المتغير **payment\_sum**، وبعد ذلك مباشرة سيظهر المتغير **robokassa\_pay\_url.** يمكن عرض هذا المتغير كرابط أو وضعه على زر يحمل النص "الدفع".&#x20;

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

**مثال على تشغيل البلوك (روابط الدفع):**

<div data-with-frame="true"><figure><img src="/files/53a6e3bce516e0c33a03b3337ab222f9c6aba1f0" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
مهم!&#x20;

رابط الدفع فريد: لا يمكن نسخه ثم إرساله إلى عملاء آخرين!&#x20;

أرسل رابط الدفع عبر متغير في البوت
{% endhint %}

لتمرير الرابط في الزر، حدِّد المتغير في الزر في حقل url:

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

### نتيجة الدفع عند إنشاء رابط الدفع عبر payment\_sum

بعد الدفع الناجح سيصل إلى البوت كولباك. هذا الكولباك تراه في النظام كرسالة من المستخدم، ولكي لا يتمكن المستخدم من إرساله، فإنه يتكون من كلمة المرور الأولى من خدمة Robokassa وإضافة مع حالة success، مثلًا: **qxgZ7zkNX4HHnG8UpZ61\_success.**

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

كما أنه بعد الدفع الناجح يتم ضبط المتغير **robokassa\_payment\_completed** على **True.**

هذا الكولباك **لا يراه** المستخدم، إذ تظهر فقط للمشغّل

{% hint style="danger" %}
يجب أن يكون نوع المطابقة "**تطابق تام**"
{% endhint %}

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

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

## كيفية إنشاء مخطط تجريبي

مثال على مخطط سيسمح لك باختبار خدمة Robokassa والبدء بسرعة في العمل معها:

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

في الصورة مثال على البلوك الأول، حيث يُسأل المستخدم كم يريد أن يدف&#x639;**.**

في الصورة أدناه إعدادات السهم، ويجب أن يكون مفتاح "المستخدم يُدخل البيانات" مفعّلًا وأن تكون المتغيرات مكتوبة في الحقل **payment\_sum:**

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

ثم في بلوك الدفع التالي أضف زرًا وضع في سطر url المتغير **robokassa\_pay\_url:**

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

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

سيعمل المخطط على النحو التالي:

<div data-with-frame="true"><figure><img src="/files/919f04658773af028abd63e80cc785706d6df16c" alt="" width="563"><figcaption></figcaption></figure></div>

عند النقر على الزر سيصبح المبلغ الذي أدخله العميل متاحًا للدفع.

بعد الدفع سيصل كولباك يمكن أيضًا إعداد رد فعل عليه.&#x20;

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

{% hint style="info" %}
مهم!&#x20;

لا يوجد في Robokassa كولباك خاص بالدفع غير الناجح.
{% endhint %}

لذلك أضف بلوكًا آخر مع شرط، وفي سطر الشرط اكتب كولباكًا بالشكل "**qxgZ7zkNX4HHnG8UpZ61\_success":**

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

{% hint style="info" %}
اضبط نوع التحقق بالضرورة على "تطابق تام"
{% endhint %}

سيعمل المخطط على النحو التالي:

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

## كيفية إنشاء طلب الفوترة الضريبية

### في الزر ذو الوظيفة “الدفع”

عند إنشاء الزر في القائمة المنسدلة “البيانات اللازمة لإنشاء الإيصال”، املأ الحقول “اسم المنتج”، “المبلغ الكامل بالروبل”، “الكمية”، “معدل ضريبة القيمة المضافة”، “نظام الضرائب”.

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

بالتفصيل في قسم "[لإنشاء الإيصال](#dlya-formirovaniya-cheka)".

### باستخدام المتغير payment\_sum

نظرًا لأن إنشاء الرابط يتم في اللحظة التي ضبطت فيها قيمة المتغير payment\_sum، عليك تعيين المتغيرين products\_for\_receipt و robokassa\_sno.

{% hint style="warning" %}
مهم:&#x20;

* عند إنشاء الرابط عبر المتغير payment\_sum، يتم تعيين النظام الضريبي في المتغير robokassa\_sno.
* يجب أن يساوي payment\_sum التكلفة الإجمالية لجميع المنتجات (مجموع جميع معلمات sum).
  {% endhint %}

مثال:

session\_timeout = 7200

product\_name = أول دفعة

robokassa\_sno = osn

products\_for\_receipt = \[{"name": "اسم المنتج", "quantity": 2, "sum": 2, "tax": "none"}, {"name": "اسم المنتج 2", "quantity": 1, "sum": 6, "tax": "none"}]

payment\_sum = 10

### بالنسبة للوظيفتين get\_robokassa\_payment\_url و robokassa\_recurrent\_payment

عند استدعاء الوظائف **get\_robokassa\_payment\_url** أو الوظيفة **robokassa\_recurrent\_payment** مرِّر كوسائط المتغيرات **taxation** و **products\_for\_receipt** وفقًا للوصف أدنا&#x647;**.**

ستجهز الوظائف الرابط مع مراعاة تشكيلة السلع وستنشئ طلبًا للفوترة الضريبية.

{% hint style="warning" %}
مهم:

المتغيرات **taxation** و **products\_for\_receipt** يجب تحديدها لكل دفعة على حدة.

لا تخزن خدمة Robokassa هذه المعلمات، ولن تتمكن من إجراء الفوترة الضريبية للمدفوعات التي لم تُمرر لها تشكيلة السلع.
{% endhint %}

1. **products\_for\_receipt** - مصفوفة تحتوي على تشكيلة السلع.&#x20;

يجب تمثيل كل وحدة من المنتج في صورة قاموس يحتوي على المعلمات **name, quantity, sum, tax, payment\_method, payment\_object and nomenclature\_code**.

\
&#x20;<mark style="color:أحمر;">**!**</mark>**&#x20;products\_for\_receipt** يجب تحديده بالتنسيق التالي:

\[

{"name": "اسم المنتج", "quantity": "كمية المنتج", "sum": "سعر المنتج", "tax": "معدل ضريبة القيمة المضافة"},

{"name": "اسم المنتج 2", "quantity": "كمية المنتج 2", "sum": "سعر المنتج", "tax": "معدل ضريبة القيمة المضافة"}

]

حيث،&#x20;

1\) **name** - اسم المنتج. إذا كنت تستخدم رموزًا خاصة في اسم المنتج، مثل علامات الاقتباس، فيجب إخفاؤها دائمًا.

2\) **quantity** - كمية أو وزن المنتج (عدد صحيح أو كسري عبر النقطة)

3\) **sum** أو **amount** (*إلزامي، اسمان بديلان*) - المبلغ الكامل بالروبل لجميع كميات هذا المنتج مع مراعاة جميع الخصومات المحتملة والمكافآت والأسعار الخاصة.

4\) **tax** أو **vat\_code** - (إلزامي، اسمان بديلان، والقيمة تعتمد على الاسم) - معدل ضريبة القيمة المضافة. هذه المعلمة تحدد معدل الضريبة في جهاز الدفع النقدي.

{% tabs %}
{% tab title="القيم لـ tax:   " %}

<table data-full-width="true"><thead><tr><th width="272"> القيمة</th><th>الوصف</th></tr></thead><tbody><tr><td>none</td><td>بدون ضريبة قيمة مضافة</td></tr><tr><td>vat0</td><td>ضريبة قيمة مضافة بنسبة 0%</td></tr><tr><td>vat5</td><td>ضريبة قيمة مضافة بنسبة 5%</td></tr><tr><td>vat12</td><td>ضريبة قيمة مضافة بنسبة 12%</td></tr><tr><td>vat16</td><td>ضريبة قيمة مضافة بنسبة 16%</td></tr></tbody></table>
{% endtab %}

{% tab title="القيمة لـ vat\_code:" %}

<table><thead><tr><th width="209">القيم</th><th> الوصف</th></tr></thead><tbody><tr><td>'1' </td><td>بدون ضريبة قيمة مضافة</td></tr><tr><td>'2' </td><td>ضريبة قيمة مضافة بنسبة 0%</td></tr><tr><td>'8'</td><td>ضريبة قيمة مضافة بنسبة 5%</td></tr><tr><td>'15'</td><td>ضريبة قيمة مضافة بنسبة 12%</td></tr><tr><td>'14'</td><td>ضريبة قيمة مضافة بنسبة 16%</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

5\) **method** أو **payment\_method** - (اسمان بديلان، معلمة اختيارية) علامة على طريقة التسوية.&#x20;

<table><thead><tr><th width="345" align="center">القيم الممكنة للمعلمة:</th><th>ما الذي تعنيه القيمة: </th></tr></thead><tbody><tr><td align="center">full_prepayment</td><td>دفعة مقدمة 100%. دفع مسبق كامل قبل لحظة تسليم موضوع التسوية</td></tr><tr><td align="center">prepayment</td><td>دفعة مقدمة. دفعة مسبقة جزئية قبل لحظة تسليم موضوع التسوية</td></tr><tr><td align="center">advance</td><td>دفعة مقدمة</td></tr><tr><td align="center">full_payment </td><td>تسوية كاملة. دفع كامل، بما في ذلك مع الأخذ بعين الاعتبار الدفعة المقدمة (الدفع المسبق) عند لحظة تسليم موضوع التسوية؛</td></tr><tr><td align="center">partial_payment </td><td>تسوية جزئية وشراء بالدَّين. دفع جزئي لموضوع التسوية عند تسليمه مع سداد لاحق بالدَّين؛</td></tr><tr><td align="center">credit </td><td>التسليم بالدَّين. تسليم موضوع التسوية دون دفعه عند لحظة التسليم مع السداد لاحقًا بالدَّين؛</td></tr><tr><td align="center">credit_payment</td><td>سداد الدَّين. دفع موضوع التسوية بعد تسليمه مع الدفع بالدَّين (سداد الدَّين).</td></tr></tbody></table>

6\) **object** أو **payment\_object** - (خياران للاسم، وسيط اختياري) موضوع التسوية (إذا لم يتم تمريره، فسيكون commodity (سلعة))

<table><thead><tr><th width="328" align="center">القيم الممكنة للمعامل</th><th>ما الذي تعنيه القيمة</th></tr></thead><tbody><tr><td align="center"><strong>commodity</strong></td><td>سلعة. عن السلعة المعروضة للبيع، باستثناء السلعة الخاضعة للضريبة الانتقائية (الاسم وبيانات أخرى تصف السلعة)</td></tr><tr><td align="center"><strong>excise</strong> </td><td>سلعة خاضعة للضريبة الانتقائية. عن السلعة الخاضعة للضريبة الانتقائية المعروضة للبيع (الاسم وبيانات أخرى تصف السلعة)</td></tr><tr><td align="center"><strong>job</strong></td><td>عمل. عن العمل الجاري تنفيذه (الاسم وبيانات أخرى تصف العمل)</td></tr><tr><td align="center"><strong>service</strong></td><td>خدمة. عن الخدمة المقدمة (الاسم وبيانات أخرى تصف الخدمة)</td></tr><tr><td align="center"><strong>gambling_bet</strong></td><td>رهان لعبة قمار. عن قبول الرهانات عند ممارسة أنشطة تنظيم ألعاب القمار</td></tr><tr><td align="center"><strong>gambling_prize</strong></td><td>ربح لعبة قمار. عن دفع أموال على شكل ربح عند ممارسة أنشطة تنظيم ألعاب القمار</td></tr><tr><td align="center"><strong>lottery</strong></td><td>تذكرة يانصيب. عن قبول الأموال عند بيع تذاكر اليانصيب وتذاكر اليانصيب الإلكترونية، وقبول رهانات اليانصيب عند ممارسة أنشطة تنظيم اليانصيب</td></tr><tr><td align="center"><strong>lottery_prize</strong></td><td>ربح اليانصيب. عن دفع أموال على شكل ربح عند ممارسة أنشطة تنظيم اليانصيب</td></tr><tr><td align="center"><strong>intellectual_activity</strong> </td><td>توفير نتائج النشاط الفكري. عن منح حقوق استخدام نتائج النشاط الفكري أو وسائل التمييز الفردي</td></tr><tr><td align="center"><strong>payment</strong></td><td>دفعة. عن السلفة، العربون، الدفع المسبق، الائتمان، المساهمة ضمن السداد، الغرامة، الجزاء، المكافأة، البونص، وأي موضوع تسوية مشابه آخر</td></tr><tr><td align="center"><strong>agent_commission</strong> </td><td>أتعاب الوكيل. عن مكافأة المستخدم الذي يكون وكيلاً للدفع (وكيلًا فرعيًا)، أو وكيل دفع مصرفيًا (وكيلًا فرعيًا)، أو مفوضًا بالبيع، أو مفوضًا، أو أي وكيل آخر؛</td></tr><tr><td align="center"><strong>composite</strong></td><td>موضوع تسوية مركب. عن موضوع تسوية يتكون من عناصر يمكن لكل منها أن تُسند إليها قيمة من الخصائص المذكورة أعلاه</td></tr><tr><td align="center"><strong>another</strong></td><td>موضوع تسوية آخر. عن موضوع تسوية لا يندرج ضمن موضوعات التسوية المذكورة أعلاه</td></tr><tr><td align="center"><strong>property_right</strong></td><td>حق ملكية</td></tr><tr><td align="center"><strong>non-operating_gain</strong></td><td>دخل غير تشغيلي</td></tr><tr><td align="center"><strong>insurance_premium</strong></td><td>اشتراكات التأمين</td></tr><tr><td align="center"><strong>sales_tax</strong></td><td>رسم تجاري</td></tr><tr><td align="center"><strong>resort_fee</strong></td><td>رسم منتجعي</td></tr></tbody></table>

7\) **nomenclature\_code** - (إلزامي بصورة مشروطة) ترميز السلعة: يُمرَّر كما هو مطبوع على عبوة السلعة.&#x20;

{% hint style="warning" %}
هذا المعامل إلزامي فقط للمتاجر التي تبيع سلعًا خاضعة للوسم الإلزامي.&#x20;

يوجد رمز الوسم على عبوة السلعة، بجانب الباركود أو على شكل رمز QR.
{% endhint %}

{% hint style="warning" %}
مهم! من أجل التحويل الضريبي، من المهم تمرير معاملات الإيصال.&#x20;

يتم تمرير الشكل الصحيح للإيصال على النحو التالي:

rec = \[{"name": "باقة شهر واحد", "quantity": 1, "sum": 4800, "tax": "none"}]

response = robokassa\_recurrent\_payment(4800, 'التدريب في مدرسة الطيران Aviator', 'ru', rec, 'osn')

حيث يلزم إدخال بياناتك الخاصة.&#x20;
{% endhint %}

## إنشاء الإيصال عند قبول الدفع في الدورات على صفحة الدورة

يجب اختيار نظام الدفع Robokassa في قسم "الدفع" ضمن إعدادات الدورة:

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

املأ في قسم "الاستحواذ" ضمن إعدادات نظام الدفع (إذا لم تكن قد فعلت ذلك سابقًا) حقل "معدل ضريبة القيمة المضافة".

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

## ما الأخطاء الممكنة

#### رمز الخطأ 40

«لا يمكن إعادة دفع الفاتورة نفسها بالرقم ذاته».

بعد نجاح عملية الدفع، يجب نقل الحوار إلى كتلة "نهاية جمع البيانات"، حتى يتم إنشاء رقم دفع جديد.

#### رمز الخطأ 34

«خدمة المدفوعات المتكررة غير مسموح بها للمتجر».

#### رمز الخطأ 31

«مبلغ الدفع غير صحيح».

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

#### رمز الخطأ 29

«Signature غير صالح»

قد تكون هناك عدة أسباب هنا، لكنها جميعًا مرتبطة بالسكربت المسؤول عن تهيئة الدفع (وبالتحديد الجزء الذي يُنشئ المعامل Signature وفق صيغة تتكون من متغيرات). يظهر هذا الخطأ كثيرًا، وهذه 3 أسباب محتملة:

* **الأول:** معرّف المتجر (MerchantLogin) غير صحيح؛
* **الثاني:** كلمة المرور 1 (MerchantPass1) غير صحيحة؛
* **الثالث:** أنت تستخدم معاملات إضافية (sh&#x70;**\_**)، وهي مضافة في الشيفرة البرمجية لصندوق الدفع، لكنها غير مُدرجة في صيغة الحساب - أو بالعكس، فهي مذكورة في صيغة الحساب وليست موجودة في الشيفرة. إذا كانت مستخدمة، فمرّرها بترتيب أبجدي - سواء في معاملات الدفع أو في صيغة حساب Signature.

مهم! إذا كنت تعمل في الوضع التجريبي، مع تمرير المعامل IsTest=1 أو تفعيله بعلامة في إعدادات الوحدة/البوت، فاستخدم فقط زوج كلمات المرور التقنية التجريبية (تبويب «الإعدادات التقنية» في بطاقة متجرك).

#### رمز الخطأ 23

«لا يمكن إنشاء دفعة تجريبية. المتجر لا يحتوي على إعدادات المعاملات التجريبية».

وهذا يعني أنك قبل إجراء الدفع التجريبي لم تُدخل جميع البيانات المطلوبة في كتلة «معلمات إجراء المدفوعات التجريبية» ضمن تبويب «الإعدادات التقنية».

#### رمز الخطأ 25

«المتجر غير مفعّل».

يظهر هذا الخطأ كثيرًا، وقد يكون له سببان.

* **الأول:** هذا صحيح بالفعل - ويجب تفعيل المتجر أولًا، ثم إصدار الفاتورة بعد ذلك.
* **الثاني:** لقد أدخلت معرّف المتجر بشكل غير صحيح في الإعدادات التقنية على الموقع. يمكن الاطلاع على المعرّف الصحيح في قسم «متاجري» في لوحة التحكم الشخصية. انتقل إلى تبويب «الإعدادات التقنية» وابحث عن حقل «معرّف المتجر». انسخ المعرّف وأدخله في إعدادات الموقع.

## **كيفية إجراء المدفوعات التلقائية لخدمة Robokassa**

تعليمات خطوة بخطوة لتوصيل المدفوعات التلقائية للخدمة **Robokassa**

**الخطوة 1. تفعيل المدفوعات التلقائية في زر الدفع**

انتقل إلى إعدادات الكتلة التي تضع فيها رابط الدفع، ثم انتقل إلى إعدادات الزر:

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

بعد ذلك، في إعدادات الزر ابحث عن مربع الاختيار "المدفوعات التلقائية" وفعّله:

<div data-with-frame="true"><figure><img src="/files/64a1e2410d24c8e3ea1bc3485594bb2f720a547e" alt="" width="563"><figcaption></figcaption></figure></div>

إذا كنت ترغب في قبول المدفوعات التلقائية في جميع أزرار الدفع، فيمكن تفعيل المدفوعات التلقائية في إعدادات ربط نظام الدفع:

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

**الخطوة 2. إجراء دفعة عادية.**\
\
بعد ذلك يجب إجراء دفعة عادية (الحصول على رابط الدفع ثم أن يدفعه العميل)، كما هو موضح أعلاه. بعد نجاح الدفع سيظهر لدى العميل المتغير **robokassa\_previous\_invoice\_id** مع معرّف الدفع.

{% hint style="warning" %}
المتغير **robokassa\_previous\_invoice\_id** إلزامي للمدفوعات اللاحقة.\
\
إذا حذفته، فلن يكون من الممكن إجراء الدفع التلقائي التالي.
{% endhint %}

{% hint style="danger" %}
نلفت الانتباه!&#x20;

<mark style="color:أحمر;">**أوقف**</mark> مربع الاختيار "**المدفوعات في الوضع التجريبي**" (إذا كان مفعّلًا لديك)، وإلا فلن يتم إنشاء المتغير robokassa\_previous\_invoice\_id مع معرّف الدفع!&#x20;

![](/files/91ebe2e7ad29829d721e98f68ef4845e48db720d)
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/4854ee15da15d6f2ae5e7690fa9530e0848dd564" alt=""><figcaption><p>مثال على إنشاء رابط لدفع عادي</p></figcaption></figure></div>

<div data-with-frame="true"><img src="https://lh4.googleusercontent.com/FGVcl0wzMK3_ldq7OxHe3653Q3buEgR29657HixPQ6xUrqoa2E2TpG3yCRdF5oDgj69VhnQRlZJZG_wjnnwQyIjkHRTQ8nr-Jzwyo99CtaiOT5JUuiMLuE2Jm3MDTBxKXJoD02gr=s0" alt=""></div>

**الخطوة 3. نخطط للخصم التلقائي**

من كتلة الدفع الناجح نخطط لسهم مع مؤقت إلى الكتلة التي تحتوي على الدفع التلقائي. على سبيل المثال، سنخطط للدفع التالي بعد 30 يومًا.&#x20;

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

حتى يتم تنفيذ الدفع التلقائي في الكتلة المطلوبة في حقل Calculator، يجب إضافة استدعاء الدالة **robokassa\_recurrent\_payment**، مع تمرير المعاملات إليها بالترتيب المحدد:&#x20;

1. **payment\_amount** - مبلغ الدفع (سعر السلعة بالروبل)
2. **description** - اسم السلعة. في هذا الحقل يمكن استخدام أحرف الأبجدية الإنجليزية أو الروسية، والأرقام، وعلامات الترقيم فقط. الحد الأقصى للطول هو 100 حرف. تظهر هذه المعلومات في واجهة Robokassa وفي الإيصال الإلكتروني الذي يتلقاه العميل بعد نجاح الدفع.&#x20;
3. **country** - نطاق الدولة (‘ru’ أو ‘kz’)
4. **products\_for\_receipt** - معاملات إنشاء الإيصالات.

{% hint style="info" %}
مزيد من التفاصيل في قسم "كيفية إنشاء طلب للتحويل الضريبي -> [بالنسبة للوظيفتين get\_robokassa\_payment\_url و robokassa\_recurrent\_payment](#dlya-funkcii-get_robokassa_payment_url-i-robokassa_recurrent_payment)
{% endhint %}

5. **taxation** - نظام الضرائب.&#x20;

{% hint style="info" %}
مزيد من التفاصيل في قسم "كيفية إنشاء طلب للتحويل الضريبي -> [بالنسبة للوظيفتين get\_robokassa\_payment\_url و robokassa\_recurrent\_payment](#dlya-funkcii-get_robokassa_payment_url-i-robokassa_recurrent_payment)
{% endhint %}

مثال على طلب للدفع التلقائي:

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

{% hint style="warning" %}
عند تنفيذ الدفع التلقائي، لا ينبغي أن يكون هناك رابط دفع روبوكاسا والمتغير **payment\_sum**!
{% endhint %}

*<mark style="color:أزرق;">الخطوة 4. نخطط للخصومات المنتظمة ونضبط إمكانية إلغاء المدفوعات التلقائية.</mark>*\
\
لإعادة الدفع بشكل منتظم، نخطط لحلقة - سهم مع تأخير، مثلًا 30 يومًا.

<div data-with-frame="true"><figure><img src="/files/33e698efd6331f81a7317e4ee492e0c93d4a421c" alt=""><figcaption><p>حلقة - انتقال متكرر إلى كتلة الدفع التلقائي</p></figcaption></figure></div>

إذا كانت لديك إمكانية إلغاء المدفوعات التلقائية، فلكي لا يتم تنفيذ الدفعة التالية يجب حذف المتغير `robokassa_previous_invoice_id`\
\
للقيام بذلك نحذف المتغير في حقل Calculator:\
\
`robokassa_previous_invoice_id = ""`

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

### دفعة عادية مع تفعيل المدفوعات التلقائية

إذا كانت المدفوعات التلقائية مفعلة، لكنك تحتاج إلى رابط بدون اشتراك (بدون مدفوعات تلقائية)، فقبل إنشاء الرابط يجب تعيين المتغير robokassa\_manual\_recurrent\_disable بالقيمة 1\
\
في حقل Calculator سنعلن المتغير:\
`robokassa_manual_recurrent_disable = 1`

<div data-with-frame="true"><figure><img src="/files/01d8ab8497a898cb515f28844db23250d5b6fe93" alt=""><figcaption><p>إعدادات الكتلة لإنشاء رابط لدفع عادي مع تفعيل المدفوعات التلقائية</p></figcaption></figure></div>

{% hint style="info" %}
تنبيه!&#x20;

الردّ الراجع عند المدفوعات التلقائية مطابق للردّ الراجع الذي يصل عند المدفوعات الناجحة.&#x20;

شرح كيفية ضبط الاستجابة للردّ الراجع موجود في قسم "[كيفية معالجة النتيجة](#kak-obrabotat-rezultat)"
{% endhint %}

## ما متطلبات خدمة Robokassa لروبوتات الدردشة

الرد الرسمي من خدمة Robokassa:

> يمكنك عرض السلعة في المتجر مع وصف وسعر وقبول الدفع في البوت، ويمكنك إنشاء صفحة واحدة تحتوي على الوصف والسعر وبيانات الاتصال والإشارة إلى أن تسليم السلعة/تقديم الخدمة إلكتروني. يجب أن يكون لدينا ربط بالسلعة في المتجر أو بالموقع، لأننا لا نستطيع معرفة ما الذي تبيعه في بوتك وأي بوت هو بوتك.
>
> لا ندرج رابط قناة تليغرام ضمن URL. وكذلك متطلبات محتوى الموقع: "يجب أن يكون الموقع عاملًا، بمحتوى مكتمل، وروابط داخلية تعمل.
>
> يجب أن تكون السلع والخدمات على موقعك موصوفة بالتفصيل: يجب أن يشمل الوصف خصائص السلع والخدمات المعروضة، وخصائصها الاستهلاكية، والسعر الحالي.
>
> يجب أن تحتوي صفحتك على معلومات محدثة: الهاتف، البريد الإلكتروني، قواعد إتمام الطلب ومواعيد تنفيذه، شروط الدفع والتسليم والإرجاع.
>
> يتم النظر في كل موقع بشكل فردي.

## Robokassa في تيليغرام

### ربط البوت التجريبي RobokassaPaymentTestBot.

1. عند اختيار Connect Robokassa Test ينتقل المستخدم إلى البوت RobokassaPaymentTestBot.
2. يضغط المستخدم على زر /ابدأ.
3. يتلقى المستخدم ردًا من البوت: «أدخل معرّف المتجر».
4. يجب إدخال معرّف المتجر في خدمة Robokassa.
5. سيطلب البوت تأكيدًا يثبت ملكية المتجر عبر إرسال رسالة SMS إلى الرقم المذكور في المتجر: «تم إرسال رسالة SMS إلى الرقم \*%%%%» حيث %%%% هي آخر 4 أرقام من رقم الهاتف
6. يدخل المستخدم رمزًا من 6 أرقام.
7. إذا نجح كل شيء فستظهر للمستخدم الرسالة: “لقد قمت بربط البوت @BotName بنجاح مع Robokassa. سيُعلمك @BotFather بالرمز الجديد.”
8. بعد ذلك يظهر في BotFather رمز دفع يمكن ربط المدفوعات به.

### ربط البوت الحي RobokassaPaymentBot.

1. عند اختيار Connect Robokassa Live ينتقل المستخدم إلى البوت RobokassaPaymentBot،
2. يضغط المستخدم على زر /ابدأ.
3. يتلقى المستخدم ردًا من البوت: «أدخل معرّف المتجر».
4. يجب إدخال معرّف المتجر في خدمة Robokassa.
5. سيطلب البوت تأكيدًا يثبت ملكية المتجر عبر إرسال رسالة SMS إلى الرقم المذكور في المتجر: «تم إرسال رسالة SMS إلى الرقم \*%%%%»، حيث %%%% هي آخر 4 أرقام من رقم الهاتف
6. يدخل المستخدم رمزًا من 6 أرقام.
7. إذا نجح كل شيء فستظهر للمستخدم الرسالة: “لقد قمت بربط البوت @BotName بنجاح مع Robokassa. سيُعلمك @BotFather بالرمز الجديد.”
8. بعد ذلك يظهر في BotFather رمز دفع يمكن ربط المدفوعات به.

معالجة نتائج الدفع مماثلة لما هو موصوف [هنا](#kak-poluchit-uvedomlenie-o-rezultate-oplaty)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.mavibot.ai/doc/ar/integrations/payment/rwbwkasa-kz.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.