Роҳнамо · PayStars

PayStars API барои таҳиягарон: ҷараёни пурраи фурӯши Stars ва Premium дар боти шумо

PayStars REST API чӣ гуна аз аввал то охир кор мекунад: X-API-Key, санҷиши номи корбарӣ, иқтибосҳои USD бо max_usd, фармоишҳои идемпотентӣ, хатои 409 price_changed ва санҷиши TxId, ҳамчун нақшаи ҳамгироӣ.

Нашр шуд: · Навсозӣ шуд:

PayStars API барои таҳиягарон: ҷараёни пурраи фурӯши Stars ва Premium дар боти шумо

Мехоҳед 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: пур кардани тавозун

POST /usd/invoice бо маблағ ва занҷир ("ton", "bsc" ё "trc20") маблағи дақиқро бармегардонад, ки 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-ро дубора истифода баред.

Пеш аз ба кор даровардан

  1. Калиди API-ро дар тағйирёбандаи муҳити сервер нигоҳ доред, на дар код.
  2. Тамоми ҷараёнро бо фармоиши хурди воқеии 50 Stars иҷро кунед.
  3. Ба муштариён TxId-и онҳоро нишон диҳед; ин бовариро меафзояд.

Ҳуҷҷатҳои пурра ва дастурҳои зуд оғоз: PayStars Stars API ва нархгузории USD барои API. Барои пардохтҳо дар бот, нигаред молҳои рақамӣ дар ботҳо танҳо бо Stars пардохт мешаванд.

Саволҳои маъмул

Оё муҳити озмоишӣ ҳаст?

Муҳити озмоишии алоҳида нест; ҳангоми ҳамгироӣ бо фармоишҳои хурди воқеӣ (50 Stars) санҷед.

Кадом забонҳои барномасозӣ кор мекунанд?

Ҳар забоне, ки метавонад дархостҳои HTTPS ирсол кунад. Барои Python, Node.js ва PHP дастурҳои зуд оғоз ҳастанд.

Чӣ тавр тавозунро пур кунам?

Бо USDT дар TON, BEP20 ё TRC20, ҳадди ақал 0.1 USDT; ҳар ҳисобнома маблағи дақиқ дорад, ки 30 дақиқа эътибор дорад.

Манбаъҳо

Stars ва Premium-ро бо доллари ИМА (USDT) харед

Бо калиди API: нархи Fragment, 0% (сомона: 5%).

Оғоз кардан