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