Telegram botunda kripto ödemeler: botunuza kripto ödemesi nasıl eklenir
Telegram botunda kripto ödemeler: bir Telegram botuna kripto ödemesi nasıl eklenir, planlanan Qvard yerel checkout’u nedir ve API ile bugün çalışan yol.
Kripto ödemeli bir Telegram botu, siparişi sohbette alır ve müşteriye bir ödeme düğmesi gönderir. Qvard yerel bir Telegram checkout’u planlıyor, ancak henüz yayınlanmadı. Bu rehber, bir bota bugün canlı API, hosted sayfa ve webhook ile kripto ödemesinin nasıl ekleneceğini gösterir.
Botun neler yapması gerekir
Bot siparişi toplar, ödemeyi backend’inizde oluşturur, müşteriye düğmeyi gönderir ve webhook’u bekler. Sohbet vitrindir; ödemenin kendisi hosted sayfada gerçekleşir.
Durum: yerel bot checkout’u yol haritasında
Telegram botları için Qvard’ın yerel bir checkout’u henüz yayınlanmadı ve bu makale onu mevcut olarak sunmaz. Aşağıdaki entegrasyon bugün mevcut API ile çalışır.
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
}Bot backend’inden ödeme çağrısı
Bot backend’i, x-api-key başlığıyla POST /api/v1/payment gönderir; sipariş numarasını id’de, USD cinsinden toplamı price’ta taşır. Yanıt, düğmeye dönüşen redirectUrl’i içerir.
Düğme ve sipariş mesajı
Sipariş, tutar ve redirectUrl’e giden düğmeyi tek bir mesajda gönderin. Mesajı kısa tutun ve webhook ödemeyi doğrulayana kadar teslimat ya da erişim vaat etmeyin.
Durumu backend’inizde alın
Webhook endpoint’iniz id ve status’u alır, x-api-key başlığını kontrol eder ve siparişi günceller. Ürünü ya da hizmeti yalnızca paid durumu açmalıdır.
x-api-key: sk_live_…
{ "id": "order_1024", "status": "paid" }Tekrarları ve hataları yönetin
Müşteri sayfayı kapatırsa sipariş beklemede kalır ve bot aynı ödeme bağlantısını yeniden sunabilir. Aynı mesaj iki kez gelebileceği için webhook işleyicisini tekrara dayanıklı yapın.
FAQ
Bir Telegram botu bugün kripto alabilir mi?
Evet. Bot ödemeyi API ile oluşturur, redirectUrl’e bir düğme gönderir ve siparişi webhook’tan onaylar. Yerel Telegram checkout’u yol haritasındadır.
Bota özel bir framework gerekir mi?
Hayır. HTTPS endpoint’i çağırabilen ve webhook alabilen her bot kodu API ile ödeme oluşturabilir.
API anahtarı nerede saklanmalı?
Yalnızca bot backend’inde. Anahtarı asla sohbet mesajlarına ya da müşterinin görebileceği koda koymayın.
Bot ödemesini nasıl test ederim?
Test siparişinden bir demo fatura oluşturun, hosted sayfada ödeyin ve botun webhook aldığını kontrol edin.
