Là giải pháp hỗ trợ cho các đơn vị kinh doanh, đối tác thanh toán qua các thiết bị có thể hiển thị mã QR hoá đơn (máy POS/ web/ app/ in hoá đơn…)
Khi khởi tạo hóa đơn, đối tác gửi thông tin đến hệ thống VinID Pay để tạo mã. Khách hàng sử dụng tính năng “Quét mã” trên ứng dụng VinID để quét mã do nhân viên cửa hàng cung cấp và tiến hành thanh toán mà không cần nhập thêm bất cứ thông tin nào.
Để sử dụng Transaction QR, đối tác có thể lựa chọn 1 trong 2 phương án như sau:
Chủ động tích hợp với hệ thống thanh toán VinID Pay.
Sử dụng máy POS của các đối tác đã tích hợp thanh toán với VinID Pay như KiotViet, mPOS, iPOS.
Luồng người dùng sử dụng dịch vụ
Luồng người dùng sử dụng dịch vụ Transaction QR trên ứng dụng VinID
Trải nghiệm tính năng thanh toán
Trải nghiệm tính năng thanh toán Transaction QR bằng ví điện tử VinID tạiđây
Sequence diagram
APIs
Generate Transaction QR
POST{API-HOST}/merchant-integration/v1/orders/tqr
New API return generated QR for payment.
For old endpoint, please read note below
Request Body
Name
Type
Description
expired_in
integer
Order timeout in minute. Can be set from 3 to 15.
Default value is 15 if not defined
callback_url
string
Callback URL to merchant's backend
description
string
Description for order
extra_data
string
Extra information for order.
order_amount
integer
Amount of order. Value must be large than 0
order_currency
string
Currency code. Default value is VND
order_reference_id
string
Order id from merchant system.
For partial refund with transaction paid by VinID Point, this is required parameter, maximum 35 characters length and need to be unique.
Although we will keep it work, but we recommend merchants should move to the new one ASAP.
Please note that the order_reference_id is no more optional in the new endpoint. You should input a unique value every request to make sure the refund process can work correctly.