Beri setiap pengguna alamat deposit kripto sendiri

Kenapa satu alamat bersama tidak cukup

Setiap platform yang menerima kripto menabrak tembok yang sama dengan urutan yang sama, biasanya setelah tiket dukungan pertama soal pembayaran yang tidak ketemu.

• Satu alamat memberi tahu jumlah dan pengirim, tidak pernah milik pengguna yang mana. Mencocokkan lewat nominal langsung rusak begitu dua orang mengirim angka yang sama.
• Akal-akalan yang biasa dipakai adalah menampung semuanya lalu membayarkan belakangan — dan itu mengubah fitur pembayaran menjadi menyimpan uang orang lain, hal terberat yang bisa dipikul sebuah platform.
• Meminta pengguna menempelkan memo atau referensi berhasil sampai ada yang lupa, dan setelah itu ada manusia yang mencocokkan blockchain dengan tangan.

Satu panggilan per pengguna, sekali saja

Anda mengirim id pengguna Anda sendiri. Anda menerima alamat yang tidak pernah berubah, jadi panggilan itu terjadi saat pendaftaran dan tidak pernah lagi.

1. 01

   Buat customer dengan id Anda sendiri

   Kirim id pengguna yang sudah Anda punya di `external_ref`. Unheld tidak membuat identitas baru yang harus Anda simpan dan petakan lagi — datanya diindeks dengan id yang sudah dipakai basis data Anda.

2. 02

   Simpan alamat yang dikembalikan

   Responsnya membawa alamat deposit pengguna tersebut, diturunkan dari dompet Anda sendiri. Alamat itu permanen, jadi bisa Anda tampilkan, jadikan kode QR, atau biarkan pengguna menyimpannya dan mengirim dari mana saja.

3. 03

   Kreditkan akun saat webhook tiba

   Pembayaran ke alamat itu dikaitkan ke customer pemiliknya, dan notifikasinya membawa kembali `externalRef` milik Anda. Aplikasi Anda mengkredit id pengguna yang sudah dikenalnya, tanpa mencocokkan nominal atau membaca rantai.

Panggilan yang sebenarnya

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

Perlu API key dengan scope `customers:write`; membacanya kembali perlu `customers:read`. Alamat untuk setiap chain tempat pengguna bisa membayar tersedia di `GET /api/v1/customers/:id/addresses`.

Bagaimana pembayaran menemukan penggunanya

Invoice juga bisa ditautkan ke customer lewat `customerId`, sehingga tagihan sekali jalan dan alamat deposit tetap dikaitkan ke pengguna yang sama, baik di dasbor maupun di webhook Anda.

Di mana uangnya benar-benar berada

Yang tidak dijawab oleh itu adalah apakah platform Anda sendiri menyimpan dana milik pengguna Anda. Kemungkinan besar iya, kalau pembayaran masuk ke alamat yang Anda kendalikan dan Anda berutang nilainya ke pengguna. Itu pertanyaan tentang skema dan yurisdiksi Anda, dan bukan yang bisa kami jawab untuk Anda — carilah nasihat. Kami hanya bisa menyatakan sisi kami: uangnya tidak pernah lewat Unheld.

Merancang di atas ini

Setiap poin ini lebih mudah dirancang sekarang daripada ditemukan saat produksi.

• Semua alamat pengguna diturunkan dari satu dompet: milik Anda. Itu menyisakan satu frasa pemulihan untuk dijaga, bukan satu per pengguna, dan berarti dana tidak dipisahkan per pengguna lewat kunci.
• Alamat permanen memang dipakai berulang, dan justru itu yang membuat pengaitan bekerja. Artinya juga riwayat pembayaran seorang pengguna kepada Anda bisa dirangkai on-chain oleh siapa pun yang tahu alamatnya.
• Alamat pengguna tetap per keluarga chain: alamat EVM yang sama menerima di semua jaringan EVM yang Anda aktifkan. Mengaktifkan chain baru tidak menuntut penerbitan ulang alamat.
• Menghapus customer menghentikan pemantauan alamatnya; itu tidak — dan tidak bisa — memindahkan apa pun yang sudah dikirim ke sana. Uang yang datang setelah penghapusan tetap milik Anda, tetapi tidak ada yang akan memberi tahu Anda.

Pertanyaan