Danh sách tài khoản ảo

API: POST /v1/bank/get-va-paging

Truy vấn danh sách tài khoản ảo (VA) đã tạo, hỗ trợ phân trang và lọc theo nhiều tiêu chí.

Cách sử dụng

Node.js

const result = await client.bank.getVaPaging({
  skipCount: 0,
  maxResultCount: 10,
});

Java

var req = new OpenApiGetVaPagingDto();
req.setSkipCount(0);
req.setMaxResultCount(10);

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

C#

var result = await client.Bank.GetVaPagingAsync(new OpenApiGetVaPagingDto
{
    SkipCount = 0,
    MaxResultCount = 10,
});

PHP

$result = $client->bank->getVaPaging(skipCount: 0, maxResultCount: 10);

Tham số đầu vào

Trường	Kiểu	Bắt buộc	Mô tả
skipCount	number	✓	Số bản ghi bỏ qua (VD: 0 cho trang đầu)
maxResultCount	number	✓	Số bản ghi tối đa mỗi trang (VD: 10)
filter	string	✕	Từ khóa tìm kiếm (theo tên hoặc số tài khoản)
merchantId	number	✕	ID Merchant (bắt buộc nếu qua Master Merchant)
bankBin	string	✕	Lọc theo mã BIN ngân hàng
accountType	string	✕	Lọc theo loại: personal-account, business-account, business-household-account

Response

{
  "code": "00",
  "message": "Success",
  "data": {
    "totalCount": 1,
    "items": [
      {
        "bankBin": "970418",
        "accountName": "LE DUY NGHIEM",
        "accountNumber": "0123456789111",
        "vaAccountNumber": "VQRQAHFVA0551",
        "status": "active",
        "accountType": "personal-account",
        "creationTime": "2025-09-04T08:12:32.160Z"
      }
    ]
  }
}

Trường	Kiểu	Mô tả
data.totalCount	number	Tổng số bản ghi
data.items	array	Danh sách VA
data.items[].vaAccountNumber	string	Số tài khoản ảo
data.items[].status	string	Trạng thái VA