فاتورة الكريبتو في Telegram: كيف ترسل فاتورة كريبتو من بوتك
فاتورة الكريبتو في Telegram: كيف ترسل فاتورة كريبتو من بوت Telegram، وما هي الفاتورة داخل الدردشة التي تخطط لها Qvard، وما يعمل اليوم عبر API.
فاتورة الكريبتو في Telegram طلب دفع يُرسل في الدردشة، ويتضمن المبلغ والعملة وزر دفع. تخطط Qvard لتدفق فواتير داخل Telegram، لكنه لم يُطلق بعد. يوضح هذا الدليل كيف ترسل فاتورة كريبتو من البوت اليوم: ينشئ البوت الفاتورة عبر API ويفتح الزر الصفحة المستضافة.
ماذا تحتوي فاتورة الكريبتو
تعرض الفاتورة الطلب والمبلغ بالدولار ومهلة الدفع وزر دفع. يرى العميل ما عليه دفعه، ويستطيع الدفع دون مغادرة المحادثة لفترة طويلة.
الحالة: الفاتورة داخل الدردشة ضمن خارطة الطريق
لم يُطلق بعد تدفق الفواتير الأصلي داخل Telegram، ولا يقدمه هذا المقال كمتاح. يُنشئ المسار أدناه الفاتورة عبر API الفعلية ويربطها بالصفحة المستضافة.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}إنشاء الفاتورة من البوت
يستدعي خلفية البوت POST /api/v1/payment مع ترويسة x-api-key، ومعرّف الطلب في id، والمبلغ بالدولار في price. redirectUrl المرتجع هو رابط الفاتورة الذي يرسله البوت إلى العميل.
اكتب رسالة فاتورة واضحة
اعرض رقم الطلب والمبلغ بالدولار وما يشتريه العميل والزر. أضف ملاحظة قصيرة بأن المبلغ الدقيق بالكريبتو يظهر في الصفحة التالية بسعر صرف ثابت.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }تابع حالة الفاتورة
يرسل الـwebhook الحالة لمعرّف الطلب. ما دامت الحالة ليست paid تبقى الفاتورة مفتوحة، ويستطيع البوت تذكير العميل مرة واحدة.
أنهِ صلاحية الفواتير القديمة
لا تُبقِ فاتورة غير مدفوعة مفتوحة إلى الأبد. ضع علامة منتهية الصلاحية في نظامك بعد مهلتك أنت، وأنشئ دفعة جديدة فقط عندما يطلبها العميل.
FAQ
هل يستطيع بوت Telegram إرسال فاتورة كريبتو اليوم؟
نعم. ينشئ البوت الدفعة عبر API، ويرسل redirectUrl كرابط للفاتورة، ويحدّث الطلب من الـwebhook. تدفق الفواتير الأصلي في Telegram ضمن خارطة الطريق.
هل تُعد الفاتورة مدفوعة عندما ينقر العميل الزر؟
لا. الفاتورة مدفوعة فقط عندما يرسل الـwebhook المعرّف والحالة paid.
هل يمكنني إعادة إرسال فاتورة غير مدفوعة؟
نعم، أعد إرسال redirectUrl نفسه ما دامت الدفعة مفتوحة، وأنشئ دفعة جديدة فقط إن كانت السابقة قد انتهت.
كيف أختبر فاتورة؟
أنشئ فاتورة تجريبية وتحقق من الرسالة والزر ونتيجة الـwebhook قبل استخدام طلبات حقيقية.
