Panduan · Telegram Stars

Invois Telegram Stars (XTR) dalam bot: aliran pembayaran untuk pembangun, langkah demi langkah

Menjual barangan digital dengan Stars dalam bot: sendInvoice dengan XTR, balasan pre_checkout_query dalam 10 saat, successful_payment, menyimpan ID caj dan senarai semak pelancaran.

Diterbitkan:

Invois Telegram Stars (XTR) dalam bot: aliran pembayaran untuk pembangun, langkah demi langkah

Adakah bot anda menjual sesuatu yang digital, seperti langganan, kandungan, permintaan AI atau item dalam permainan? Maka pembayaran adalah dalam Telegram Stars sahaja. Artikel ini menerangkan aliran invois Telegram Stars (XTR) dari sudut pandangan pembangun, mengikut dokumentasi rasmi Bot API. Untuk sebab ia mesti Stars, lihat barangan digital dalam bot hanya melalui Stars.

Aliran secara ringkas

LangkahApa yang bot lakukanApa yang Telegram hantar
1sendInvoice dengan currency = XTR—
2Menunggupre_checkout_query
3answerPreCheckoutQuery (dalam 10 saat)—
4Menunggusuccessful_payment
5Menyimpan ID caj, menghantar barangan—

Langkah 1: cipta invois

Terdapat dua cara:

  • Invois bot: kaedah sendInvoice. Kerana barangan adalah digital, provider_token ialah rentetan kosong dan medan currency ialah XTR. Invois boleh dihantar ke sembang peribadi, kumpulan atau saluran.
  • Invois sebaris: jika bot anda menyokong mod sebaris, inputInvoiceMessageContent membolehkan pengguna berkongsi invois dengan rakan, kumpulan dan saluran. Butang Bayarnya boleh digunakan berkali-kali.

Langkah 2: pilih tingkah laku pemajuan

Parameter start_parameter mengawal ini:

  1. Invois berbilang sembang: salinan yang dimajukan mengekalkan butang Bayar, jadi ramai pengguna boleh membayar. Invois sebaris sentiasa berbilang sembang.
  2. Invois sembang tunggal: hanya boleh dibayar dalam sembang tempat ia dihantar; salinan yang dimajukan menunjukkan butang pautan dalam ke bot sebaliknya.

Perhatikan bahawa invois sembang tunggal yang dihantar dalam sembang peribadi dengan bot anda hanya boleh dibayar sekali sahaja. Walau apa pun, bot anda sentiasa memutuskan sama ada untuk menerima pembayaran baharu.

Langkah 3: pra-bayar

Pengguna (membeli Stars dahulu jika perlu) mengetik Bayar. Bot anda menerima pre_checkout_query dengan butiran pesanan dan mesti membalas dengan answerPreCheckoutQuery dalam 10 saat, atau transaksi dibatalkan. Jika anda menolak, berikan sebab yang mudah dibaca; Telegram menunjukkannya kepada pengguna.

Langkah 4–5: pembayaran dan penghantaran

Apabila pembayaran berjaya, mesej successful_payment tiba. Hanya ketika itu anda patut menghantar, kerana menjawab pre_checkout_query tidak menjamin pembayaran berjaya. Simpan telegram_payment_charge_id; anda memerlukannya untuk bayaran balik.

Sebelum anda mula beroperasi

  • Hidupkan pengesahan dua langkah untuk akaun yang mengawal bot.
  • Sediakan terma melalui /terms, dan sokongan melalui /support dan /paysupport.
  • Bersedia untuk pertikaian dan bayaran balik dengan refundStarPayment. Lagi dalam bayaran balik Stars dan /paysupport.
  • Pastikan pelayan stabil dan sandarkan data pembayaran.

Cara menguji

Persekitaran ujian khusus Telegram membolehkan anda menguji pembayaran Stars secara percuma. Setelah semuanya berfungsi, beralih ke produksi.

Bahagian pembelian Stars

Pengguna anda membeli Stars dalam aplikasi atau melalui @PremiumBot, dan PayStars menjualnya dengan USDT. Jika perkhidmatan anda sendiri perlu membeli Stars secara automatik, API PayStars dan gambaran keseluruhan API merangkuminya.

Soalan Lazim

Bolehkah saya menerima kripto atau mata wang lain selain Stars?

Tidak. Barangan dan perkhidmatan digital dalam aplikasi Telegram dibayar dengan Stars sahaja.

Bagaimana saya menguji pembayaran?

Sambungkan bot anda ke persekitaran ujian khusus Telegram, tempat pembayaran Stars boleh diuji secara percuma.

Bagaimana saya mengeluarkan bayaran balik?

Dengan kaedah refundStarPayment dalam Bot API.

Sumber

Beli Stars dan Premium dengan USD (USDT)

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

Mulakan