Bigyan ang bawat user ng sariling crypto deposit address

Bakit hindi umuubra ang isang shared na address

Bawat platform na tumatanggap ng crypto ay sumasalpok sa parehong pader sa parehong pagkakasunod, kadalasan pagkatapos ng unang support ticket tungkol sa bayad na walang makahanap.

• Ang iisang address ay nagsasabi ng halaga at ng nagpadala, hindi kailanman kung kanino sa mga user mo ito. Ang pagtutugma sa halaga ay nasisira sa unang pagkakataong dalawang tao ang nagpadala ng parehong numero.
• Ang karaniwang palusot ay ipunin ang lahat at ipamahagi mamaya — na nagiging dahilan para ang isang feature sa bayad ay maging paghawak ng pera ng iba, ang pinakamabigat na bagay na maaaring pasanin ng isang platform.
• Ang paghingi sa user na mag-paste ng memo o reference ay gumagana hanggang may makalimot, at pagkatapos ay may taong nagtutugma ng blockchain nang manu-mano.

Isang tawag kada user, minsan lang

Ipapadala mo ang sarili mong identifier para sa user. Makakatanggap ka ng mga address na hindi nagbabago, kaya nangyayari ang tawag sa signup at hindi na muli.

1. 01

   Gumawa ng customer gamit ang sarili mong id

   Ipasa ang kasalukuyang user id mo sa `external_ref`. Hindi gumagawa ang Unheld ng bagong identifier na kailangan mo pang itago at itugma — naka-index ang record sa id na ginagamit na ng database mo.

2. 02

   Itago ang mga address na ibinalik

   Dala ng response ang mga deposit address ng user na iyon, hango sa sarili mong wallet. Permanente ang mga ito, kaya maaari mong ipakita, ilagay sa QR code, o hayaang i-save ng user at magpadala mula kahit saan.

3. 03

   I-kredito ang account pagdating ng webhook

   Ang bayad sa address na iyon ay naiuugnay sa customer na nagmamay-ari nito, at dala ng notipikasyon pabalik ang sarili mong `externalRef`. Nagkakredito ang app mo sa user id na alam na nito, nang walang pagtutugma ng halaga o pagbabasa ng chain.

Ang totoong tawag

Request

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
  }'

Response

{
  "id": "c7f1…",
  "external_ref": "user_8412",
  "label": "Ada Lovelace",
  "evm_address": "0x…",
  "supported_assets": ["ETH", "USDC"],
  "receive_method": "auto"
}

Kailangan ng API key na may `customers:write` scope; ang pagbasa muli ay nangangailangan ng `customers:read`. Ang mga address para sa bawat chain na maaaring bayaran ng user ay nasa `GET /api/v1/customers/:id/addresses`.

Paano nahahanap ng bayad ang user nito

Maaari ring iugnay ang mga invoice sa isang customer gamit ang `customerId`, kaya ang isang beses na singil at ang permanenteng deposit address ay parehong naiuugnay sa iisang user, sa dashboard mo at sa mga webhook mo.

Nasaan talaga ang pera

Ang hindi sinasagot niyan ay kung ang platform mo ba mismo ay may hawak na pondo para sa mga user mo. Malamang oo, kung dumarating ang bayad sa mga address na kontrolado mo at may utang kang halaga sa kanila. Tanong iyon tungkol sa sarili mong ayos at hurisdiksyon, at hindi iyon masasagot namin para sa iyo — kumuha ng payo. Ang masasabi lang namin ay ang panig namin: hindi kailanman dumadaan ang pera sa Unheld.

Pagdidisenyo rito

Mas madaling idisenyo ang bawat isa nito ngayon kaysa matuklasan sa production.

• Bawat address ng user ay hango sa iisang wallet — sa iyo. Iisang recovery phrase lang ang poprotektahan mo, hindi isa kada user, at ibig sabihin ay hindi hiwalay ang pondo kada user sa antas ng susi.
• Sinasadyang gamitin muli ang permanenteng address, at iyon ang dahilan kaya gumagana ang pag-uugnay. Ibig ding sabihin, ang kasaysayan ng bayad ng isang user sa iyo ay maiuugnay on-chain ng sinumang makaalam ng address niya.
• Nakapirmi ang address ng user kada pamilya ng chain: ang parehong EVM address ay tumatanggap sa lahat ng EVM network na binuksan mo. Ang pagbukas ng bagong chain ay hindi nangangailangan ng muling paglabas ng address.
• Ang pagtanggal ng customer ay humihinto sa pagbabantay sa address niya; hindi nito — at hindi nito kayang — igalaw ang naipadala na roon. Ang perang dumating pagkatapos ng pagtanggal ay sa iyo pa rin, pero walang magpapaalam sa iyo tungkol dito.

Mga tanong