Beri setiap pengguna alamat deposit kripto tersendiri

Mengapa satu alamat berkongsi tidak menjadi

Setiap platform yang menerima kripto melanggar dinding yang sama mengikut urutan yang sama, biasanya selepas tiket sokongan pertama tentang bayaran yang tiada siapa jumpa.

• Satu alamat memberitahu anda jumlah dan penghantar, bukan pengguna mana yang memilikinya. Padanan mengikut jumlah runtuh kali pertama dua orang menghantar angka yang sama.
• Jalan pintas biasa ialah mengumpul semuanya dan membayar kemudian — yang menukar ciri pembayaran menjadi memegang wang orang lain, perkara paling berat yang boleh dipikul oleh sesebuah platform.
• Meminta pengguna menampal memo atau rujukan berkesan sehinggalah seseorang terlupa, dan selepas itu ada manusia memadankan rantaian blok secara manual.

Satu panggilan bagi setiap pengguna, sekali sahaja

Anda menghantar pengecam pengguna anda sendiri. Anda menerima alamat yang tidak pernah berubah, jadi panggilan itu berlaku semasa pendaftaran dan tidak lagi selepas itu.

1. 01

   Cipta pelanggan dengan id anda sendiri

   Hantar id pengguna sedia ada anda dalam `external_ref`. Unheld tidak mencipta pengecam baharu yang kemudian perlu anda simpan dan padankan — rekod itu diindeks dengan id yang memang digunakan pangkalan data anda.

2. 02

   Simpan alamat yang dikembalikan

   Respons membawa alamat deposit pengguna itu, diterbitkan daripada dompet anda sendiri. Ia kekal, jadi anda boleh memaparkannya, meletakkannya dalam kod QR, atau membiarkan pengguna menyimpannya dan menghantar dari mana-mana.

3. 03

   Kreditkan akaun apabila webhook tiba

   Bayaran ke alamat itu dikaitkan dengan pelanggan yang memilikinya, dan pemberitahuan itu membawa balik `externalRef` anda sendiri. Aplikasi anda mengkredit id pengguna yang memang sudah dikenalinya, tanpa memadankan jumlah atau membaca rantaian.

Panggilan sebenar

Permintaan

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

Respons

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

Memerlukan kunci API dengan skop `customers:write`; membacanya semula memerlukan `customers:read`. Alamat bagi setiap rantaian yang boleh digunakan pengguna untuk membayar ada di `GET /api/v1/customers/:id/addresses`.

Bagaimana bayaran menemui penggunanya

Invois juga boleh dipautkan kepada pelanggan dengan `customerId`, supaya caj sekali sahaja dan alamat deposit tetap dikaitkan kepada pengguna yang sama, di papan pemuka anda dan di webhook anda.

Di mana wang itu sebenarnya berada

Apa yang tidak dijawab oleh itu ialah sama ada platform anda sendiri memegang dana bagi penggunanya. Berkemungkinan besar ya, jika bayaran tiba pada alamat yang anda kawal dan anda terhutang nilainya kepada pengguna. Itu soal susunan dan bidang kuasa anda sendiri, dan bukan sesuatu yang boleh kami jawab bagi pihak anda — dapatkan nasihat. Kami hanya boleh menyatakan pihak kami: wang itu tidak pernah melalui Unheld.

Mereka bentuk di atasnya

Setiap satu daripada ini lebih mudah direka bentuk sekarang berbanding ditemui semasa produksi.

• Setiap alamat pengguna diterbitkan daripada satu dompet: dompet anda. Ini meninggalkan satu frasa pemulihan untuk dilindungi, bukan satu bagi setiap pengguna, dan bermakna dana tidak diasingkan mengikut pengguna melalui kunci.
• Alamat kekal digunakan semula secara sengaja, dan itulah yang membolehkan pengaitan berfungsi. Ia juga bermakna sejarah pembayaran seseorang pengguna kepada anda boleh dihubungkan atas-rantaian oleh sesiapa yang mengetahui alamatnya.
• Alamat pengguna tetap mengikut keluarga rantaian: alamat EVM yang sama menerima pada setiap rangkaian EVM yang anda dayakan. Mendayakan rantaian baharu tidak memerlukan alamat dikeluarkan semula.
• Memadam pelanggan menghentikan pemantauan alamatnya; ia tidak — dan tidak boleh — memindahkan apa-apa yang sudah dihantar ke sana. Wang yang tiba selepas pemadaman tetap milik anda, tetapi tiada apa yang akan memberitahu anda mengenainya.

Soalan