Virtual account and VietQR

Create virtual account

POST/api/v1/va_8100

AuthorizationVirtual account

Registers virtual account information.

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 issued by Fintwin. Samples use TEST0001.
`REQ_DATA.TRSC_DT`Required	Transaction date, YYYYMMDD.
`REQ_DATA.TRSC_SEQ_NO`Required	Sequence unique within the day. Repeating it does not create a new transaction.
`REQ_DATA.BNK_CD`Required	Credit bank code.
`REQ_DATA.ACCT_NO`Required	Virtual account number.
`REQ_DATA.ACCT_NAME`Required	Display name.
`REQ_DATA.MOTHER_ACC_NO`Required	Settlement account. Use a test number.

Samples

curl -X POST 'https://sandbox.example.invalid/api/v1/va_8100' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <authorization-key>' \
  -d '{"REQ_DATA":{"TRT_INST_CD":"TEST0001","TRSC_DT":"20261014","TRSC_SEQ_NO":"0000200","BNK_CD":"970422","ACCT_NO":"VA0000000000TEST","ACCT_NAME":"NGUYEN VAN TEST","MOTHER_ACC_NO":"000000000000TEST"}}'