Geliştiriciler için PayStars API: botunuzda Stars ve Premium satmanın tam akışı
PayStars REST API'nin uçtan uca nasıl çalıştığı: X-API-Key, kullanıcı adı kontrolleri, max_usd ile USD fiyat teklifleri, yinelenmeye dayanıklı siparişler, 409 price_changed hatası ve TxId doğrulaması, bir entegrasyon planı olarak.
Yayınlandı: · Güncellendi:

Kendi botunuz, mağazanız veya uygulamanız içinde Telegram Stars ve Premium satmak mı istiyorsunuz? PayStars API size tek bir HTTPS arayüzü ve web sitesiyle paylaşılan bir USD bakiyesi sunar. API referansını tekrarlamak yerine bu makale, entegrasyonu baştan sona nasıl kuracağınızı gösterir.
Mimariye bir bakış
Sisteminiz üç şey yapar: bakiyeyi USDT ile yükler, fiyat sorar ve sipariş oluşturur. Telegram'ın resmi satın alma akışı üzerinden teslimat dahil geri kalan her şey PayStars tarafında gerçekleşir.
| Bölüm | Ne işe yarar |
|---|---|
| Erişim | X-API-Key başlığı; anahtarlar kontrol panelinde oluşturulur |
| Bakiye | USD, USDT ile yüklenir (TON, BEP20 veya TRC20) |
| Fiyat | Fragment fiyatı × 1.05, sent yukarı yuvarlanır |
| Sınır | Anahtar başına saniyede 10 istek |
| Şeffaflık | Tamamlanan her sipariş için herkese açık bir TxId |
Aşama 1: bakiyeyi yükleyin
Bir tutar ve bir zincirle ("ton", "bsc" veya "trc20") POST /usd/invoice, 30 dakika geçerli kesin bir tutar döndürür. Minimum 0.1 USDT'tir.
Aşama 2: alıcıyı doğrulayın
POST /api/v1/check-username alıcıyı kontrol eder ve kısa ömürlü bir doğrulama belirteci döndürür. Bu, var olmayan kullanıcı adlarına ödemeyi önler: müşteri yazım hatası yaparsa, herhangi bir ücret alınmadan önce bunu öğrenirsiniz.
Aşama 3: fiyatı alın ve sınırlayın
POST /api/v1/usd/quote güncel fiyatı (usd) ve ek ücreti (markup_percent: 5) döndürür. Fiyat piyasayı izler, bu nedenle:
- her siparişten önce yeni bir fiyat teklifi isteyin;
- teklif edilen tutara eşit max_usd gönderin;
- her zaman currency: "USD" gönderin, aksi halde hesabın kayıtlı tercihi kullanılır.
Aşama 4: siparişi oluşturun
POST /api/v1/stars/buy veya /api/v1/premium/buy. Her istek bir Idempotency-Key taşımalıdır; böylece bağlantı kopar ve yeniden denerseniz iki kez ücretlendirilmezsiniz. Anahtarı veritabanınızda sipariş kimliğiyle birlikte saklayın.
Aşama 5: durumu izleyin
GET /api/v1/order/{id} ve /api/v1/orders size durumları ve geçmişi verir. Siparişlerin çoğu dakikalar içinde teslim edilir. Tamamlanan bir sipariş, hem sizin hem müşterinizin PayStars herkese açık defterinde kontrol edebileceği bir TxId alır.
Hataları doğru yönetmek
- 409 price_changed, fiyatın max_usd üzerine çıktığı ve hiçbir ücret alınmadığı anlamına gelir. Yeni bir fiyat teklifi alın ve müşteriye güncel fiyatı gösterin.
- Hız sınırı: saniyede 10 isteği aşmayın; bir kuyruk veya geri çekilme ekleyin.
- Yeniden denemeler: her zaman aynı Idempotency-Key değerini yeniden kullanın.
Yayına almadan önce
- API anahtarını kodda değil, bir sunucu ortam değişkeninde tutun.
- Tüm akışı 50 Stars tutarında küçük bir gerçek siparişle çalıştırın.
- Müşterilere TxId'lerini gösterin; bu güven oluşturur.
Tam belgeler ve hızlı başlangıçlar: PayStars Stars API ve API için USD fiyatlandırması. Bot içi ödemeler için bkz. botlardaki dijital ürünler yalnızca Stars ile ödenir.
SSS
Sandbox var mı?
Ayrı bir sandbox yoktur; entegrasyon sırasında küçük gerçek siparişlerle (50 Stars) test edin.
Hangi programlama dilleri çalışır?
HTTPS isteği yapabilen her dil. Python, Node.js ve PHP için hızlı başlangıç kılavuzları vardır.
Bakiyeyi nasıl yüklerim?
TON, BEP20 veya TRC20 üzerinde USDT ile, minimum 0.1 USDT; her faturanın 30 dakika geçerli kesin bir tutarı vardır.
Kaynaklar
Related pages
Stars ve Premium'u USD (USDT) ile satın alın
API anahtarıyla: Fragment fiyatı, 0% (site: 5%). Site ve Mini Uygulama: Fragment + %5.
More news
Özbekistan'da Telegram Stars ve Premium: kartla veya USDT ile ödemeÖzbekistan'da Telegram Stars veya Premium satın alma: @StarKerakBot üzerinden Uzcard ve Humo, paystars.uz/uz/ adresinde USDT, resmi uygulama yolları ve bilinmesi gereken yerel kurallar.Oku →
Yarışma kazananlarını Telegram Stars veya Premium ile ödüllendirme: organizatör rehberiKendi sınavınızın, yarışmanızın veya hackathon'unuzun kazananlarına Telegram Stars veya Premium teslimi: bütçe, @usernames toplama, PayStars üzerinden teslimat ve takip raporu.Oku →
PayStars SSS: giriş, USDT yüklemeleri ve Stars ile Premium siparişleri hakkında sık sorulan sorularEn sık sorulan PayStars soruları tek sayfada: Telegram ile giriş, USDT ile yükleme (TON, BEP20 veya TRC20), Stars ve Premium siparişi, teslimat süreleri, güvenlik ve API.Oku →