> ## 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.

# 激活企业商户账户

> 为企业商户开通 MXN、ARS、COP、BRL、PEN、USD 和 EUR 等币种及支付服务商的法币支付通道。

使用此端点为企业（BUSINESS 类型）商户开通一个或多个法币支付通道。该流程与个人开通流程类似，但企业账户通常需要较少的个人字段，并且根据支付服务商的不同，可能需要提供公司注册数据和 UBO（最终受益所有人）信息。

> [!NOTE]
>
> 所有请求都必须包含 `X-BH-TOKEN` 请求头和 `Content-Type: application/json`。

## 端点

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

## 核心请求字段

**merchantId** `string` *required*

要开通的企业商户 ID。

**fiat** `string` *required*

目标法币。支持的值：`MXN`、`ARS`、`COP`、`BRL`、`PEN`、`EUR`、`USD`。

**trench** `string` *required*

支付服务商或账户类型标识符。必须是所选 `fiat` 支持的值。

**callbackUri** `string`

商户接受合规协议后的重定向 URL。用于 Lead Bank 通道；如果省略，将使用 VelaFi 默认的重定向 URL。

**fieldList** `object`

通道特定字段。内容因 `fiat` 和 `trench` 而异。请参阅下方各币种示例。

## 响应字段

**code** `number`

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

**msg** `string`

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

**data** `object`

**data 字段**

**fiat** `string`

已开通的法币。

**status** `number`

通道状态：`0` = 已初始化（当同时返回 `verifyLink` 时，需要进行额外的企业验证；见下文），`1` = 处理中（通道正在开通或审核中），`2` = 已激活，`3` = 失败（参见 `failReason`），`4` = 未完成（需要执行进一步步骤，例如在 `verifyLink` 中完成）。请轮询[查询商户账户列表](https://docs.velafi.com/cn/api-reference/merchant/get-a-list-of-merchant-accounts.md)，直到 `status` 为 `2`。

**verifyLink** `string`

企业需要打开以继续操作的 URL。当需要额外的企业验证时，会随 `status: 0` 一起返回；对于 USD/EUR Lead Bank 通道，企业需通过该链接完成所需的合规协议。

**failReason** `string`

开通失败的原因说明（如适用）。

## 企业激活的工作方式

企业激活会走以下两种路径之一。响应会告诉您实际走的是哪一种。

**额外的企业验证（`status: 0` 并返回 `verifyLink`）。** 对于企业商户，MXN（`CLABE - FINCO PAY`、`CLABE - TESORED`）、COP（`COP Account`）、ARS（`CVU - Momentum`、`QR Argentina`）、BRL（`BANCO GENIAL`）和 PEN（`PEN Account`）的本地通道通常需要针对该通道完成一次额外的 KYB 验证。响应会返回 `status: 0` 和 `verifyLink`。请引导企业访问该链接完成验证。VelaFi 审核通过后，通道会自动开通，您无需再次调用此端点。在这条路径上，请求中的 `fieldList` 不会被使用。

**直接激活。** 如果 VelaFi 为您的账户开启了直接激活，通道将根据您的请求直接开通，`fieldList` 必须包含该通道的必填字段。缺少字段或字段无效会导致请求被拒绝。

| Trench | 必填 `fieldList` 字段 |
| - | - |
| `CLABE - FINCO PAY` | `alias`（最多 40 个字符） |
| `CLABE - TESORED` | `alias`（最多 64 个字符） |
| `COP Account` | `alias`（最多 64 个字符） |
| `CVU - Momentum` | `cuit`、`name`；`alias` 为可选 |
| `QR Argentina` | `cuit`（最多 40 个字符） |
| `PEN Account` | `customerIdentificationType`、`customerIdentification`、`customerName`、`customerEmail`、`customerPhone`（仅限数字，最多 9 位） |
| `BANCO GENIAL` | 无 |

## 各币种示例

> [tab] MXN
>
> **MXN — 通过 Finco Pay 的 SPEI**（`trench: "CLABE - FINCO PAY"`）
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "MXN",
>   "trench": "CLABE - FINCO PAY"
> }
> ```
>
> **MXN — 通过 Tesored 的 SPEI**（`trench: "CLABE - TESORED"`）
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "MXN",
>   "trench": "CLABE - TESORED"
> }
> ```

> [tab] ARS
>
> **ARS — 通过 Momentum 的 CVU**（`trench: "CVU - Momentum"`）
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "ARS",
>   "trench": "CVU - Momentum"
> }
> ```
>
> **ARS — QR 3.0 转账**（`trench: "QR Argentina"`）
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "ARS",
>   "trench": "QR Argentina",
>   "fieldList": { "cuit": "123456789" }
> }
> ```

