# تيليجرام
## كيفية ربط نظام الدفع
### نظام الدفع مدمج داخل تيليغرام.
من أجل إجراء المدفوعات داخل المراسِل، تحتاج إلى:
* ربط نظام الدفع بالبوت في بوت فاذر
* اذهب إلى إعدادات البوت المطلوب ومن القائمة اختر Payments
* اتبع التعليمات لربط نظام دفع متاح ونسخ الرمز المميز الصادر
## كيفية إصدار فاتورة للعميل
لإرسال فاتورة إلى تيليغرام استخدم الطريقة
tg\_send\_invoice(provider\_token, platform\_id, title, description, currency, prices, photo\_url, payload, protect\_content, disable\_notification, need\_name, phone\_number, need\_email, reply\_to\_message\_id, reply\_markup, reply\_id) - المعلمات المطلوبة مميزة بالخط العريض
**provider\_token** - الرمز المميز المستلم في Botfather، بعد ربط نظام الدفع
**platform\_id** - المستلم - معرّف المستخدم أو المجموعة أو القناة
**title** - عنوان العنصر، من 1 إلى 32 حرفًا
**description** - وصف السلع، من 1 إلى 255 حرفًا
**currency** - عملة الدفع (RUB، USD، UAH وما إلى ذلك )
**payload** - الجزء الأول من العملة حول الدفع، افتراضيًا tg\_payment
**prices** - تفصيل السعر (الوصف أدناه)
**photo\_url** - رابط صورة المنتج
**disable\_notification** - 1 - الإرسال مع إشعار، 0 - بدون إشعار
**protect\_content** - 1 حماية من النسخ وأخذ لقطات الشاشة، 0 - غير محمي
**need\_name** - 1 إذا كنت تحتاج إلى اسم المستخدم الكامل لإتمام الطلب، 0 - بدون طلب اسم
**need\_phone\_number** - 1 إذا كنت تحتاج إلى رقم هاتف المستخدم لإتمام الطلب، 0 - بدون طلب الرقم
**need\_email** - 1 إذا كنت تحتاج إلى عنوان البريد الإلكتروني للمستخدم لإتمام الطلب، 0 - بدون طلب البريد
**reply\_to\_message\_id** - معرّف الرسالة التي نرد عليها، '' ليس الرد
**reply\_markup** - لوحة المفاتيح، يجب أن يكون الزر الأول زرًا من نوع الدفع
إذا تم تحديد أحد المعلمات need\_name أو need\_phone\_number أو need\_email، فسيطلب من المستخدم البيانات قبل الدفع وسيتم حفظها في متغيرات العميل إذا نجحت عملية الدفع. في لقطة الشاشة أدناه طلب إدخال جميع البيانات:
**prices** - مصفوفة من المصفوفات تحتوي على بيانات تكلفة السلع والخدمات الإضافية (التوصيل، التغليف، إلخ). تُعرض في صفحة الدفع. يجب تحديد المبلغ إما كعدد صحيح مثل 125 أو ككسر باستخدام النقطة 120.25. على سبيل المثال: \[\["goods", 2000], \["VAT", 20.75], \["packaging", 100]]
## ردّ على الدفع
بعد نجاح الدفع في الدردشة مع المستخدم ستصل رسالة رد كما يلي:
**phone\_best 4737685 2120.75 UAH 1955518436**
حيث إن phone\_best - payload - من طلب إنشاء الفاتورة 473737685 - معرّف الدردشة التي أُرسلت إليها الفاتورة في الأصل 2120.75 - المبلغ الكامل للدفع UAH - العملة 1955518436 - معرّف الدفع في نظام التاجر
أيضًا، إذا طلبت اسمًا أو رقم هاتف و/أو بريدًا إلكترونيًا، فسيسجل العميل المتغيرات:
**tg\_payment\_name, tg\_payment\_phone** و **tg\_payment\_email**
{% hint style="info" %}
في حال النجاح، سيتم إرسال الرد إلى الرسائل الشخصية للمستخدم. وللقيام بذلك، يجب أن يكون العميل والبوت قد تفاعلا قبل الدفع (يجب أن يكون العميل مشتركًا في البوت)!
{% endhint %}
{% hint style="info" %}
بعد استلام الخطاف بشأن الدفع، سيتم تأكيد الدفع تلقائيًا عبر answerPreCheckoutQuery .
{% endhint %}
## أمثلة
`prices = [["product", 2000], ["NDS", 20.75], ["package", 100]]` \
`result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'phoneW-200', 'Best Model on the Market', 'UAH', prices, 'https://images11.popmeh.ru/cropped.jpg', 'phone_best', 0, 0, 1, 0, 1)`
### مثال مع الحد الأدنى من المعلمات
`prices = [["an amazing product", 20000]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'The best bot ever!',`` ``'دورة مذهلة! كن الأفضل!'``, 'UAH', prices)`
### مثال مع لوحة مفاتيح
`prices = [["product", 2000], ["NDS", 20.75], ["package", 100]] result = tg_send_invoice('632593626:TEST:sandbox_i38014109763', platform_id, 'Phone W-200', 'BEst Model on the Market', 'UAH', prices, 'https://helpix.ru/news/200405/181746/gf200_2.jpg', 'phone_best', 0, 0, 1, 1, 1, '', '{"inline_keyboard": [[{"text":"Pay", "pay":"True"}], [{"text":"One more button", "callback_data": "One more button"}]]}')`
---
# 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/telegram.md?ask=
```
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.