Gọi API Generate VietQR Code
Dịch vụ cho phép đối tác tạo mã QR Code thanh toán để người dùng quét và thực hiện thanh toán trực tiếp. Tùy thuộc vào loại mã thanh toán VietQR, một số tham số khác nhau sẽ cần được truyền đi.
POST
POST
Headers
Content-Type
application/json
Authorization
Bearer <token> bạn nhận được khi gọi API Get Token ở bước 5.
Body
bankCode
String
Yes
Mã ngân hàng của tài khoản.
bankAccount
String
Yes
Tài khoản ngân hàng tạo mã thanh toán VietQR.
userBankName
String
Yes
Họ tên chủ tài khoản. Không dấu tiếng Việt.
content
String
Yes
Nội dung chuyển tiền. Tối đa 19 ký tự, tiếng Việt không dấu, không ký tự đặc biệt.
qrType
Integer
Yes
Tùy loại mã thanh toán cần tạo, nhập giá trị tương ứng: - VietQR động: 0 - VietQR tĩnh: 1
- VietQR bán động: 3
amount
Long
Optional
Số tiền cần thanh toán.
<Bắt buộc nếu "qrType
" = 0 hoặc 3>
orderId
String
Optional
Mã ID giao dịch bên đối tác cần quản lý. “orderId” sẽ được trả về khi hệ thống nhận biến động số dư (có thông tin giao dịch trùng với giao dịch được tạo bằng mã QR).
<Bắt buộc nếu "qrType
" = 0>
transType
String
Optional
Phân loại giao dịch là ghi nợ/ghi có (giá trị: D/C).
Mặc định là “C”.
<Bắt buộc nếu "qrType
" = 0>
terminalCode
String
Optional
Mã cửa hàng/điểm bán.
<Bắt buộc nếu "qrType
" = 1 hoặc 3>
serviceCode
String
Optional
Mã sản phẩm, dịch vụ được thanh toán.
<Bắt buộc nếu "qrType
" = 3>
subTerminalCode
String
Optional
Mã cửa hàng/điểm bán phụ.
sign
String
Optional
Chữ ký.
urlLink
String
Optional
Trang chuyển đến sau khi quét mã thanh toán. Khi thanh toán thành công sẽ trả về tự động.
note
String
Optional
Ghi chú cho giao dịch.
additionalData
Object
Optional
Các tham số truyền thêm.
Response
Code tham khảo
Các câu hỏi thường gặp
Last updated