Panduan · Telegram Stars

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:

Faktur Telegram Stars (XTR) di bot: alur pembayaran untuk pengembang, langkah demi langkah

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

LangkahYang dilakukan botYang dikirim Telegram
1sendInvoice dengan currency = XTR—
2Menunggupre_checkout_query
3answerPreCheckoutQuery (dalam 10 detik)—
4Menunggusuccessful_payment
5Menyimpan 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:

  1. Faktur multi-obrolan: salinan yang diteruskan tetap memiliki tombol Pay, sehingga banyak pengguna dapat membayar. Faktur inline selalu multi-obrolan.
  2. 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

Beli Stars dan Premium dengan USD (USDT)

Melalui kunci API: harga Fragment, 0% (situs: 5%).

Mulai