ڈویلپرز کے لیے PayStars API: اپنے بوٹ میں Stars اور Premium بیچنے کا مکمل عمل
PayStars REST API شروع سے آخر تک کیسے کام کرتا ہے: X-API-Key، صارف نام کی جانچ، max_usd کے ساتھ USD نرخ، دہرائے جانے پر محفوظ آرڈرز، 409 price_changed خرابی اور TxId کی تصدیق، انضمام کے منصوبے کے طور پر۔
شائع شدہ: · تازہ کاری:

اپنے بوٹ، دکان یا ایپ میں Telegram Stars اور Premium بیچنا چاہتے ہیں؟ PayStars API آپ کو ایک HTTPS انٹرفیس اور ویب سائٹ کے ساتھ مشترکہ USD بیلنس دیتا ہے۔ API حوالہ دہرانے کے بجائے، یہ مضمون انضمام شروع سے آخر تک بنانے کا طریقہ دکھاتا ہے۔
ساخت ایک نظر میں
آپ کا نظام تین کام کرتا ہے: USDT سے بیلنس بھرتا ہے، قیمت مانگتا ہے اور آرڈر بناتا ہے۔ باقی سب، بشمول Telegram کے سرکاری خریداری کے عمل سے ترسیل، PayStars کی طرف ہوتا ہے۔
| حصہ | یہ کیا کرتا ہے |
|---|---|
| رسائی | X-API-Key ہیڈر؛ کلیدیں کنٹرول پینل میں بنتی ہیں |
| بیلنس | USD، USDT سے بھرا جاتا ہے (TON، BEP20 یا TRC20) |
| قیمت | Fragment کی قیمت × 1.05، سینٹ تک اوپر گول |
| حد | ہر کلید پر فی سیکنڈ 10 درخواستیں |
| شفافیت | ہر مکمل آرڈر کے لیے ایک عوامی TxId |
مرحلہ 1: بیلنس بھریں
رقم اور چین ("ton"، "bsc" یا "trc20") کے ساتھ POST /usd/invoice 30 منٹ تک درست عین رقم لوٹاتا ہے۔ کم از کم 0.1 USDT ہے۔
مرحلہ 2: وصول کنندہ کی تصدیق
POST /api/v1/check-username وصول کنندہ چیک کرتا ہے اور مختصر مدت کا تصدیقی ٹوکن لوٹاتا ہے۔ اس سے ایسے صارف ناموں کو ادائیگی نہیں ہوتی جو موجود نہیں: اگر گاہک ہجے غلط لکھے تو چارج سے پہلے پتہ چل جاتا ہے۔
مرحلہ 3: قیمت لیں اور حد لگائیں
POST /api/v1/usd/quote موجودہ قیمت (usd) اور اضافی شرح (markup_percent: 5) لوٹاتا ہے۔ قیمت مارکیٹ کے ساتھ بدلتی ہے، اس لیے:
- ہر آرڈر سے پہلے تازہ نرخ مانگیں؛
- max_usd بتائی گئی رقم کے برابر بھیجیں؛
- ہمیشہ currency: "USD" بھیجیں، ورنہ اکاؤنٹ کی محفوظ ترجیح استعمال ہوتی ہے۔
مرحلہ 4: آرڈر بنائیں
POST /api/v1/stars/buy یا /api/v1/premium/buy۔ ہر درخواست میں Idempotency-Key ہونا ضروری ہے، تاکہ کنکشن ٹوٹنے اور دوبارہ کوشش پر دو بار چارج نہ ہو۔ کلید کو آرڈر ID کے ساتھ اپنے ڈیٹا بیس میں محفوظ کریں۔
مرحلہ 5: حیثیت دیکھیں
GET /api/v1/order/{id} اور /api/v1/orders حیثیتیں اور تاریخ دیتے ہیں۔ زیادہ تر آرڈر منٹوں میں پہنچ جاتے ہیں۔ مکمل آرڈر کو TxId ملتا ہے جسے آپ اور آپ کا گاہک PayStars کے عوامی کھاتے پر چیک کر سکتے ہیں۔
غلطیوں کو درست طریقے سے سنبھالنا
- 409 price_changed کا مطلب ہے قیمت max_usd سے اوپر چلی گئی اور کچھ نہیں کاٹا گیا۔ نیا نرخ لیں اور گاہک کو تازہ قیمت دکھائیں۔
- شرح کی حد: فی سیکنڈ 10 درخواستوں سے زیادہ نہ کریں؛ قطار یا وقفہ شامل کریں۔
- دوبارہ کوششیں: ہمیشہ وہی Idempotency-Key دوبارہ استعمال کریں۔
عام اجرا سے پہلے
- API کلید سرور کے ماحولیاتی متغیر میں رکھیں، کوڈ میں نہیں۔
- پورا عمل 50 Stars کے چھوٹے حقیقی آرڈر سے چلائیں۔
- گاہکوں کو ان کا TxId دکھائیں، جس سے اعتماد بنتا ہے۔
مکمل دستاویزات اور فوری شروعات: PayStars Stars API اور API کے لیے USD قیمت۔ بوٹ کے اندر ادائیگیوں کے لیے دیکھیں بوٹس میں ڈیجیٹل سامان صرف Stars میں ادا ہوتا ہے۔
عمومی سوالات
کیا الگ آزمائشی ماحول ہے؟
الگ آزمائشی ماحول نہیں؛ انضمام کے دوران چھوٹے حقیقی آرڈرز (50 Stars) سے جانچ کریں۔
کون سی پروگرامنگ زبانیں کام کرتی ہیں؟
کوئی بھی زبان جو HTTPS درخواستیں بھیج سکے۔ Python، Node.js اور PHP کے لیے فوری شروعات موجود ہیں۔
بیلنس کیسے بھروں؟
TON، BEP20 یا TRC20 پر USDT سے، کم از کم 0.1 USDT؛ ہر انوائس کی عین رقم 30 منٹ تک درست رہتی ہے۔
ذرائع
Related pages
USD (USDT) سے Stars اور Premium خریدیں
ویب سائٹ پر درست کل رقم ادائیگی سے پہلے دکھائی جاتی ہے۔ API کلید کے ذریعے: Fragment قیمت، 0% (ویب سائٹ: 5%)۔
More news
ازبکستان میں Telegram Stars اور Premium: کارڈ سے یا USDT سے ادائیگیازبکستان میں Telegram Stars یا Premium خریدنا: @StarKerakBot کے ذریعے Uzcard اور Humo، paystars.uz/uz/ پر USDT، سرکاری ایپ کے راستے اور مقامی قواعد جنہیں جاننا چاہیے۔پڑھیں →
Telegram Stars یا Premium سے مقابلے کے فاتحین کو انعام کیسے دیں: منتظم کی رہنما کتاباپنے کوئز، مقابلے یا ہیکاتھون کے فاتحین تک Telegram Stars یا Premium پہنچانا: بجٹ، @usernames جمع کرنا، PayStars کے ذریعے ترسیل، اور فالو اپ رپورٹ۔پڑھیں →
PayStars کے عام سوالات: داخل ہونا، USDT سے بیلنس بھرنا، اور Stars و Premium آرڈرزایک صفحے پر PayStars کے سب سے عام سوالات: Telegram سے داخل ہونا، USDT (TON، BEP20 یا TRC20) سے بیلنس بھرنا، Stars اور Premium آرڈر کرنا، ترسیل کا وقت، حفاظت اور API۔پڑھیں →