Chuyển tới nội dung chính
Phiên bản: 1.7.0

Create QR

POST 

/openapi/v1/transaction/qr/generate

Tạo mã QR thanh toán cho một đơn hàng.

Gọi Get Services trước để lấy service_code (dùng làm header x-service-code) và bincode.

Payload trước khi mã hóa:

{
"req_id": "req-12345",
"order_id": "TCTK010520260001",
"va": "VA100023312",
"bincode": "970454",
"amount": 10000
}
TrườngBắt buộcMô tả
req_id✅Mã yêu cầu
order_id✅Mã hóa đơn — tối đa 36 ký tự, cho phép ký tự -
va✅Số tài khoản ảo
bincode✅Mã ngân hàng
amount✕0 hoặc bỏ trống = QR tĩnh; > 0 = QR động
Dùng chung order_id với Push to Devices

Create QR cho phép order_id tối đa 36 ký tự (gồm ký tự -). Tuy nhiên nếu bạn dùng lại cùng order_id để đẩy xuống thiết bị POS thì độ dài tối đa chỉ 16 ký tự. Khi dùng chung order_id cho cả hai luồng, hãy giữ ≤ 16 ký tự.

Request​

Responses​

Tạo QR thành công