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