Virtual account and VietQR

Update virtual account

POST/api/v1/va_8200

AuthorizationVirtual account

Updates limits, time window, and amount flags of a virtual account.

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	Bank code.
`REQ_DATA.ACCT_NO`Required	Virtual account number.
`REQ_DATA.ACCT_NAME`Optional	New name.
`REQ_DATA.START_CHK`Optional	Start-check flag.
`REQ_DATA.START_DATE`Optional	Validity start date.
`REQ_DATA.START_TIME`Optional	Start time, HHMMSS.
`REQ_DATA.END_CHK`Optional	End-check flag.
`REQ_DATA.END_DATE`Optional	End date.
`REQ_DATA.END_TIME`Optional	End time.
`REQ_DATA.CHK_AMT`Optional	Amount-check flag.
`REQ_DATA.EST_AMT`Optional	Expected amount.
`REQ_DATA.CHK_REUSE`Optional	Reuse flag.
`REQ_DATA.M_ACCT_NO`Optional	Settlement account.

Samples

curl -X POST 'https://sandbox.example.invalid/api/v1/va_8200' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <authorization-key>' \
  -d '{"REQ_DATA":{"TRT_INST_CD":"TEST0001","TRSC_DT":"20261014","TRSC_SEQ_NO":"0000201","BNK_CD":"970422","ACCT_NO":"VA0000000000TEST","EST_AMT":"10000"}}'