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:

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.
| Bagian | Fungsinya |
|---|---|
| Akses | header X-API-Key; kunci dibuat di dasbor |
| Saldo | USD, diisi dengan USDT (TON, BEP20, atau TRC20) |
| Harga | harga Fragment × 1.05, dibulatkan ke atas hingga sen |
| Batas | 10 permintaan per detik per kunci |
| Transparansi | TxId 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
- Simpan kunci API di variabel lingkungan server, bukan di kode.
- Jalankan seluruh alur dengan pesanan nyata kecil sebesar 50 Stars.
- 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
Related pages
Beli Stars dan Premium dengan USD (USDT)
Melalui kunci API: harga Fragment, 0% (situs: 5%).
More news
Telegram Stars dan Premium di Uzbekistan: bayar dengan kartu atau USDTMembeli Telegram Stars atau Premium di Uzbekistan: Uzcard dan Humo lewat @StarKerakBot, USDT di paystars.uz/uz/, jalur aplikasi resmi, dan aturan lokal yang perlu diketahui.Baca →
Cara memberi hadiah pemenang kontes dengan Telegram Stars atau Premium: panduan penyelenggaraPengiriman Telegram Stars atau Premium kepada pemenang kuis, kontes, atau hackathon Anda sendiri: anggaran, pengumpulan @usernames, pengiriman melalui PayStars, dan laporan tindak lanjut.Baca →
FAQ PayStars: pertanyaan umum tentang masuk, isi ulang USDT, serta pesanan Stars dan PremiumPertanyaan PayStars yang paling sering ada di satu halaman: masuk dengan Telegram, isi ulang dengan USDT (TON, BEP20 atau TRC20), memesan Stars dan Premium, waktu pengiriman, keamanan, dan API.Baca →