مدفوعات الكريبتو في بوت Telegram: كيف تضيف الدفع بالكريبتو إلى بوتك
مدفوعات الكريبتو في بوت Telegram: كيف تضيف الدفع بالكريبتو إلى البوت، وما هو الدفع الأصلي المخطط من Qvard، والمسار العامل عبر API اليوم. مع أمثلة.
يستقبل بوت Telegram الذي يحتوي على مدفوعات كريبتو الطلب داخل الدردشة، ويرسل للعميل زر دفع. تخطط Qvard لدفع Telegram أصلي، لكنه لم يُطلق بعد. يوضح هذا الدليل كيف تضيف الدفع بالكريبتو إلى البوت اليوم باستخدام API الفعلية والصفحة المستضافة وwebhook.
ما الذي يجب أن يفعله البوت
يجمع البوت الطلب، وينشئ الدفعة في خلفيتك، ويرسل للعميل الزر، وينتظر الـwebhook. الدردشة هي واجهة المتجر، أما الدفع نفسه فيتم في الصفحة المستضافة.
الحالة: الدفع الأصلي للبوت ضمن خارطة الطريق
لم يُطلق بعد دفع Qvard الأصلي لبوتات 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 الذي يصبح الزر.
الزر ورسالة الطلب
أرسل رسالة واحدة فيها الطلب والمبلغ والزر الذي يقود إلى redirectUrl. اجعل الرسالة قصيرة، ولا تَعِد بالتسليم أو الوصول قبل أن يؤكد الـwebhook الدفع.
استلم الحالة في خلفيتك
تستقبل نقطة نهاية الـwebhook الحقلين id وstatus، وتتحقق من ترويسة x-api-key، وتحدّث الطلب. الحالة paid وحدها هي التي تفتح المنتج أو الخدمة.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }تعامل مع التكرار والإخفاقات
إن أغلق العميل الصفحة يبقى الطلب معلقًا، ويستطيع البوت أن يعرض رابط الدفع نفسه مرة أخرى. اجعل معالج الـwebhook آمنًا عند التكرار، لأن الرسالة نفسها قد تصل مرتين.
FAQ
هل يمكن لبوت Telegram قبول الكريبتو اليوم؟
نعم. ينشئ البوت الدفعة عبر API، ويرسل زرًا إلى redirectUrl، ويؤكد الطلب من الـwebhook. الدفع الأصلي في Telegram ضمن خارطة الطريق.
هل أحتاج إلى إطار عمل خاص للبوت؟
لا. أي كود بوت يستطيع استدعاء نقطة HTTPS واستقبال webhook يمكنه إنشاء الدفعات عبر API.
أين يُحفظ مفتاح API؟
في خلفية البوت فقط. لا تضع المفتاح أبدًا في رسائل الدردشة ولا في كود يستطيع العميل رؤيته.
كيف أختبر دفعة البوت؟
أنشئ فاتورة تجريبية من طلب اختباري وادفعها في الصفحة المستضافة، وتأكد من أن البوت يستلم الـwebhook.
