Yêu cầu
| Cách gửi | Trường | Mô tả |
|---|---|---|
| multipart/form-data | file | Tệp ảnh QR. Thêm ?lookup=true để tra cứu tên. |
| application/json | image | Ảnh dạng base64. Alias: base64, imageData. |
| application/json | imageUrl | URL ảnh công khai. Alias: url. |
| application/json | lookup | true để tra cứu tên chủ tài khoản (tính phí như tra cứu). |
curl -X POST 'https://api.bankgateway.org/api/v1/qr-image?lookup=true' \
-H 'X-API-Key: YOUR_API_KEY' \
-F '[email protected]'Phản hồi
| Trường | Mô tả |
|---|---|
| bankCode, bankBin, bankName | Ngân hàng thụ hưởng. |
| accountNumber | Số tài khoản trong mã QR. |
| accountName | Tên chủ tài khoản (chỉ khi lookup=true). |
| amount, currency | Số tiền và đơn vị (QR động). |
| content / memo | Nội dung chuyển khoản. |
| isDynamic | QR động hay tĩnh. |
| crcCheck | Kết quả kiểm tra CRC. |
| imageInfo | Thông tin ảnh đã xử lý. |
| HTTP | Mã lỗi | Ý nghĩa |
|---|---|---|
| 400 | MISSING_IMAGE_FILE | Không có ảnh trong yêu cầu. |
| 400 | INVALID_VIETQR | Ảnh không chứa mã VietQR hợp lệ. |
| 503 | ENDPOINT_MAINTENANCE | Endpoint đang bảo trì. |