FintwinDeveloper Portal
Ctrl K
Đăng nhập

Tài khoản định danh và VietQR

Tạo VietQR

POST/api/v1/partner/gen-viet-qr
AuthorizationTài khoản định danh

Tạo VietQR cho một tài khoản định danh. Ảnh trả về dạng base64.

Header

TrườngMô tả
Content-TypeBắt buộcapplication/json
AuthorizationBắt buộcAuthorization key Fintwin cấp cho company code.

Body

TrườngMô tả
REQ_DATA.TRT_INST_CDBắt buộcMã tổ chức.
REQ_DATA.TRSC_DTBắt buộcNgày yêu cầu.
REQ_DATA.REQ_IDBắt buộcMã yêu cầu duy nhất.
REQ_DATA.RCV_BNK_CDBắt buộcMã NAPAS ngân hàng nhận.
REQ_DATA.ACCT_NOBắt buộcSố tài khoản định danh.
REQ_DATA.RCV_ACCT_NMBắt buộcTên người nhận.
REQ_DATA.TRSC_AMTBắt buộcSố tiền trên QR.
REQ_DATA.REMARKBắt buộcNội dung nộp tiền.
REQ_DATA.OUT_TYPETùy chọnĐịnh dạng đầu ra.

Mã mẫu

curl -X POST 'https://sandbox.example.invalid/api/v1/partner/gen-viet-qr' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <authorization-key>' \
  -d '{"REQ_DATA":{"TRT_INST_CD":"TEST0001","TRSC_DT":"20261014","REQ_ID":"QR-TEST-001","RCV_BNK_CD":"970422","ACCT_NO":"VA0000000000TEST","RCV_ACCT_NM":"NGUYEN VAN TEST","TRSC_AMT":"10000","REMARK":"TEST PORTAL"}}'