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.
Bearer <token> bạn nhận được khi gọi API Get Token ở bước 5.
Body
Name
Type
Required
Description
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>
Khi gọi API Generate VietQR Code, tôi gặp phải mã lỗi trả về là "E34"??!
Khi gặp phải mã lỗi này, bạn hãy kiểm tra lại 2 trường sau:
content :
Độ dài không được vượt quá 19 ký tự.
Không chứa ký tự đặc biệt.
Ký tự thuộc dạng chữ cái Latin/Tiếng Việt không dấu.
orderId :
Độ dài không được vượt quá 19 ký tự.
Không chứa ký tự đặc biệt.
Ký tự thuộc dạng chữ cái Latin/Tiếng Việt không dấu.
API Generate VietQR Code dùng để làm gì?
API Generate VietQR Code được sử dụng để tạo mã QR thanh toán cho các giao dịch. Mã QR này có thể được khách hàng quét để thực hiện thanh toán trực tiếp từ tài khoản ngân hàng.
Tôi cần cung cấp những thông tin gì để tạo mã QR thanh toán?
Để tạo mã QR thanh toán, bạn cần cung cấp các thông tin như số tiền, mã đơn hàng, thông tin người nhận, và thông tin tài khoản ngân hàng của người nhận. Các thông tin này sẽ được mã hóa vào mã QR. Bạn có thể xem chi tiết các thông tin cần thiết cho từng loại mã QR ở trên.
Làm thế nào để biết mã QR đã được tạo thành công?
Khi mã QR được tạo thành công, API sẽ trả về hình ảnh mã QR dưới dạng string cùng với các thông tin chi tiết liên quan đến giao dịch. Nếu có lỗi xảy ra, bạn sẽ nhận được thông báo lỗi trong phần phản hồi.
Làm thế nào để xử lý lỗi khi gọi API Generate VietQR Code?
Nếu bạn gặp lỗi khi gọi API, trước tiên hãy kiểm tra lại các thông tin đầu vào như số tiền, thông tin tài khoản, và mã đơn hàng. Đảm bảo rằng các thông tin này chính xác và hợp lệ. Nếu vấn đề vẫn tiếp diễn, hãy liên hệ với bộ phận hỗ trợ kỹ thuật của VietQR để được giúp đỡ.
Mã QR có thể được quét bằng ứng dụng nào?
Mã QR được tạo bởi API VietQR có thể được quét bằng bất kỳ ứng dụng ngân hàng nào hỗ trợ chuẩn thanh toán QR tại Việt Nam, hoặc các ứng dụng thanh toán ví điện tử có tính năng quét mã QR.
Tôi có cần mã hóa thông tin trước khi gửi đến API không?
Không, API VietQR sẽ tự động mã hóa các thông tin cần thiết khi tạo mã QR. Bạn chỉ cần đảm bảo rằng các thông tin gửi đến API là chính xác và đầy đủ.