كيفية ربط نظام الدفع
نظام الدفع مدمج في تيليجرام. لقبول المدفوعات داخل المراسلة، يجب عليك:
- ربط نظام دفع بالبوت الخاص بك باستخدام BotFather.
- الانتقال إلى إعدادات البوت المطلوبة واختيار "المدفوعات" من القائمة.
اتبع التعليمات لربط نظام دفع متاح وانسخ الرمز المقدم.
كيفية إصدار فاتورة للعميل
لإرسال فاتورة في تيليجرام، استخدم الطريقة وحدد المعلمات المطلوبة.
tg_send_invoice(provider_token, platform_id, title, description, currency, prices, photo_url, payload, protect_content, disable_notification, need_name, need_phone_number, need_email, reply_to_message_id, reply_markup, message_thread_id, provider_data)
مهم! يجب تمرير جميع المعلمات بالترتيب المحدد في الدالة. إذا كنت بحاجة إلى تحديد معلمة معينة وتجاهل الأخرى، اترك قيمًا فارغة أو قيمًا كما هو محدد في الوثائق للمعلمات التي لا تحتاجها.
مثال:
إذا تم تمكين أي من المعلمات need_name أو need_phone_number أو need_email، سيُطلب من المستخدم تقديم تلك المعلومات قبل إتمام الدفع. عند نجاح الدفع، يتم حفظ البيانات في متغيرات العميل المقابلة.
مثال:
النتيجة: يتم طلب البيانات قبل الدفع.
رد الدفع
إذا نجح الدفع، سيتم إرسال رد بالمحتوى التالي إلى محادثة المستخدم:
tg_payment 1372995196 120.75 USD 2ff747b9-000f-5000-b000-16d7e3517aa', حيث
- course_pay - الحمولة - الحمولة من طلب إنشاء الفاتورة الأصلي؛
- 1372995196 - معرف المحادثة حيث تم إرسال الفاتورة أصلاً؛
- 120.75 - المبلغ الإجمالي للدفع؛
- USD - العملة؛
- 2ff747b9-000f-5000-b000-16d7e3517aa9 - معرف الدفع في نظام التاجر.
بالإضافة إلى ذلك، إذا تم طلب اسم المستخدم أو رقم هاتفه و/أو بريده الإلكتروني، سيتم تعيين المتغيرات المقابلة للعميل:
tg_payment_name، tg_payment_phone و tg_payment_email
سيتم إرسال رد نجاح الدفع إلى الرسائل المباشرة للمستخدم مع البوت.
يجب أن يكون لدى المستخدم محادثة موجودة مع البوت (أي يجب أن يكون قد بدأ أو اشترك في البوت) قبل إجراء الدفع. وإلا، لا يمكن للبوت إرسال الرسالة المباشرة إليه.
بمجرد استلام webhook الدفع، سيتم تأكيد الدفع تلقائيًا عبر طريقة answerPreCheckoutQuery. https://core.telegram.org/bots/api#answerprecheckoutquery
رسالة مثبتة مع زر دفع
تحتاج إلى استخدام ميزة تثبيت الرسالة بعد ربط نظام الدفع.
tg_pin_chat_message(platform_id, message_id, disable_notification)
مثال:
الخطوة 1:
prices = [["course", 100], ["VAT", 20.75]]
result=tg_send_invoice('381764678:TEST:129736', platform_id, 'Course on courses', 'Creating courses is easy', 'USD', prices, 'https://salebot.pro/promo.png', 'course_pay','0', '0', '1', '1', '1', '', '{"inline_keyboard": [[{"text":"Pay", "pay":"True"}]]}')
الخطوة 2:
كنتيجة للخطوة الأولى، ستتلقى ردًا تحتاج منه إلى استخراج قيمة message_id باستخدام الدالة get().
res=get(result,'result')
m_id=get(res,'message_id')
بعد ذلك، قم بتثبيت الرسالة: tg_pin_chat_message(#{platform_id}, #{m_id}, 1)
مثال: مجموعة الحد الأدنى من المعلمات
prices = [["super course", 100]]
result= tg_send_invoice('381764678:TEST:129736', platform_id, 'Course on courses', 'Creating courses is super easy', 'USD', prices)
مثال: لوحة المفاتيح
prices = [["course", 100], ["VAT", 20.75]]
tg_send_invoice('381764678:TEST:129736', platform_id, 'Course on courses', 'Creating courses is easy, 'USD', prices, 'https://mavibot.ai/promo.png', 'course_pay','0', '0', '1', '1', '1', '', '{"inline_keyboard": [[{"text":"Pay", "pay":"True"}], [{"text":"Another button", "callback_data": "Another button"}]]}')
