Panduan · PayStars

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:

API PayStars untuk pembangun: aliran penuh untuk menjual Stars dan Premium dalam bot anda

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.

BahagianApa yang dilakukannya
AksesPengepala X-API-Key; kunci dicipta dalam papan pemuka
BakiUSD, ditambah nilai dengan USDT (TON, BEP20 atau TRC20)
HargaHarga Fragment × 1.05, dibundarkan ke atas hingga sen
Had10 permintaan sesaat bagi setiap kunci
KetelusanTxId 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

  1. Simpan kunci API dalam pemboleh ubah persekitaran pelayan, bukan dalam kod.
  2. Jalankan keseluruhan aliran dengan pesanan sebenar kecil sebanyak 50 Stars.
  3. 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

Beli Stars dan Premium dengan USD (USDT)

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

Mulakan