كيفية إنشاء فاتورة مدفوعات من خلال روبوتات تيلجرام Payments 2.0

إنشاء فاتورة مدفوعات من خلال روبوتات التيلجرام Payments 2.0:

يتم مراجعة (Bot API) المدفوعات للحصول على قائمة كاملة بالطرق الأمور المتاحة. حيث أنه في البداية، لا بد من القيام بعملية إنشاء المدفوعات 2.0 من خلال الروبوتات التي تقدم الخدمات والمنتجات، من ثم تقديم خيارات الشحن والدفع.

إنشاء فاتورة:

يتصل المستخدم بـ (merchantbot) ويطلب شراء شيء ما. يشكل الروبوت رسالة فاتورة تحتوي على وصف للسلع أو الخدمة، والمبلغ الواجب دفعه ومعلومات الشحن المطلوبة.

طرق إنشاء الفاتورة:

توجد طريقتان لإنشاء الفاتورة:

الأولى: فاتورة الروبوت:

استخدم طريقة (sendInvoice) لإنشاء فاتورة وإرسالها إلى الدردشة. المعلمة (Provider_token) هي المكان الذي تضع فيه قيمة الرمز الذي حصلت عليه مسبقًا عبر (Botfather). من الممكن أن يستخدم روبوت تاجر واحد عدة رموز مختلفة لمستخدمين مختلفين أو سلع وخدمات مختلفة.

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

• زر الانضمام.

• فاتورة بوت.

الثانية: الفاتورة المضمنة:

إذا كان (merchantbot) يدعم الوضع المضمن، فيمكنك استخدام (inputInvoiceMessageContent) للسماح للمستخدمين بمشاركة فواتير سلعك وخدماتك في محادثاتهم الفردية مع الأصدقاء أو إلى مجموعاتهم وقنواتهم. وستحتوي هذه الفواتير على زر دفع يمكن استخدامه عدة مرات.

• زر الانضمام.

• فاتورة مضمنة.

اختيار سلوك إعادة التوجيه:

اعتبارًا من المدفوعات 2.0، هناك طريقتان للتعامل مع النسخ المُعاد توجيهها من فواتيرك، يتم التحكم فيها بواسطة (start_parameter) في طريقة (sendInvoice).

• فاتورة متعددة الدردشة: تُظهر النسخ المُعاد توجيهها زر الدفع، والذي يمكن لعدة مستخدمين الضغط عليه ومحاولة الدفع مقابل السلع أو الخدمات. الفواتير المضمنة هي دائمًا فواتير متعددة المحادثات.

•  فاتورة دردشة واحدة: لا يمكن دفع الفاتورة إلا من الدردشة التي تم إرسالها إليها، وتُظهر النسخ المُعاد توجيهها زر عنوان (URL) مع رابط لموضع معين إلى الروبوت. ويمكن استخدام الرابط العميق لإنشاء فاتورة مماثلة في الدردشة مع الروبوت، أو لعرض رسالة خطأ، أو لأغراض أخرى.

إذا تم إرسال فاتورة دردشة واحدة إلى الدردشة مع (merchantbot)، فلا يمكن دفعها إلا مرة واحدة. إذا تم إرسال فاتورة الدردشة الواحدة إلى أي دردشة أخرى، فيمكن دفعها عدة مرات من قبل العديد من المستخدمين.

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

نصائح (خطوة اختيارية):

إذا تم تعيين المعلمة (max_tip_amount) على أعلى من 0، فيمكن للمستخدمين إضافة إكرامية إلى مدفوعاتهم. ويمكنك استخدام المعلمة المقترحة (_tip_amounts) لاقتراح مبالغ معينة تشعر أنها ستكون ذات صلة بالفاتورة.

معلومات الشحن والتفاصيل الأخرى (خطوة اختيارية):

يحدد المستخدم معلومات الشحن أو المعلومات الأخرى التي يطلبها الروبوت. وقد يكون هذا هو الاسم الكامل للمستخدم أو عنوان البريد الإلكتروني أو رقم الهاتف بتنسيق دولي أو عنوان بريدي كامل للتسليم.

عرض خيارات التسليم بناءً على عنوان الشحن (خطوة اختيارية):

إذا تم طلب عنوان شحن وقمت بتضمين المعلمة (is_flexible)، فسوف ترسل Bot API تحديثًا مع حقل (shipping_query) إلى الروبوت. يجب أن يستجيب الروبوت باستخدام (answerShippingQuery) إما بقائمة خيارات التسليم الممكنة وأسعار التسليم ذات الصلة، أو مع وجود خطأ (على سبيل المثال، إذا كان التسليم إلى العنوان المحدد غير ممكن).

ملاحظة: يوصى بتأكيد روبوت التاجر على توفر السلع / الخدمات في هذه الخطوة – لإعلام المستخدم في حالة عدم توفرها. هذا مهم بشكل خاص إذا كنت تستخدم فواتير متعددة الدردشة ، مضمنة أو فردية، متعددة الاستخدامات.

تحديد خيار التسليم (خطوة اختيارية):

يقوم المستخدم بتحديد خيار التسليم من القائمة (قد يتغير المبلغ الإجمالي الذي سيتم دفعه في هذه المرحلة) ويستمر في الخروج.

قبل الخروج:

