Tạo tài khoản ảo

API: POST /v1/bank/create-va

Tạo mới tài khoản ảo (Virtual Account) cho Merchant, cho phép nhận thông báo biến động số dư.

Cách sử dụng

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',
);

Tham số đầu vào

Trường	Kiểu	Bắt buộc	Mô tả
accountType	string	✓	Loại tài khoản: personal-account, business-account, business-household-account
bankBin	string	✓	Mã BIN ngân hàng. Dùng BankBinEnum
accountNumber	string	✓	Số tài khoản ngân hàng muốn liên kết
accountName	string	✓	Tên chủ tài khoản
identity	string	✓	CMND/CCCD hoặc Mã số thuế
mobile	string	✓	Số điện thoại đăng ký
merchantId	number	✕	ID Merchant (bắt buộc nếu qua Master Merchant)
isNotifyAccountNumber	boolean	✕	true để liên kết STK gốc, mặc định false (tạo STK ảo)

Response

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

Trường	Kiểu	Mô tả
data.confirmId	string	Mã xác thực cần dùng cho bước confirmVa