Rehber · PayStars

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:

Geliştiriciler için PayStars API: botunuzda Stars ve Premium satmanın tam akışı

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ümNe işe yarar
ErişimX-API-Key başlığı; anahtarlar kontrol panelinde oluşturulur
BakiyeUSD, USDT ile yüklenir (TON, BEP20 veya TRC20)
FiyatFragment fiyatı × 1.05, sent yukarı yuvarlanır
SınırAnahtar başına saniyede 10 istek
ŞeffaflıkTamamlanan 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

  1. API anahtarını kodda değil, bir sunucu ortam değişkeninde tutun.
  2. Tüm akışı 50 Stars tutarında küçük bir gerçek siparişle çalıştırın.
  3. 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

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.

Başlayın