# Tạo tài khoản ảo

`POST /service/@id/tinopay/bank-accounts/@bank/virtual-accounts` · TinoPay, token đăng nhập của chủ dịch vụ

Số VA = `first_va_number` của tài khoản ngân hàng + `va_number` (phần đuôi A–Z, 0–9, tối đa 7 ký tự; chữ thường tự đổi sang hoa). `account_name`: A–Z, 0–9 và khoảng trắng, tối đa 50 ký tự, không dấu. Trùng số: 409 `VA_NUMBER_EXISTS`; tài khoản ngân hàng chưa có mã đầu VA: 422 `VALIDATION_FAILED`.

## HTTP request

| Mục | Giá trị |
| --- | --- |
| URL | `https://api.tino.vn/service/@id/tinopay/bank-accounts/@bank/virtual-accounts` |
| Method | `POST` |
| Xác thực | token đăng nhập của chủ dịch vụ TinoPay (`Authorization: Bearer <token>`); gateway `/v1` chưa mở TinoPay |
| Content-Type | `application/json` |

## Tham số

| Tên | Vị trí | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- | --- |
| `id` | đường dẫn | int | có | ID dịch vụ TinoPay |
| `bank` | đường dẫn | string | có | ID tài khoản ngân hàng (`id` ở danh sách tài khoản ngân hàng) |
| `va_number` | body | string | có | Phần đuôi, A–Z 0–9, tối đa 7 ký tự |
| `account_name` | body | string | có | A–Z 0–9 và khoảng trắng, tối đa 50 ký tự, không dấu |

## Example request

```bash
curl -X POST "https://api.tino.vn/service/100001/tinopay/bank-accounts/9c1e6f2a-5b7d-4e1a-9f3c-2d8b6a4e0c11/virtual-accounts" \
  -H "Authorization: Bearer $TINO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "va_number": "QA01",
  "account_name": "CUA HANG A"
}'
```

`$TINO_TOKEN` là token đăng nhập của chủ dịch vụ TinoPay. Tham số đường dẫn trong ví dụ là giá trị mẫu.

SDK ([SDK & Ví dụ](/docs/sdk)): chưa có hàm riêng, dùng `client.request("POST", "/service/@id/tinopay/bank-accounts/@bank/virtual-accounts")`.

## Example response

```json
{
 "data": {
  "id": 51,
  "bank_account_id": "9c1e6f2a-5b7d-4e1a-9f3c-2d8b6a4e0c11",
  "account_number": "9624QA01",
  "account_name": "CUA HANG A",
  "status": "active",
  "created_at": "2026-10-20T10:05:00+07:00"
 }
}
```

Mẫu dựng theo tài liệu TinoPay API v1 (Tino chuyển tiếp nguyên dữ liệu TinoPay), giá trị là ví dụ.