Thanh toán QR

Hệ thống cung cấp giải pháp thanh toán QR động, giúp khách hàng quét mã và thanh toán nhanh chóng qua ứng dụng ngân hàng.

API Create QR

POST /openapi/v1/qr

API này được thiết kế để tự động hóa việc khởi tạo mã QR thanh toán cho các đơn hàng.

Request Body (Cấu trúc JSON trước khi mã hóa)

Field	Type	Required	Description
order_id	string	✅	Mã hóa đơn duy nhất của đối tác.
amount	number	✅	Số tiền thanh toán (> 0 cho QR động, 0 cho QR tĩnh).
va	string	✅	Số tài khoản ảo (Lấy từ dịch vụ VA Account).
bincode	string	✅	Mã ngân hàng (ví dụ: 970454 cho BvBank).

Response (Plain text JSON)

Field	Type	Description
qr_content	string	Chuỗi nội dung thô của mã QR.
image_png_base64	string	Chuỗi ký tự Base64 của hình ảnh mã QR.

cURL

curl --location '<base_url>/openapi/v1/qr' \
  --header 'Partner-Code: 1111111' \
  --header 'x-service-code: vccb-qr' \
  --header 'Authorization: Bearer eyJhbGciOiJSUzI1...' \
  --header 'Content-Type: application/json' \
  --data '{ "data": "d2049637b0fd51c91cf01bd..." }'

Response Example

{
  "image_png_base64": "iVBORw0KGgoAAAANSUhEUg...",
  "qr_content": "00020101021138550010A0000007270..."
}

Lưu ý

Đơn vị cần xây dựng một API đầu cuối (backend) để khởi tạo mã QR từ ATOM. Phương thức chấp nhận là POST với header Content-Type: application/json.