በነጻ ይጀምሩ
አማርኛ

ገንቢዎች

ለቀጥተኛ መወራረድ የተሠራ የክሪፕቶ ክፍያ API

በአንድ የተረጋገጠ ጥያቄ ደረሰኝ ይፍጠሩ፤ Unheld የሚከፈልበትን አድራሻ፣ ትክክለኛውን መጠን፣ እና የሚጠብቀውን የማረጋገጫ ጥልቀት ይመልሳል። ክፍያዎች እርስዎ ወደሚቆጣጠሩት ዋሌት በቀጥታ ይወራረዳሉ — API ደግሞ የሚዘግበውን ገንዘብ ፈጽሞ አይይዝም።

በነጻ ይጀምሩዋጋ

ደረሰኝ መፍጠር

አንድ POST። መጠኑ ሰው እንደሚጽፈው ይጻፋል፣ በአገልጋዩ በኩልም በንብረቱ የአስርዮሽ ቦታዎች መሠረት ይመዘናል፤ ስለዚህ ወደ መሠረታዊ አሃዶች በእጅ አይለውጡም።

curl -X POST https://api.unheld.io/api/v1/invoices \
  -H "Authorization: Bearer $UNHELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chainId": "11155111",
    "assetType": "native",
    "amountDecimal": "0.05",
    "expiresInSeconds": 900,
    "metadata": { "orderId": "A-1043" }
  }'

ምላሽ

{
  "id": "e2b0…",
  "status": "CREATED",
  "receiveAddress": "0x…",
  "expectedAmount": "50000000000000000",
  "minConfirmations": 3,
  "expiresAt": "2026-08-10T14:15:00.000Z",
  "instructions": {
    "chainId": "11155111",
    "to": "0x…",
    "amount": "50000000000000000",
    "assetType": "native"
  }
}

receiveAddress ከዋሌትዎ የሚመነጭ ሲሆን በዚህ ደረሰኝ ላይ ተቆልፏል። expectedAmount በመሠረታዊ አሃዶች ነው። minConfirmations ደግሞ የሰንሰለቱ ራሱ ገደብ እንጂ እኛ የፈጠርነው ቅንብር አይደለም።

ማረጋገጫና የፈቃድ ወሰኖች

ቁልፎቹ bearer ቶከኖች ናቸው፤ በዳሽቦርድ ይፈጠራሉ አንዴም ብቻ ይታያሉ። እያንዳንዱ ቁልፍ ግልጽ የፈቃድ ዝርዝር ይይዛል፣ ቁልፉ ለዚያ መንገድ ፈቃድ ከሌለውም ጥያቄው ይከለከላል።

ያሉ የፈቃድ ወሰኖች

  • invoices:write
  • invoices:read
  • webhooks:write
  • webhooks:read
  • balances:read
  • customers:write
  • customers:read
  • subscriptions:write
  • subscriptions:read

የሚሠራውን በጣም ጠባቡን ስብስብ ይስጡ። ደረሰኝ ብቻ የሚፈጥር ቁልፍ ደንበኞችዎን ማንበብ አይችልም፣ የተለቀቀ የንባብ ቁልፍም ምንም ማንቀሳቀስ አይችልም — ምክንያቱም በዚህ API ውስጥ ምንም የሚያንቀሳቅስ የለም።

ማረጋገጥ የሚችሏቸው webhooks

እያንዳንዱ ማድረስ ተፈርሟል። ፊርማው የጊዜ ማህተሙና ጥሬው አካል በነጥብ ተያይዘው በwebhook ሚስጥርዎ የተሠራ HMAC-SHA256 ሲሆን በሄክሳዴሲማል ይላካል።

አንድ ማድረስ ማረጋገጥ

const signature = crypto
  .createHmac("sha256", webhookSecret)
  .update(`${req.headers["x-timestamp"]}.${rawBody}`)
  .digest("hex");

crypto.timingSafeEqual(
  Buffer.from(signature),
  Buffer.from(req.headers["x-signature"])
);

ማጠቃለያዎቹን በቋሚ ጊዜ ያወዳድሩ፣ ከመቻቻል መስኮትዎ ውጪ ያለን የጊዜ ማህተም ይከልክሉ፣ እና X-Request-Idን እንደ የድግግሞሽ መከላከያ ቁልፍ ይያዙት፦ ድጋሚ ሙከራዎች ተመሳሳዩን እሴት ይጠቀማሉ፣ ስለዚህ ተመሳሳይ ክስተት ሁለት ጊዜ መድረሱ የተለመደ ነው ሁለት ጊዜም መስተናገድ የለበትም።

የደረሰኝ ክስተቶች

