Create virtual account

API: POST /v1/bank/create-va

Creates a new virtual account (VA) for a Merchant so it can receive balance notifications.

Usage

Node.js

const result = await client.bank.createVa({
  accountType: 'personal-account',
  bankBin: '970418',
  accountNumber: '0935926988',
  accountName: 'NGUYEN THI HUYEN',
  identity: '040191014068',
  mobile: '0123456789',
});

Java

var req = new OpenApiCreateVaDto();
req.setAccountType("personal-account");
req.setBankBin("970418");
req.setAccountNumber("0935926988");
req.setAccountName("NGUYEN THI HUYEN");
req.setIdentity("040191014068");
req.setMobile("0123456789");

var result = client.bank.createVa(req);

C#

var result = await client.Bank.CreateVaAsync(new OpenApiCreateVaDto
{
    AccountType = "personal-account",
    BankBin = "970418",
    AccountNumber = "0935926988",
    AccountName = "NGUYEN THI HUYEN",
    Identity = "040191014068",
    Mobile = "0123456789",
});

PHP

$result = $client->bank->createVa(
    accountType: 'personal-account',
    bankBin: '970418',
    accountNumber: '0935926988',
    accountName: 'NGUYEN THI HUYEN',
    identity: '040191014068',
    mobile: '0123456789',
);

Parameters

Field	Type	Required	Description
accountType	string	✓	Account type: personal-account, business-account, business-household-account
bankBin	string	✓	Bank BIN. Use BankBinEnum
accountNumber	string	✓	Bank account number to link
accountName	string	✓	Account holder name
identity	string	✓	ID card / citizen ID number or tax code
mobile	string	✓	Registered phone number
merchantId	number	✕	Merchant ID (required when calling via Master Merchant)
isNotifyAccountNumber	boolean	✕	true to link the source account number; defaults to false (creates a virtual account number)

Response

{
  "code": "00",
  "message": "Success",
  "data": {
    "confirmId": "886b05e9-2d94-4b41-9839-138c941fd1d9"
  }
}

Field	Type	Description
data.confirmId	string	Confirmation ID to use in the confirmVa step