Yêu cầu
| Header | Bắt buộc | Mô tả & Chuẩn |
|---|---|---|
| X-API-Key | Bắt buộc | Khóa bí mật API cấp riêng cho tài khoản. Chỉ truyền từ server-to-server. |
| Content-Type | Bắt buộc | application/json; charset=utf-8 |
| Idempotency-Key | Khuyến nghị cao | UUID v4 duy nhất cho mỗi giao dịch (RFC 8470). Chống trừ tiền trùng lặp khi mạng lag. |
| Trường | Bắt buộc | Mô tả |
|---|---|---|
| bankCode | Bắt buộc | Mã ngân hàng (ví dụ MB, VCB). Alias: bank. |
| accountNumber | Bắt buộc | Số tài khoản. Alias: account. |
| expectedName | Bắt buộc | Tên cần so khớp. Alias: ownerName, name, accountName. |
| threshold | Tuỳ chọn | Ngưỡng khớp 0–1. Mặc định 0.85. |
curl -X POST 'https://api.bankgateway.org/api/v1/owner-check' \
-H 'Content-Type: application/json' \
-H 'X-API-Key: YOUR_API_KEY' \
-d '{ "bankCode": "MB", "accountNumber": "0783825888", "expectedName": "Nguyen Van A" }'Phản hồi
Trả về toàn bộ dữ liệu của API Tra cứu số tài khoản, kèm các trường so khớp bên dưới. Phí tính như một lượt tra cứu.
| Trường | Kiểu | Mô tả |
|---|---|---|
| expectedName | string | Tên bạn gửi lên. |
| isMatch | boolean | true nếu độ tin cậy ≥ threshold. |
| confidence | number | Độ tương đồng 0–1. |
| verification | object | Chi tiết thuật toán so khớp. |
| HTTP | Mã lỗi | Ý nghĩa |
|---|---|---|
| 400 | MISSING_BANK_CODE | Thiếu mã ngân hàng. |
| 400 | MISSING_ACCOUNT_NUMBER | Thiếu số tài khoản. |
| 400 | MISSING_EXPECTED_NAME | Thiếu tên cần so khớp. |
| 503 | ENDPOINT_MAINTENANCE | Endpoint đang bảo trì. |