ክፍያ ካልተከፈለ ወደ ተከፈለ በአንዴ ከመዞር ይልቅ በተለያዩ ሁኔታዎች ያልፋል፣ እያንዳንዱ ሽግግርም webhook ነው። በጎደለ መክፈልና በትርፍ መክፈል የየራሳቸው ክስተቶች እንጂ ስህተቶች አይደሉም።

ክስተትየተከሰተው
invoice.createdደረሰኙ አለ የመቀበያ አድራሻውም እየተከታተለ ነው።
invoice.receivingበሰንሰለቱ ላይ የክፍያ ግብይት ታይቷል ግን ገና አልተረጋገጠም።
invoice.confirmingክፍያው እየተረጋገጠ ነው የሰንሰለቱንም ገደብ ገና አልደረሰም።
invoice.paidሰንሰለቱ በሚጠይቀው ጥልቀት ሙሉ በሙሉ ተረጋግጧል። ማቅረብ ይችላሉ።
invoice.underpaidከተጠበቀው ያነሰ ደርሷል። ከፊል ክፍያዎች ስለሚደመሩ ሁለተኛ ዝውውር ሊያሟላው ይችላል።
invoice.overpaidከተጠበቀው በላይ ደርሷል፤ ከመጠጋጋት ይልቅ በትክክል ተመዝግቧል።
invoice.expiredሙሉ ክፍያ ሳይኖር መስኮቱ ተዘግቷል።

ሙሉውን ሂደት በነጻ ይሞክሩ

ያለ እውነተኛ ገንዘብ ደረሰኝ፣ መገኘት፣ ማረጋገጫ እና webhook ይሞክሩ። የtestnet ቶከኖች የገንዘብ ዋጋ የላቸውም። የtestnet እንቅስቃሴ እውነተኛ ክፍያ አይደለም።

ወሰን

  • ገንዘብ ፈጽሞ አይይዝም። የሚወጣበት የቀሪ ሂሳብ መንገድ የለም፣ ምክንያቱም ክፍያዎች በአድራሻዎ ላይ አርፈው እዚያው ይቆያሉ።
  • በተለመደ ገንዘብ አይለውጥም አይወራረድምም። ክፍያዎች በተላኩበት ንብረትና ሰንሰለት ይደርሳሉ።
  • ገና ይፋዊ SDKዎች የሉም። እዚህ ያለው ሁሉ ተራ HTTP ነው፣ በደንብ የማንጠብቃቸውን ጥቅሎች ከማውጣት ይልቅ ምሳሌዎችን እናትማለን።

የገንቢዎች ጥያቄዎች

የሙከራ አካባቢ አለ?

ያለ እውነተኛ ገንዘብ ደረሰኝ፣ መገኘት፣ ማረጋገጫ እና webhook ይሞክሩ። የtestnet ቶከኖች የገንዘብ ዋጋ የላቸውም። የtestnet እንቅስቃሴ እውነተኛ ክፍያ አይደለም።

ተመሳሳዩን webhook ሁለት ጊዜ ከማስተናገድ እንዴት እቆጠባለሁ?

X-Request-Idን እንደ የድግግሞሽ መከላከያ ቁልፍ ይጠቀሙ። ድጋሚ ሙከራዎች ተመሳሳዩን እሴት ስለሚጠቀሙ ይመዝግቡት ድግግሞሹንም ችላ ይበሉ። ድጋሚ ሙከራዎች የሚጠበቁ ናቸው፦ የከሸፈ ማድረስ ከመጣል ይልቅ በጊዜ ሰሌዳ ይደገማል።

መጠኖችን ወደ መሠረታዊ አሃዶች ራሴ መለወጥ አለብኝ?

የለብዎትም። amountDecimalን ሰው እንደሚጽፈው ይላኩ፤ API በንብረቱ አስርዮሽ መሠረት ይመዝነዋል። ምላሹም expectedAmountን በመሠረታዊ አሃዶች ይመልሳል፤ ስለዚህ ሁለቱም አገላለጾች ግልጽ ሆነው ሊለያዩ አይችሉም።

ምሳሌዎቹ ከቀጥታው API ጋር የተረጋገጡት በ .

መጀመሪያ በtestnet ላይ ይገንቡ

ቁልፍ ይፍጠሩ፣ ወደ testnet ሰንሰለት ይመሩት፣ እና እውነተኛ ነገር ከመንቀሳቀሱ በፊት ሙሉውን ሂደት ያሂዱ።

በነጻ ይጀምሩ

ዋጋ · ዛሬ ሊቀበሉት የሚችሉት። · ገንዘብዎ በእኛ በኩል አያልፍም።