Kiểm Tra Thông Tin VA
Đường dẫn
- URL:
/api/v1/va/check-info - Method:
POST - Mô tả: API cho phép người dùng gửi yêu cầu kiểm tra thông tin của Virtual Account
Request
Bảng Request
| Tham số | Kiểu dữ liệu + Độ dài | Bắt buộc | Mô tả |
|---|---|---|---|
| request_id | string(50) | Có | Mã ID request duy nhất, định dạng đề xuất: MerchantCode+YYYYMMDDHHMMSS+UniqueId |
| request_time | string(19) | Có | Định dạng: YYYY-MM-DD HH:MM:SS |
| merchant_code | string(20) | Có | Merchant code được cung cấp bởi Baokim trước khi tích hợp |
| reference_code | string(100) | Có | Mã tham chiếu của VA được quản lý trong hệ thống của bạn |
Ví dụ Request
{
"request_id": "PARTNER12320231105123000ID01",
"request_time": "2023-11-05 12:30",
"merchant_code": "PARTNER123",
"reference_code": "ORDER12345"
}
Response
Bảng Response
| Tham số | Kiểu dữ liệu + Độ dài | Bắt buộc | Mô tả |
|---|---|---|---|
| response_code | int(4) | Có | Mã lỗi từ Baokim theo Bảng Mã Lỗi |
| response_message | string(100) | Có | Mô tả mã lỗi từ Baokim theo Bảng Mã Lỗi |
| merchant_code | string(20) | Có | Merchant code được cung cấp bởi Baokim trước khi tích hợp |
| reference_code | string(100) | Có | Mã tham chiếu của VA được quản lý trong hệ thống của bạn |
| status | int(1) | Có | 1: Hoạt động; 2: Không hoạt động |
| expire_date | string(19) | Có | Định dạng: YYYY-MM-DD HH:MM:SS |
| account_info | object | Có | Chi tiết Virtual Account |
| account_info.bank_name | string(100) | Có | Tên ngân hàng |
| account_info.bank_no | string(6) | Có | Mã ngân hàng |
| account_info.bank_branch | string(100) | Có | Chi nhánh ngân hàng |
| account_info.acc_no | string(22) | Có | Số tài khoản ngân hàng |
| account_info.acc_name | string(63) | Có | Tên chủ tài khoản |
| account_info.qr | string(100) | Có | Chuỗi QR được mã hóa base64 |
| account_info.qr_path | string(100) | Có | Đường dẫn hình ảnh QR |
Ví dụ Response
{
"response_code": 200,
"response_message": "Success",
"merchant_code": "BAOKIM",
"reference_code": "ORD12345678901234567890345",
"status": 1,
"expire_date": "2024-12-31 23:59",
"account_info": {
"bank_name": "Nguyen Van A",
"bank_no": "963336",
"bank_branch": "Main Branch",
"acc_no": "12345678901234567890",
"acc_name": "John Doe",
"qr": "SGVsbG8sIFdvcmxkIQ==",
"qr_path": "/path/to/qr/image.png"
}
}
Mã Lỗi
| Mã Response | Thông báo Response |
|---|---|
| 200 | Success |
| 99 | Pending |
| 11 | Failed |
| 101 | System Error |
| 110 | Merchant code invalid |
| 120 | Invalid signature |
| 422 | Validation Error |
| 1100 | Virtual Account not found |