Cấp cho mỗi người dùng một địa chỉ nạp crypto riêng

Vì sao một địa chỉ dùng chung không ổn

Mọi nền tảng nhận crypto đều đâm vào cùng một bức tường theo cùng một thứ tự, thường là ngay sau phiếu hỗ trợ đầu tiên về một khoản tiền không ai tìm ra.

• Một địa chỉ duy nhất cho bạn biết số tiền và người gửi, chứ không bao giờ cho biết đó là của người dùng nào. Đối chiếu theo số tiền sẽ vỡ ngay lần đầu có hai người gửi cùng một con số.
• Cách chữa cháy quen thuộc là gom hết lại rồi chi trả sau — và điều đó biến một tính năng thanh toán thành việc giữ tiền của người khác, gánh nặng lớn nhất mà một nền tảng có thể nhận lấy.
• Bảo người dùng dán một memo hay mã tham chiếu sẽ ổn cho tới khi có người quên, và sau đó là một con người ngồi đối chiếu blockchain bằng tay.

Một lệnh gọi cho mỗi người dùng, đúng một lần

Bạn gửi chính mã người dùng của mình. Bạn nhận lại những địa chỉ không bao giờ đổi, nên lệnh gọi chỉ xảy ra lúc đăng ký và không bao giờ lặp lại.

1. 01

   Tạo customer bằng id của chính bạn

   Truyền mã người dùng sẵn có của bạn vào `external_ref`. Unheld không sinh ra một mã mới để rồi bạn phải lưu và ánh xạ lại — bản ghi được lập chỉ mục theo đúng mã mà cơ sở dữ liệu của bạn đang dùng.

2. 02

   Lưu lại các địa chỉ nhận được

   Phản hồi mang theo các địa chỉ nạp của người dùng đó, dẫn xuất từ chính ví của bạn. Chúng cố định, nên bạn có thể hiển thị, đưa vào mã QR, hoặc để người dùng tự lưu và gửi từ bất cứ đâu.

3. 03

   Ghi có tài khoản khi webhook về

   Khoản tiền vào địa chỉ đó được gán cho đúng customer sở hữu nó, và thông báo trả lại chính `externalRef` của bạn. Ứng dụng của bạn ghi có cho một id người dùng nó đã biết, không cần đối chiếu số tiền hay đọc chuỗi khối.

Lệnh gọi thật

Yêu cầu

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

Phản hồi

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

Cần API key có quyền `customers:write`; đọc lại thì cần `customers:read`. Địa chỉ trên mọi chuỗi mà người dùng có thể thanh toán nằm ở `GET /api/v1/customers/:id/addresses`.

Một khoản thanh toán tìm về người dùng của nó thế nào

Hóa đơn cũng có thể gắn với một customer qua `customerId`, để một lần thu tiền riêng lẻ và một địa chỉ nạp cố định đều quy về cùng một người dùng, trên bảng điều khiển lẫn trong webhook của bạn.

Tiền thật sự nằm ở đâu

Điều đó không trả lời được câu hỏi liệu chính nền tảng của bạn có đang giữ tiền cho người dùng hay không. Nhiều khả năng là có, nếu tiền về các địa chỉ bạn kiểm soát và bạn nợ người dùng giá trị đó. Đó là câu hỏi về mô hình và pháp lý của riêng bạn, và không phải câu chúng tôi trả lời thay được — hãy tìm tư vấn. Chúng tôi chỉ khẳng định được phía mình: tiền không bao giờ đi qua Unheld.

Thiết kế trên nền này

Mỗi điểm ở đây đều dễ tính trước bây giờ hơn là phát hiện khi đã chạy thật.

• Mọi địa chỉ người dùng đều dẫn xuất từ một ví duy nhất: ví của bạn. Nhờ vậy bạn chỉ phải bảo vệ một cụm từ khôi phục chứ không phải một cụm cho mỗi người dùng — và cũng có nghĩa tiền không được tách riêng theo từng người dùng ở cấp khóa.
• Địa chỉ cố định được tái sử dụng có chủ ý, và chính điều đó khiến việc gán hoạt động. Nó cũng có nghĩa lịch sử thanh toán của một người dùng cho bạn có thể bị liên kết trên chuỗi bởi bất kỳ ai biết địa chỉ của họ.
• Địa chỉ của một người dùng cố định theo họ chuỗi: cùng một địa chỉ EVM nhận trên mọi mạng EVM bạn đã bật. Bật thêm chuỗi mới không buộc phải cấp lại địa chỉ.
• Xóa một customer sẽ dừng việc theo dõi địa chỉ của họ; nó không — và không thể — chuyển đi thứ đã được gửi tới đó. Tiền về sau khi xóa vẫn là của bạn, nhưng sẽ không có gì báo cho bạn biết.

Câu hỏi