Faktur Telegram Stars (XTR) di bot: alur pembayaran untuk pengembang, langkah demi langkah
Menjual barang digital dengan Stars di bot: sendInvoice dengan XTR, balasan pre_checkout_query dalam 10 detik, successful_payment, penyimpanan ID tagihan, dan daftar periksa peluncuran.
Diterbitkan:

Apakah bot Anda menjual sesuatu yang digital, seperti langganan, konten, permintaan AI, atau item dalam permainan? Maka pembayarannya hanya dengan Telegram Stars. Artikel ini memandu alur faktur Telegram Stars (XTR) dari sudut pandang pengembang, mengikuti dokumentasi resmi API Bot. Untuk alasan mengapa harus Stars, lihat barang digital di bot hanya melalui Stars.
Alur secara ringkas
| Langkah | Yang dilakukan bot | Yang dikirim Telegram |
|---|---|---|
| 1 | sendInvoice dengan currency = XTR | — |
| 2 | Menunggu | pre_checkout_query |
| 3 | answerPreCheckoutQuery (dalam 10 detik) | — |
| 4 | Menunggu | successful_payment |
| 5 | Menyimpan ID tagihan, menyerahkan barang | — |
Langkah 1: buat faktur
Ada dua cara:
- Faktur bot: metode sendInvoice. Karena barangnya digital, provider_token berupa string kosong dan kolom currency adalah XTR. Faktur dapat dikirim ke obrolan pribadi, grup, atau kanal.
- Faktur inline: jika bot Anda mendukung mode inline, inputInvoiceMessageContent memungkinkan pengguna membagikan faktur kepada teman, grup, dan kanal. Tombol Pay-nya dapat digunakan berkali-kali.
Langkah 2: pilih perilaku penerusan
Parameter start_parameter mengendalikan hal ini:
- Faktur multi-obrolan: salinan yang diteruskan tetap memiliki tombol Pay, sehingga banyak pengguna dapat membayar. Faktur inline selalu multi-obrolan.
- Faktur obrolan tunggal: hanya dapat dibayar di obrolan tempat faktur dikirim; salinan yang diteruskan menampilkan tombol tautan dalam ke bot.
Perhatikan bahwa faktur obrolan tunggal yang dikirim di obrolan pribadi dengan bot Anda hanya dapat dibayar satu kali. Bagaimanapun, bot Anda selalu yang memutuskan apakah pembayaran baru diterima.
Langkah 3: pra-pembayaran
Pengguna (membeli Stars terlebih dahulu jika perlu) mengetuk Pay. Bot Anda menerima pre_checkout_query berisi rincian pesanan dan harus membalas dengan answerPreCheckoutQuery dalam 10 detik, atau transaksi dibatalkan. Jika Anda menolak, berikan alasan yang mudah dipahami; Telegram menampilkannya kepada pengguna.
Langkah 4–5: pembayaran dan penyerahan
Saat pembayaran berhasil, pesan successful_payment masuk. Baru setelah itu Anda boleh menyerahkan barang, karena menjawab pre_checkout_query tidak menjamin pembayaran berhasil. Simpan telegram_payment_charge_id; Anda membutuhkannya untuk pengembalian dana.
Sebelum diluncurkan
- Aktifkan verifikasi dua langkah untuk akun yang mengendalikan bot.
- Sediakan ketentuan melalui /terms, serta dukungan melalui /support dan /paysupport.
- Siap menghadapi sengketa dan pengembalian dana dengan refundStarPayment. Selengkapnya di pengembalian dana Stars dan /paysupport.
- Jaga server tetap stabil dan cadangkan data pembayaran.
Cara menguji
Lingkungan uji khusus Telegram memungkinkan Anda menguji pembayaran Stars secara gratis. Setelah semuanya berjalan, beralihlah ke produksi.
Sisi pembelian Stars
Pengguna Anda membeli Stars di aplikasi atau melalui @PremiumBot, dan PayStars menjualnya dengan USDT. Jika layanan Anda sendiri perlu membeli Stars secara otomatis, API PayStars dan ikhtisar API membahasnya.
Tanya Jawab
Bisakah saya menerima kripto atau mata uang lain selain Stars?
Tidak. Barang dan layanan digital di dalam aplikasi Telegram hanya dibayar dengan Stars.
Bagaimana cara menguji pembayaran?
Hubungkan bot Anda ke lingkungan uji khusus Telegram, tempat pembayaran Stars dapat diuji secara gratis.
Bagaimana cara mengeluarkan pengembalian dana?
Dengan metode refundStarPayment di API Bot.
Sumber
Related pages
Beli Stars dan Premium dengan USD (USDT)
Melalui kunci API: harga Fragment, 0% (situs: 5%).
More news
Menulis kebijakan pengembalian dana untuk bot Telegram Stars Anda: templat dan contohApa yang harus dicakup kebijakan pengembalian dana untuk bot Telegram Stars: kelayakan, jangka waktu, /paysupport dan refundStarPayment, serta contoh kalimat yang bisa Anda sesuaikan.Baca →
Apa yang terjadi pada Telegram Stars Anda jika kehilangan akses ke akunStars milik akun Telegram Anda, bukan ponsel. Pelajari apa yang terjadi saat Anda kehilangan akses, cara masuk kembali, dan cara melindungi saldo.Baca →
Mencatat pendapatan Telegram Stars sebagai kreator atau bisnisCara menyimpan catatan pendapatan Telegram Stars yang rapi: apa yang dicatat, melacak penarikan Fragment, memisahkan pribadi dan bisnis, serta apa yang ditanyakan kepada akuntan.Baca →