API PayStars untuk pembangun: aliran penuh untuk menjual Stars dan Premium dalam bot anda
Cara API REST PayStars berfungsi dari hujung ke hujung: X-API-Key, semakan nama pengguna, sebut harga USD dengan max_usd, pesanan idempoten, ralat 409 price_changed dan pengesahan TxId, sebagai pelan integrasi.
Diterbitkan: · Dikemas kini:

Ingin menjual Telegram Stars dan Premium di dalam bot, kedai atau aplikasi anda sendiri? PayStars API memberi anda satu antara muka HTTPS dan baki USD yang dikongsi dengan laman web. Daripada mengulang rujukan API, artikel ini menunjukkan cara membina integrasi dari mula hingga akhir.
Seni bina secara sepintas lalu
Sistem anda melakukan tiga perkara: menambah dana baki dengan USDT, meminta harga dan mencipta pesanan. Segala yang lain, termasuk penghantaran melalui aliran pembelian rasmi Telegram, berlaku di pihak PayStars.
| Bahagian | Apa yang dilakukannya |
|---|---|
| Akses | Pengepala X-API-Key; kunci dicipta dalam papan pemuka |
| Baki | USD, ditambah nilai dengan USDT (TON, BEP20 atau TRC20) |
| Harga | Harga Fragment × 1.05, dibundarkan ke atas hingga sen |
| Had | 10 permintaan sesaat bagi setiap kunci |
| Ketelusan | TxId awam bagi setiap pesanan yang selesai |
Peringkat 1: tambah dana baki
POST /usd/invoice dengan jumlah dan rantaian ("ton", "bsc" atau "trc20") memulangkan jumlah tepat yang sah selama 30 minit. Minimum ialah 0.1 USDT.
Peringkat 2: sahkan penerima
POST /api/v1/check-username menyemak penerima dan memulangkan token pengesahan jangka pendek. Itu menghalang pembayaran kepada nama pengguna yang tidak wujud: jika pelanggan tersilap taip, anda mengetahuinya sebelum apa-apa dicaj.
Peringkat 3: dapatkan dan hadkan harga
POST /api/v1/usd/quote memulangkan harga semasa (usd) dan tambahan harga (markup_percent: 5). Harga mengikut pasaran, jadi:
- minta sebut harga baharu sebelum setiap pesanan;
- hantar max_usd sama dengan jumlah yang disebut;
- sentiasa hantar currency: "USD", jika tidak keutamaan tersimpan akaun akan digunakan.
Peringkat 4: cipta pesanan
POST /api/v1/stars/buy atau /api/v1/premium/buy. Setiap permintaan mesti membawa Idempotency-Key, jadi jika sambungan terputus dan anda cuba semula, anda tidak dicaj dua kali. Simpan kunci bersama ID pesanan dalam pangkalan data anda.
Peringkat 5: jejaki status
GET /api/v1/order/{id} dan /api/v1/orders memberi anda status dan sejarah. Kebanyakan pesanan dihantar dalam beberapa minit. Pesanan yang selesai mendapat TxId yang anda dan pelanggan anda boleh semak pada lejar awam PayStars.
Mengendalikan ralat dengan betul
- 409 price_changed bermaksud harga telah melebihi max_usd dan tiada apa-apa dicaj. Dapatkan sebut harga baharu dan tunjukkan harga yang dikemas kini kepada pelanggan.
- Had kadar: jangan melebihi 10 permintaan sesaat; tambah baris gilir atau penangguhan.
- Percubaan semula: sentiasa guna semula Idempotency-Key yang sama.
Sebelum dilancarkan
- Simpan kunci API dalam pemboleh ubah persekitaran pelayan, bukan dalam kod.
- Jalankan keseluruhan aliran dengan pesanan sebenar kecil sebanyak 50 Stars.
- Tunjukkan TxId mereka kepada pelanggan, yang membina kepercayaan.
Dokumen penuh dan panduan mula pantas: API Stars PayStars dan penetapan harga USD untuk API. Untuk pembayaran dalam bot, lihat barangan digital dalam bot hanya dibayar dengan Stars.
Soalan Lazim
Adakah terdapat persekitaran ujian?
Tiada persekitaran ujian berasingan; uji dengan pesanan sebenar yang kecil (50 Stars) semasa mengintegrasikan.
Bahasa pengaturcaraan yang manakah boleh digunakan?
Sebarang bahasa yang boleh membuat permintaan HTTPS. Terdapat panduan mula pantas untuk Python, Node.js dan PHP.
Bagaimana saya menambah dana baki?
Dengan USDT pada TON, BEP20 atau TRC20, minimum 0.1 USDT; setiap invois mempunyai jumlah tepat yang sah selama 30 minit.
Sumber
Related pages
Beli Stars dan Premium dengan USD (USDT)
Melalui kunci API: harga Fragment, 0% (laman web: 5%).
More news
Telegram Stars dan Premium di Uzbekistan: bayar dengan kad atau USDTMembeli Telegram Stars atau Premium di Uzbekistan: Uzcard dan Humo melalui @StarKerakBot, USDT di paystars.uz/uz/, laluan aplikasi rasmi dan peraturan tempatan yang perlu diketahui.Baca →
Cara memberi ganjaran kepada pemenang pertandingan dengan Telegram Stars atau Premium: panduan penganjurMenghantar Telegram Stars atau Premium kepada pemenang kuiz, pertandingan atau maraton pengaturcaraan anda sendiri: bajet, mengumpul @usernames, penghantaran melalui PayStars, dan laporan susulan.Baca →
Soalan Lazim PayStars: soalan biasa tentang log masuk, tambah nilai USDT, serta pesanan Stars dan PremiumSoalan PayStars yang paling biasa dalam satu halaman: log masuk dengan Telegram, tambah nilai dengan USDT (TON, BEP20 atau TRC20), memesan Stars dan Premium, masa penghantaran, keselamatan dan API.Baca →