Panduan · PayStars

PayStars API untuk pengembang: alur lengkap menjual Stars dan Premium di bot Anda

Cara kerja PayStars REST API dari ujung ke ujung: X-API-Key, pemeriksaan nama pengguna, kutipan USD dengan max_usd, pesanan idempoten, kesalahan 409 price_changed, dan verifikasi TxId, sebagai rencana integrasi.

Diterbitkan: · Diperbarui:

PayStars API untuk pengembang: alur lengkap menjual Stars dan Premium di bot Anda

Ingin menjual Telegram Stars dan Premium di bot, toko, atau aplikasi Anda sendiri? PayStars API memberi Anda satu antarmuka HTTPS dan saldo USD yang dipakai bersama situs web. Alih-alih mengulang referensi API, artikel ini menunjukkan cara membangun integrasi dari awal sampai selesai.

Arsitektur secara singkat

Sistem Anda melakukan tiga hal: mengisi saldo dengan USDT, meminta harga, dan membuat pesanan. Selebihnya, termasuk pengiriman melalui alur pembelian resmi Telegram, terjadi di sisi PayStars.

BagianFungsinya
Aksesheader X-API-Key; kunci dibuat di dasbor
SaldoUSD, diisi dengan USDT (TON, BEP20, atau TRC20)
Hargaharga Fragment × 1.05, dibulatkan ke atas hingga sen
Batas10 permintaan per detik per kunci
TransparansiTxId publik untuk setiap pesanan yang selesai

Tahap 1: isi saldo

POST /usd/invoice dengan jumlah dan jaringan ("ton", "bsc", atau "trc20") mengembalikan jumlah pasti yang berlaku selama 30 menit. Minimumnya 0.1 USDT.

Tahap 2: verifikasi penerima

POST /api/v1/check-username memeriksa penerima dan mengembalikan token verifikasi yang berumur singkat. Itu mencegah pembayaran ke nama pengguna yang tidak ada: jika pelanggan salah ketik, Anda mengetahuinya sebelum ada yang ditagih.

Tahap 3: ambil dan batasi harga

POST /api/v1/usd/quote mengembalikan harga saat ini (usd) dan tambahan harga (markup_percent: 5). Harga mengikuti pasar, jadi:

  • minta kutipan baru sebelum setiap pesanan;
  • kirim max_usd sama dengan jumlah yang dikutip;
  • selalu kirim currency: "USD", jika tidak, preferensi tersimpan akun yang digunakan.

Tahap 4: buat pesanan

POST /api/v1/stars/buy atau /api/v1/premium/buy. Setiap permintaan harus membawa Idempotency-Key, jadi jika koneksi terputus dan Anda mencoba lagi, Anda tidak ditagih dua kali. Simpan kunci itu bersama ID pesanan di basis data Anda.

Tahap 5: lacak status

GET /api/v1/order/{id} dan /api/v1/orders memberi Anda status dan riwayat. Sebagian besar pesanan terkirim dalam hitungan menit. Pesanan yang selesai mendapat TxId yang dapat Anda dan pelanggan periksa di buku besar publik PayStars.

Menangani kesalahan dengan benar

  • 409 price_changed berarti harga naik di atas max_usd dan tidak ada yang ditagih. Ambil kutipan baru dan tunjukkan harga terbaru kepada pelanggan.
  • Batas laju: jangan melebihi 10 permintaan per detik; tambahkan antrean atau jeda ulang.
  • Percobaan ulang: selalu gunakan Idempotency-Key yang sama.

Sebelum diluncurkan

  1. Simpan kunci API di variabel lingkungan server, bukan di kode.
  2. Jalankan seluruh alur dengan pesanan nyata kecil sebesar 50 Stars.
  3. Tunjukkan TxId kepada pelanggan, karena itu membangun kepercayaan.

Dokumentasi lengkap dan panduan cepat: PayStars Stars API dan harga USD untuk API. Untuk pembayaran di dalam bot, lihat barang digital di bot hanya dibayar dengan Stars.

Tanya Jawab

Apakah ada lingkungan uji?

Tidak ada lingkungan uji terpisah; uji dengan pesanan nyata kecil (50 Stars) saat mengintegrasikan.

Bahasa pemrograman mana yang bisa digunakan?

Bahasa apa pun yang dapat membuat permintaan HTTPS. Ada panduan cepat untuk Python, Node.js, dan PHP.

Bagaimana cara mengisi saldo?

Dengan USDT di TON, BEP20, atau TRC20, minimum 0.1 USDT; setiap faktur memiliki jumlah pasti yang berlaku selama 30 menit.

Sumber

Beli Stars dan Premium dengan USD (USDT)

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

Mulai