يقوم المستخدم بإدخال معلومات الدفع الخاصة به والضغط على زر الدفع النهائي. في هذه اللحظة، ترسل (Bot API) تحديثًا بالحقل (pre_checkout_query) إلى الروبوت الذي يحتوي على جميع المعلومات المتاحة حول الطلب. يجب أن يرد الروبوت الخاص بك باستخدام (answerPrecheckoutQuery) في غضون 10 ثوانٍ بعد تلقي هذا التحديث أو يتم إلغاء المعاملة.

قد يقوم الروبوت بإرجاع خطأ إذا لم يتمكن من معالجة الطلب لأي سبب. ونوصي بشدة بتحديد سبب الفشل في إكمال الطلب في شكل يمكن للبشر قراءته (على سبيل المثال، “عذرًا، نفد كل من البط المطاطي! هل أنت مهتم بدب من الحديد الزهر بدلاً من ذلك؟”). سيعرض تيلجرام (Telegram) هذا السبب للمستخدم.

تحذير: اعتبارًا من مدفوعات 2.0 (Payments 2.0)، من الضروري التأكد من أن الروبوت الخاص بك لا يقبل إلا مدفوعات متعددة عندما يمكن معالجة الطلب بشكل صحيح. وهذا مهم بشكل خاص إذا كنت تستخدم فواتير متعددة الدردشة، مضمنة أو فردية، متعددة الاستخدامات.

الخروج:

في حالة تأكيد الروبوت للطلب، تطلب تيلجرام (Telegram) من مزود الدفع إكمال المعاملة. إذا تم إدخال معلومات الدفع بشكل صحيح وتم إجراء الدفع، فسوف ترسل واجهة برمجة التطبيقات (API) رسالة إيصال من المستخدم من النوع (Success_payment). بمجرد أن يتلقى الروبوت الخاص بك هذه الرسالة، يجب أن يشرع في تسليم البضائع أو الخدمات التي اشتراها المستخدم.

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

أسئلة متكررة عن مدفوعات روبوتات التيلجرام 2.0:

كيف أنضم كمزود خدمة دفع؟

إذا كنت تعمل لدى شركة تقدم خدمات مشابهة للحسابات المستقلة في (Stripe Connect) ، فيرجى إخبار مسؤولي الدعم في التيلجرام  عبر (BotSupport) (يرجى تضمين علامة التصنيف #paymentsprovider في رسالتك).

كم تحصل على عمولة؟

لا تتقاضى (Telegram) أي عمولة مقابل استخدام  (Payments API). لاحظ أن معظم مزودي الدفع سيكون لديهم عمولات خاصة بهم. على سبيل المثال، يتقاضى (Stripe) في الولايات المتحدة رسومًا تبلغ 2.9٪ + 30 لكل رسوم بطاقة ناجحة (راجع موقع Stripe للحصول على مزيد من التفاصيل حول الأسعار).

هل أحتاج إلى روبوت لقبول المدفوعات؟

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

ماذا يمكن أن يبيع البوت الخاص بي؟

لا تفرض تيلجرام (Telegram) أي قيود على المنتجات أو الخدمات التي يمكن أن يقدمها الروبوت الخاص بك. لكن يرجى ملاحظة أنه يجب عليك الامتثال لقواعد مزود المدفوعات الذي تختاره في نظامنا. على سبيل المثال، لدى (Stripe) صفحة خاصة للأعمال المحظورة – قد ترغب في الرجوع إلى تلك الصفحة قبل البدء في بيع الأعضاء المقطوعة.

ملاحظة: نظرًا لقيود Apple، لا يُسمح حاليًا لمطوري برامج الروبوت بقبول مدفوعات السلع الرقمية والخدمات الافتراضية من مستخدمي iOS.

كيف يتم التعامل مع النزاعات؟

تعمل تيلجرام (Telegram) كرسول بين المستخدم الدافع ومطور الروبوت ونظام الدفع الذي يختاره. ويرسل المستخدم تفاصيل بطاقته الائتمانية مباشرة إلى نظام الدفع. ثم يتم تمرير استجابة نظام الدفع وتفاصيل الشحن التي أدخلها المستخدم إلى مطور الروبوت حتى يتمكن من معالجة الطلب.

نظرًا لأن تيلجرام (Telegram) لا يعالج المدفوعات ، فإننا لا نخزن ولا يمكننا الوصول إلى أي بيانات حساسة. حيث أنه بسبب هذا الهيكل، من المستحيل على تيلجرام (Telegram) التعامل مع الشكاوى أو استرداد النقود – أي مدفوعات متنازع عليها تقع على عاتق مطوري الروبوتات ومقدمي الدفع والبنوك التي شاركت في التبادل.

كيف يمكنني دعم المدفوعات في تطبيق الطرف الثالث الذي يستخدم (Telegram API)؟

العملات المدعومة:

تدعم مدفوعات (Telegram) بعض العملات.

إذا كنت تستخدم (Stripe) كمزود للمدفوعات، فقد تختلف العملات المدعومة حسب البلد الذي حددته في حساب (Stripe) الخاص بك.

الحد الأدنى والحد الأقصى للمبالغ لكل من العملات يتوافق تقريبًا مع حد 10000 دولار أمريكي. ويجب التعبير عن المبلغ في 12 رقمًا أو أقل، وبالتالي فإن القيمة القصوى ستكون أقل بالنسبة لبعض العملات ذات القيمة الأقل. لاحظ أنه بالنسبة لكل عملة باستثناء الدولار الأمريكي، تعتمد هذه الحدود على أسعار الصرف وقد تتغير بمرور الوقت (خطط مسبقًا لذلك عند تنفيذ الحدود في شفرتك).