Virtual account and VietQR

Generate VietQR

POST/api/v1/partner/gen-viet-qr

AuthorizationVirtual account

Generates a VietQR for a virtual account. The image is returned as base64.

Headers

Fields	Description
`Content-Type`Required	application/json
`Authorization`Required	Authorization key Fintwin issues for the company code.

Body

Fields	Description
`REQ_DATA.TRT_INST_CD`Required	Organization code.
`REQ_DATA.TRSC_DT`Required	Request date.
`REQ_DATA.REQ_ID`Required	Unique request id.
`REQ_DATA.RCV_BNK_CD`Required	Beneficiary bank NAPAS code.
`REQ_DATA.ACCT_NO`Required	Virtual account number.
`REQ_DATA.RCV_ACCT_NM`Required	Beneficiary name.
`REQ_DATA.TRSC_AMT`Required	Amount encoded in the QR.
`REQ_DATA.REMARK`Required	Payment remark.
`REQ_DATA.OUT_TYPE`Optional	Output format.

Samples

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"}}'