تيليجرام

كيفية ربط نظام الدفع

نظام الدفع مدمج داخل تيليغرام.

من أجل إجراء المدفوعات داخل المراسِل، تحتاج إلى:

• ربط نظام الدفع بالبوت في بوت فاذر

• اذهب إلى إعدادات البوت المطلوب ومن القائمة اختر 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 وما إلى ذلك https://core.telegram.org/bots/payments#supported-currencies)

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

في حال النجاح، سيتم إرسال الرد إلى الرسائل الشخصية للمستخدم. وللقيام بذلك، يجب أن يكون العميل والبوت قد تفاعلا قبل الدفع (يجب أن يكون العميل مشتركًا في البوت)!

بعد استلام الخطاف بشأن الدفع، سيتم تأكيد الدفع تلقائيًا عبر answerPreCheckoutQuery https://core.telegram.org/bots/api#answerprecheckoutquery .

أمثلة

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"}]]}')