Pembayaran Telegram mini app: menerima crypto di dalam mini app
Pembayaran Telegram mini app dijelaskan: menerima crypto di dalam mini app Telegram, rencana checkout mini app Qvard, dan jalur API yang berjalan hari ini.
Pembayaran Telegram mini app berarti toko yang dibangun sebagai aplikasi web di dalam Telegram menerima crypto untuk produknya. Qvard merencanakan checkout untuk mini app, yang belum dirilis. Panduan ini menjelaskan cara kerja pembayaran di mini app dan jalur yang berjalan hari ini: backend mini app membuat pembayaran lewat API, membuka halaman hosted, dan mengonfirmasi pesanan lewat webhook.
Apa itu pembayaran di mini app
Mini app Telegram adalah aplikasi web yang terbuka di dalam chat. Pembayaran di mini app berarti pelanggan memilih produk di aplikasi dan membayarnya tanpa meninggalkan Telegram dalam waktu lama.
Status: checkout mini app ada di peta jalan
Checkout asli Qvard untuk mini app Telegram belum dirilis, dan artikel ini tidak menggambarkannya sebagai tersedia. Jalur di bawah memakai API live, halaman pembayaran hosted, dan webhook.
Yang berjalan hari ini
Backend mini app membuat pembayaran dengan POST /api/v1/payment dan header x-api-key, menerima redirectUrl, dan membuka halaman hosted untuk pelanggan. Lalu webhook mengirim status final ke backend, yang membuka kunci produk.
Simpan kunci di backend
Mini app berjalan di browser pelanggan, jadi kunci API tidak boleh ditaruh di kode front-end. Hanya backend yang memanggil 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
}Buka produk lewat webhook
Mini app hanya menampilkan produk sebagai terbuka setelah webhook mengirim id dan status paid untuk pesanan itu. Sampai saat itu produk tetap terkunci, meskipun pelanggan kembali ke aplikasi.
Rencanakan checkout mini app asli
Ketika checkout asli dirilis, jendela pembayaran mungkin terbuka di dalam aplikasi. Sampai saat itu, simpan logika pesanan dan webhook di backend, agar nanti hanya front-end yang berubah.
FAQ
Bisakah mini app Telegram menerima crypto hari ini?
Bisa. Backend mini app membuat pembayaran lewat API, membuka halaman hosted, dan membuka produk setelah webhook mengonfirmasi status paid. Checkout mini app asli ada di peta jalan.
Bisakah mini app memanggil API pembayaran langsung dari browser?
Tidak. Simpan kunci API di backend dan panggil endpoint pembayaran hanya dari sana.
Apakah pelanggan harus keluar dari mini app?
Hari ini halaman pembayaran hosted terbuka untuk pembayaran, dan hasilnya kembali ke mini app lewat backend dan webhook Anda.
Bagaimana cara menguji pembayaran mini app?
Buat invoice demo dari produk uji, bayar di halaman hosted, dan pastikan produk terbuka setelah webhook.