> [tab] COP / BRL / PEN
>
> **COP — PSE / ACH / Bre-B**（`trench: "COP Account"`）
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "COP",
>   "trench": "COP Account"
> }
> ```
>
> **BRL — 通过 Genial 的 Pix**（`trench: "BANCO GENIAL"`）
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "BRL",
>   "trench": "BANCO GENIAL"
> }
> ```
>
> **PEN — 银行转账**（`trench: "PEN Account"`）
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "PEN",
>   "trench": "PEN Account"
> }
> ```

> [tab] BRL Woovi（企业）
>
> **BRL — 通过 Woovi 的 Pix** — 需要提供完整的公司信息和 UBO 信息。
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "BRL",
>   "trench": "Pix - Woovi",
>   "fieldList": {
>     "companyInfo": {
>       "companyName": "EXEMPLO TECNOLOGIA LTDA.",
>       "companyDescription": "Fintech platform",
>       "countryStateOfIncorporation": "BR-SP",
>       "website": "example.com.br",
>       "socialMedia": "@example",
>       "street1": "Avenida Paulista, 1000",
>       "city": "São Paulo",
>       "countryStateCode": "BR-SP",
>       "postcode": "01310-100",
>       "reasonForAccountOpening": "ecommerce_retail_payments",
>       "sourceOfFunds": "sales_of_goods_and_services",
>       "numberOfEmployees": "11-50",
>       "estimatedAnnualRevenueUsd": "1m_to_10m",
>       "estimatedMonthlyVolumeUsd": 10000,
>       "companyRegistrationNumber": "00000000000001",
>       "taxIdentificationNumberTin": "00000000000002",
>       "taxIdentificationDocumentUrl": "100001/00000000-0000-0000-0000-000000000002.pdf",
>       "certificateOfIncorporationDocumentUrl": "100001/00000000-0000-0000-0000-000000000003.pdf"
>     },
>     "companyUbosInfo": [
>       {
>         "personType": "CEO",
>         "firstName": "Maria",
>         "lastName": "Silva",
>         "email": "maria@example.com",
>         "phone": "+5511999990000",
>         "percentageOfOwnership": 0.51,
>         "nationality": "BR",
>         "taxIdentificationNumber": "000000000000000000",
>         "dateOfBirth": "1985-03-20",
>         "street1": "Rua Augusta, 500",
>         "city": "São Paulo",
>         "countryStateCode": "BR-SP",
>         "postcode": "01305-000",
>         "idType": "1",
>         "govIdCountryAbbr": "BR",
>         "govIdFrontUrl": "100001/00000000-0000-0000-0000-000000000001.jpg"
>       }
>     ]
>   }
> }
> ```

> [tab] USD/EUR
>
> **USD/EUR — Lead Bank**（`trench: "Lead Bank"`）
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "EUR",
>   "trench": "Lead Bank",
>   "callbackUri": "https://your-app.com/agreement-callback",
>   "fieldList": {
>     "email": "admin@company.com",
>     "companyName": "Example Company Inc"
>   }
> }
> ```
>
> **多币种 — Circle Payment Network**（`trench: "Circle Payment Network"`）
>
> 支持：USD、HKD、EUR、SGD、NGN。仅支持付款。
>
> ```json Request body theme={null}
> {
>   "merchantId": "100001",
>   "fiat": "USD",
>   "trench": "Circle Payment Network"
> }
> ```

## 响应示例

```json Additional business verification (status 0) theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "fiat": "MXN",
    "status": 0,
    "verifyLink": "https://verify-sandbox.aiprise.com/?business_onboarding_session_id=xxx",
    "failReason": ""
  }
}
```

```json USD / EUR (agreement required) theme={null}
{
  "code": 200,
  "msg": "SUCCESS",
  "data": {
    "fiat": "USD",
    "status": 4,
    "verifyLink": "https://www.velafi.com/business/channel/verify?token=12ceff08",
    "failReason": ""
  }
}
```

> [!WARNING]
>
> 企业 BRL Woovi 开通需要完整的 `companyInfo`，以及 `companyUbosInfo` 中 1 到 50 个条目。文档字段（`certificateOfIncorporationDocumentUrl`、`taxIdentificationDocumentUrl` 以及每个 UBO 的 `govIdFrontUrl`）必须是[上传文件](https://docs.velafi.com/cn/api-reference/basic-configuration/upload-file.md)返回的 `fileUrl` 值。公开 URL 将被拒绝。缺失或无效的字段会导致开通立即失败。


## Related topics

- [激活商户账户](https://docs.velafi.com/cn/docs/guides/activating-merchant-account.md)
- [更新日志](https://docs.velafi.com/cn/docs/changelog.md)
- [激活个人商户账户](https://docs.velafi.com/cn/api-reference/merchant/activate-merchant-account-for-individual.md)
- [商户](https://docs.velafi.com/cn/docs/merchants.md)
- [获取商户账户列表](https://docs.velafi.com/cn/api-reference/merchant/get-a-list-of-merchant-accounts.md)


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