ለምን አንድ የጋራ አድራሻ አይሠራም
ክሪፕቶ የሚቀበል እያንዳንዱ መድረክ ተመሳሳይ ግድግዳ በተመሳሳይ ቅደም ተከተል ይመታል፤ ብዙውን ጊዜ ማንም ስለማያገኘው ክፍያ ከመጣው የመጀመሪያ የድጋፍ ጥያቄ በኋላ።
- አንድ አድራሻ የሚነግርዎ መጠኑንና ላኪውን ብቻ ነው፤ የትኛው ተጠቃሚዎ እንደሆነ በፍጹም አይነግርዎትም። በመጠን ማዛመድም ሁለት ሰዎች ተመሳሳይ ቁጥር በላኩ ቅጽበት ይፈርሳል።
- የተለመደው መፍትሔ ሁሉንም አጠራቅሞ በኋላ መክፈል ነው — ይህ ደግሞ የክፍያ ባህሪን ወደ የሌሎች ሰዎች ገንዘብ መያዝ ይለውጠዋል፤ ይህም መድረክ ሊሸከመው ከሚችለው ሁሉ የከበደው ነው።
- ተጠቃሚዎች ማስታወሻ ወይም መለያ ቁጥር እንዲለጥፉ መጠየቅ አንድ ሰው እስኪረሳ ድረስ ይሠራል፤ ከዚያ በኋላ ሰው በእጁ ብሎክቼይን የሚያስታርቅ ይሆናል።
ለእያንዳንዱ ተጠቃሚ አንድ ጥሪ፣ አንድ ጊዜ ብቻ
የራስዎን የተጠቃሚ መለያ ይልካሉ፤ በምላሹ ፈጽሞ የማይለወጡ አድራሻዎችን ያገኛሉ። ጥሪው በምዝገባ ጊዜ ይከሰታል፤ ከዚያ በኋላ ዳግም አያስፈልግም።
- 01
customerን በራስዎ መለያ ይፍጠሩ
ያለዎትን የተጠቃሚ መለያ በ`external_ref` ውስጥ ይላኩ። Unheld በኋላ አስቀምጠው የሚያዛምዱት አዲስ መለያ አይፈጥርም — መዝገቡ የመረጃ ቋትዎ አስቀድሞ በሚጠቀመው መለያ ነው የተመዘገበው።
- 02
የተመለሱልዎትን አድራሻዎች ያስቀምጡ
ምላሹ የዚያን ተጠቃሚ የመቀበያ አድራሻዎች ይዞ ይመጣል፤ ከራስዎ ቦርሳ የተገኙ ናቸው። ቋሚ በመሆናቸው ማሳየት፣ በQR ኮድ ውስጥ ማስገባት፣ ወይም ተጠቃሚው አስቀምጦ ከየትም እንዲልክ መፍቀድ ይችላሉ።
- 03
webhook ሲደርስ ሂሳቡን ያስገቡ
ወደዚያ አድራሻ የገባ ክፍያ ለባለቤቱ customer ይመደባል፤ ማስታወቂያውም የራስዎን `externalRef` መልሶ ያመጣል። መተግበሪያዎ አስቀድሞ የሚያውቀውን የተጠቃሚ መለያ ያስገባል፤ መጠን ማዛመድም ሆነ ሰንሰለት ማንበብ ሳያስፈልገው።
ትክክለኛው ጥሪ
ጥያቄ
curl -X POST https://api.unheld.io/api/v1/customers \
-H "Authorization: Bearer $UNHELD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"external_ref": "user_8412",
"label": "Ada Lovelace",
"supported_assets": ["ETH", "USDC"],
"evm": true
}'ምላሽ
{
"id": "c7f1…",
"external_ref": "user_8412",
"label": "Ada Lovelace",
"evm_address": "0x…",
"supported_assets": ["ETH", "USDC"],
"receive_method": "auto"
}`customers:write` ፈቃድ ያለው የAPI ቁልፍ ይፈልጋል፤ መልሶ ለማንበብ ደግሞ `customers:read` ያስፈልጋል። ተጠቃሚ ሊከፍልባቸው የሚችሉ የእያንዳንዱ ሰንሰለት አድራሻዎች በ`GET /api/v1/customers/:id/addresses` ይገኛሉ።
ክፍያ ባለቤቱን እንዴት ያገኛል
አድራሻው ራሱ መለያው ነው። የአንድ customer ብቻ ስለሆነና ስለማይለወጥ፣ የሚደርስ ክፍያ ያለ ማስታወሻ፣ ያለ የመለያ ሜዳ እና ያለ በመጠን ፍለጋ ይመደባል — እነዚህ ሦስቱ ናቸው በተግባር ላይ የሚፈርሱት።
ደረሰኞችም በ`customerId` ከcustomer ጋር ሊያያዙ ይችላሉ፤ ስለዚህ አንድ ጊዜ የሚደረግ ክፍያና ቋሚ የመቀበያ አድራሻ ለተመሳሳይ ተጠቃሚ ይመደባሉ — በዳሽቦርድዎም ሆነ በwebhookዎ።
ገንዘቡ በእውነት የት ነው ያለው
ገንዘቡ ከራስዎ ቦርሳ ወደ ተገኙ አድራሻዎች ይደርሳል። Unheld የሚያስቀምጠው የሚነበብ ብቻ የሆነውን የይፋ ክፍል ነው፤ ስለዚህ ሊያንቀሳቅሰው፣ ሊያቀዘቅዘው ወይም ሊያጠፋው አይችልም፤ በኋላ ሊከፍልዎ የተያዘ ሒሳብም እዚህ የለም።
ይህ የማይነግርዎ ነገር ግን መድረክዎ ራሱ ለተጠቃሚዎቹ ገንዘብ እየያዘ ይሆን የሚለውን ነው። ክፍያዎቹ እርስዎ በሚቆጣጠሯቸው አድራሻዎች ላይ የሚደርሱ ከሆነና ያንን ዋጋ ለተጠቃሚዎችዎ ዕዳ ካለብዎ፣ ምናልባትም እየያዙ ነው። ይህ የራስዎን አደረጃጀትና የሕግ ክልል የሚመለከት ጥያቄ ነው፤ በእርስዎ ስም ልንመልሰው የምንችለውም አይደለም — ምክር ይጠይቁ። እኛ ማረጋገጥ የምንችለው የእኛን በኩል ብቻ ነው፦ ገንዘቡ በUnheld በኩል ፈጽሞ አያልፍም።
በዚህ ላይ መገንባት
ከእነዚህ እያንዳንዱ አሁን ተነድፎ መያዙ በምርት ላይ ከመገኘቱ ይቀላል።
- እያንዳንዱ የተጠቃሚ አድራሻ ከአንድ ቦርሳ — ከእርስዎ — ይመነጫል። ይህም ለእያንዳንዱ ተጠቃሚ ሳይሆን አንድ ብቻ የመልሶ ማግኛ ሐረግ እንዲጠብቁ ያደርጋል፤ በተጨማሪም ገንዘቡ በቁልፍ ደረጃ በተጠቃሚ ተለይቶ አልተከፋፈለም ማለት ነው።
- ቋሚ አድራሻ ሆን ተብሎ ደጋግሞ ይሠራበታል፤ ይህም መመደቡን የሚያሠራው ነው። በተመሳሳይም የአንድ ተጠቃሚ የክፍያ ታሪክ ወደ እርስዎ አድራሻውን ባወቀ ማንኛውም ሰው በሰንሰለቱ ላይ ሊገናኝ ይችላል ማለት ነው።
- የተጠቃሚ አድራሻ በሰንሰለት ቤተሰብ ደረጃ ቋሚ ነው፦ ተመሳሳዩ የEVM አድራሻ በከፈቷቸው በሁሉም የEVM መረቦች ላይ ይቀበላል። አዲስ ሰንሰለት መክፈት አድራሻዎችን እንደገና ማውጣት አያስፈልገውም።
- customerን መሰረዝ አድራሻውን መከታተል ያቆማል፤ ነገር ግን አስቀድሞ የተላከውን አያንቀሳቅስም — ሊያንቀሳቅስም አይችልም። ከተሰረዘ በኋላ የሚደርሰው ገንዘብ አሁንም የእርስዎ ነው፤ ግን ስለሱ የሚነግርዎ ምንም አይኖርም።
ጥያቄዎች
Unheld የተጠቃሚዎቼን ገንዘብ ይይዛል?
አይይዝም። ክፍያዎቹ ከራስዎ ቦርሳ ወደ ተገኙ አድራሻዎች ይሄዳሉ፤ Unheld የሚያስቀምጠውም የሚነበብ ብቻ የሆነውን የይፋ ቁልፍ ነው፤ ስለዚህ እዚህ ሒሳብ የለም፣ የሚወጣም ነገር የለም። መድረክዎ ራሱ ለተጠቃሚዎቹ ዋጋ ይይዝ እንደሆነ ግን ሌላ ጥያቄ ነው፤ የራስዎን አደረጃጀት የሚመለከትና ከግብይት ገጽ መልስ ይልቅ የሕግ ምክር የሚገባው።
ስንት ተጠቃሚዎች የየራሳቸው አድራሻ ሊኖራቸው ይችላል?
በተጠቃሚ የአድራሻ ገደብ የለም — አድራሻዎቹ ከተወሰነ ክምችት የሚወሰዱ ሳይሆኑ የሚመነጩ ናቸው፤ ስለዚህ ሚሊዮነኛውን customer መፍጠር እንደ መጀመሪያው ተመሳሳይ ሥራ ነው። የሚለካው የዕቅድዎ የcustomer ኮታና የግብይት ብዛት ሲሆን ሁለቱም በዋጋ ገጹ ላይ ተቀምጠዋል።
የተጠቃሚ አድራሻ ሊለወጥ ይችላል?
አይችልም። መላው ንድፍ የቆመበት ባህሪ ይኸው ነው፦ አድራሻው ተጠቃሚውን ስለሚለይ አንድ ጊዜ ወጥቶ ይቀራል። ማሳየት፣ በQR ኮድ ውስጥ ማካተት፣ ወይም ተጠቃሚው በራሱ ቦርሳ እንዲያስቀምጠው መፍቀድ ይችላሉ፤ ከዓመት በኋላም ትክክል ሆኖ ይቀጥላል።
ሁለት ተጠቃሚዎች በተመሳሳይ ሰዓት ተመሳሳይ መጠን ቢከፍሉስ?
ምንም ግራ የሚያጋባ ነገር አይፈጠርም፤ ምክንያቱም መጠኖች ማንንም ለመለየት ፈጽሞ አይጠቀሙም። እያንዳንዱ ክፍያ የአንድ customer ብቻ ወደሆነ አድራሻ ይደርሳል፤ webhookም ለዚያ customer የራስዎን መለያ ይዞ ይመጣል — ተመሳሳይ መጠን፣ ተመሳሳይ ሰዓትና ተመሳሳይ ላኪ ሁሉም ትርጉም የላቸውም።
በtestnet ላይ አንድ customer ይፍጠሩ
ጥሪውን በሙከራ የAPI ቁልፍ ያድርጉ፣ እውነተኛ አድራሻዎችን ይቀበሉ፣ ከዚያም ወደ አንዱ የtestnet ክፍያ ልከው መመደቡ ሲደርስ ይመልከቱ — እውነተኛ ገንዘብ ከመንካትዎ በፊት።
በነጻ ይጀምሩገንቢዎች · ምዝገባዎች · ዋጋ · ገንዘብ የማይይዝ · በግልጽ ተመልሰዋል።