Telegram mini app ödemeleri: mini uygulamanın içinde kripto almak
Telegram mini app ödemeleri açıklandı: bir mini uygulamanın içinde kripto almak, Qvard’ın mini app checkout planları ve API ile bugün çalışan yol.
Telegram mini app ödemeleri, Telegram içinde bir web uygulaması olarak kurulmuş bir mağazanın ürünleri için kripto almasıdır. Qvard bir mini app checkout’u planlıyor, ancak henüz yayınlanmadı. Bu rehber bir mini app ödemesinin nasıl çalışacağını ve bugün çalışan yolu anlatır: mini uygulamanın backend’i API ile ödemeyi oluşturur, hosted sayfayı açar ve siparişi webhook ile onaylar.
Mini app ödemesi nedir
Telegram mini app, sohbetin içinde açılan bir web uygulamasıdır. Mini app’te ödeme demek, müşterinin uygulamada bir ürün seçip Telegram’dan uzun süre ayrılmadan ödemesi demektir.
Durum: mini app checkout’u yol haritasında
Telegram mini app’leri için Qvard’ın yerel bir checkout’u henüz yayınlanmadı ve bu makale onu mevcut olarak sunmaz. Aşağıdaki çalışan yol canlı API, hosted ödeme sayfası ve webhook kullanır.
Bugün çalışan
Mini uygulamanın backend’i, x-api-key başlığıyla POST /api/v1/payment ile ödemeyi oluşturur, bir redirectUrl alır ve müşteri için hosted sayfayı açar. Ardından webhook son durumu backend’e iletir ve backend ürünün kilidini açar.
Anahtarı backend’te tutun
Mini uygulama müşterinin tarayıcısında çalışır, bu yüzden API anahtarı asla ön yüz koduna konmamalıdır. Yalnızca backend POST /api/v1/payment çağırı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
}Ürünün kilidini webhook ile açın
Mini uygulama ürünü yalnızca webhook o sipariş için id ve paid durumunu ilettikten sonra açık gösterir. Bu zamana kadar ürün kilitli kalır; müşteri uygulamaya dönse bile.
Yerel mini app checkout’u için planlayın
Yerel checkout yayınlandığında ödeme penceresi uygulamanın içinde açılabilir. O zamana kadar sipariş mantığını ve webhook’u backend’te tutun, böylece sonra yalnızca ön yüz değişir.
FAQ
Bir Telegram mini app’i bugün kripto alabilir mi?
Evet. Mini uygulamanın backend’i ödemeyi API ile oluşturur, hosted sayfayı açar ve webhook paid durumunu onayladıktan sonra ürünün kilidini açar. Yerel mini app checkout’u yol haritasındadır.
Mini app, ödeme API’sini doğrudan tarayıcıdan çağırabilir mi?
Hayır. API anahtarını backend’te tutun ve ödeme endpoint’ini yalnızca oradan çağırın.
Müşteri mini uygulamadan çıkmak zorunda mı?
Bugün ödeme için hosted sayfa açılır ve sonuç backend’iniz ve webhook’unuz üzerinden mini uygulamaya döner.
Mini app ödemesini nasıl test ederim?
Test ürününden bir demo fatura oluşturun, hosted sayfada ödeyin ve webhook’tan sonra ürünün açıldığını kontrol edin.
