መመሪያ · PayStars

ለገንቢዎች የPayStars API፦ በቦትዎ ውስጥ Stars እና Premium ለመሸጥ ሙሉው ፍሰት

PayStars REST API ከጫፍ እስከ ጫፍ እንዴት እንደሚሰራ፦ X-API-Key፣ የተጠቃሚ ስም ፍተሻዎች፣ ከmax_usd ጋር የ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 መያዝ አለበት፣ ስለዚህ ግንኙነቱ ቢቋረጥ እና እንደገና ቢሞክሩ ሁለት ጊዜ አይከፈልብዎትም። ቁልፉን ከትዕዛዝ መለያው ጋር በመረጃ ቋትዎ ውስጥ ያስቀምጡ።

ደረጃ 5፦ ሁኔታውን መከታተል

GET /api/v1/order/{id} እና /api/v1/orders ሁኔታዎችን እና ታሪክ ይሰጡዎታል። አብዛኛዎቹ ትዕዛዞች በደቂቃዎች ውስጥ ይደርሳሉ። የተጠናቀቀ ትዕዛዝ እርስዎም ደንበኛዎም በPayStars ይፋዊ መዝገብ ላይ ሊያረጋግጡት የሚችሉ TxId ያገኛል።

ስህተቶችን በትክክል መያዝ

  • 409 price_changed ማለት ዋጋው ከmax_usd በላይ ሄዷል እና ምንም አልተከፈለም ማለት ነው። አዲስ ዋጋ ጥያቄ ያግኙ እና ለደንበኛው የተዘመነውን ዋጋ ያሳዩ።
  • የፍጥነት ገደብ፦ በሰከንድ ከ10 ጥያቄዎች አይበልጡ፤ ወረፋ ወይም የኋላ መጠበቂያ ይጨምሩ።
  • ድጋሚ ሙከራዎች፦ ሁልጊዜ ተመሳሳዩን Idempotency-Key እንደገና ይጠቀሙ።

ከመጀመርዎ በፊት

  1. የAPI ቁልፉን በኮዱ ውስጥ ሳይሆን በአገልጋይ የአካባቢ ተለዋዋጭ ውስጥ ያቆዩ።
  2. ሙሉውን ፍሰት በትንሽ እውነተኛ የ50 Stars ትዕዛዝ ያሂዱ።
  3. ለደንበኞች TxId ያሳዩ፣ ይህም እምነት ይገነባል።

ሙሉ ሰነዶች እና ፈጣን መመሪያዎች፦ PayStars Stars API እና ለAPI የUSD ዋጋ አሰጣጥ። ለቦት ውስጥ ክፍያዎች፣ በቦቶች ውስጥ ዲጂታል እቃዎች በStars ብቻ ይከፈላሉ ይመልከቱ።

ተደጋጋሚ ጥያቄዎች

የሙከራ አካባቢ አለ?

የተለየ የሙከራ አካባቢ የለም፤ በማዋሃድ ጊዜ በትንሽ እውነተኛ ትዕዛዞች (50 Stars) ይሞክሩ።

የትኞቹ የፕሮግራም ቋንቋዎች ይሰራሉ?

HTTPS ጥያቄ ማቅረብ የሚችል ማንኛውም ቋንቋ። ለPython፣ Node.js እና PHP ፈጣን መመሪያዎች አሉ።

ቀሪ ሂሳቡን እንዴት እሞላለሁ?

በTON፣ BEP20 ወይም TRC20 ላይ በUSDT፣ ዝቅተኛው 0.1 USDT፤ እያንዳንዱ ደረሰኝ ለ30 ደቂቃዎች የሚሰራ ትክክለኛ መጠን አለው።

ምንጮች

Stars እና Premium በ USD (USDT) ይግዙ

በ API ቁልፍ፦ የ Fragment ዋጋ፣ 0% (ድረ-ገጽ: 5%)።

ይጀምሩ