> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建虚拟账户

> 在已激活的法币支付通道下为商户创建额外的虚拟子账户，以实现按别名路由资金。

使用此端点在已激活的法币支付通道下开设额外的虚拟账户。每个虚拟账户都会获得独立的银行凭证（例如专属的 CLABE 或 CVU），以便您按别名路由和对账资金。创建虚拟账户之前，相应的法币账户必须已处于激活状态。支持的币种为 MXN、ARS、BRL 和 COP。

> [!NOTE]
>
> 所有请求都必须包含 `X-BH-TOKEN` 请求头和 `Content-Type: application/json`。`alias` 的值只能包含字母和数字。

## 端点

`POST https://api.velafi.com/v2/merchant/virtual/accounts`

## 请求参数

**merchantId** `number` *required*

要为其创建虚拟账户的商户 ID。

**fiat** `string` *required*

虚拟账户的法币币种。支持的值：`MXN`、`ARS`、`BRL`、`COP`。

**paymentId** `number` *required*

要使用的支付通道 ID。支持的对应关系：

* `72` 或 `105` — MXN
* `63` — ARS
* `68`（Automatic ACH）或 `69`（Bre-B）— COP
* `90` 或 `92` — BRL

**alias** `string` *required*

该虚拟账户的唯一别名，仅由字母和数字组成（最多 64 个字符）。对于 COP（`68`、`69`），别名必须为 6 到 21 位大写字母或数字。`default`（不区分大小写）为保留字，不可使用。如果同一商户已存在 `fiat`、`paymentId` 和 `alias` 均相同的待处理或已激活虚拟账户，请求将被拒绝。

## 响应字段

**code** `number`

HTTP 风格的响应码。`200` 表示成功。

**msg** `string`

可读的状态消息，例如 `SUCCESS`。

**data** `object`

**data 字段**

**fiat** `string`

新创建虚拟账户的法币币种。

**status** `number`

虚拟账户状态：`1` = 待处理，`2` = 已激活，`3` = 失败。创建成功时，ARS（`63`）虚拟账户会立即返回 `2`，其他通道在账户设置期间返回 `1`。

## 示例

```bash cURL theme={null}
curl -X POST https://api.velafi.com/v2/merchant/virtual/accounts \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantId": 151209,
    "fiat": "MXN",
    "paymentId": 105,
    "alias": "store001"
  }'
```

```json Response theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "fiat": "MXN",
    "status": 1
  }
}
```

> [!TIP]
>
> 使用不同的别名，将虚拟账户映射到您平台内的各个用户、门店或成本中心。别名一经设定不可更改——如需使用不同的标识符，请创建新的虚拟账户。


## Related topics

- [获取虚拟账户列表](https://docs.velafi.com/cn/api-reference/merchant/get-multiple-virtual-account.md)
- [更新日志](https://docs.velafi.com/cn/docs/changelog.md)
- [错误码](https://docs.velafi.com/cn/docs/error-codes.md)
- [商户](https://docs.velafi.com/cn/docs/merchants.md)
- [支付方式](https://docs.velafi.com/cn/docs/payment-methods.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.