| Thời gian | Coin | Mã đơn | Địa chỉ nạp | Cần nạp | Đã nhận | Còn thiếu | Trạng thái |
|---|
Chỉ dán xpub / ypub / zpub (khóa công khai mở rộng cấp tài khoản). Tuyệt đối không dán seed hay private key – server sẽ từ chối. Sau khi dán, hãy bấm Xem trước và so 3 địa chỉ đầu với ví của bạn trước khi lưu.
Key hiện tại: chưa tạo
Mọi request gửi kèm header X-API-Key: <api key>. Gọi từ server của bạn, không gọi từ trình duyệt của thành viên.
POST /api/v1/invoices
{ "coin": "USDT_BEP20", "amount": "25.5", "order_id": "user123-0001",
"callback_url": "https://site-cua-ban.com/callback", "ttl_minutes": 60 }
→ 201 { "id": "inv_…", "address": "0x…", "amount": "25.5", "status": "pending", … }
coin: BTC, LTC, USDT_ERC20, USDT_BEP20. callback_url, ttl_minutes, order_id là tùy chọn.
GET /api/v1/invoices/{id}
GET /api/v1/invoices?order_id=user123-0001
→ { "status": "underpaid", "success": false, "amount": "25.5",
"received": "20", "received_confirmed": "20", "missing": "5.5", "overpaid": false, … }
pending | Chưa nạp |
underpaid | Nạp thiếu – xem missing để yêu cầu nạp bổ sung vào cùng địa chỉ. Không bao giờ là thành công. |
confirming | Đã thấy đủ tiền, đang chờ đủ số xác nhận mạng |
paid | Thành công (success: true) – đủ hoặc thừa tiền và đủ xác nhận. Nạp thừa có overpaid: true |
expired | Hết hạn mà chưa nhận được gì |
Chỉ cộng tiền cho thành viên khi success là true.
Khi trạng thái thay đổi, hệ thống POST JSON giống kết quả ở mục 2 tới callback_url. Header X-Signature = HMAC-SHA256 (hex) của nguyên văn body với webhook secret. Trả về HTTP 2xx để xác nhận đã nhận; nếu không sẽ được gửi lại.