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

# 商户

> 创建并验证个人或企业商户，选择管理模式，并激活覆盖七种币种和国家的法币支付渠道。

VelaFi 中的商户是指已通过合规审查并获得唯一\*\*商户 ID（MID）\*\*的经验证实体——个人或企业。所有与交易、账户管理和结算相关的 API 调用都需要 MID，因此创建商户是处理任何支付之前的基础步骤。

## KYC 和 KYB 验证

VelaFi 在受监管的生态系统中运营，因此每个商户在交易前都必须完成身份验证。个人需完成\*\*了解您的客户（KYC）**验证；企业需完成**了解您的企业（KYB）\*\*验证。提交商户创建请求后，API 会返回一个唯一的重定向 URL，用于打开 VelaFi 的安全验证页面。

您可以通过两种方式向用户展示该验证页面：

> [card] 重定向模式
>
> 将用户直接引导至 API 返回的重定向 URL。这是最快的集成方式，无需您在前端做任何改动。

> [card] 嵌入模式
>
> 使用 `<iframe>` 将验证页面嵌入您自己的应用中。这样用户无需离开您的产品，可获得无缝的白标体验。

> [!WARNING]
>
> 验证 URL 有时效限制。收到 API 响应后请尽快使用——根据会话和配置设置，它可能会过期或失效。

验证成功后，VelaFi 会为商户分配一个永久 MID。在后续所有 API 请求中使用此 MID。

## 商户状态参考

提交商户创建请求后，商户会依次经历以下状态。轮询[获取商户列表](https://docs.velafi.com/cn/api-reference/merchant/get-a-list-of-merchants.md)端点以查看当前状态。

| 状态码 | 状态 | 描述 |
| - | - | - |
| 1 | 认证中 | KYC/KYB 验证正在进行中。 |
| 2 | 正常 | 验证已通过。商户已激活，可以进行交易。 |
| 3 | 认证失败 | 验证被拒绝。获取拒绝原因后重新提交。 |
| 4 | 未完成 | 验证已开始但尚未完成。使用原始 KYC 链接或创建新链接。 |

## 商户管理模式

VelaFi 提供两种运营模式。请选择适合您平台架构和合规状况的模式。

### 多商户管理

您的主商户账户完成 KYB 验证后，即可在您的账户下创建和管理子商户——个人或实体均可。这支持分层商户管理以及灵活的基于角色的访问控制。

常见使用场景包括：

* **聚合商**为多个终端客户管理合规事务
* **支付基础设施平台**为下游子商户提供服务
* **市场平台运营商**针对每个卖家独立处理商户级合规事务

### 依赖模式（Reliance Mode）

如果您持有金融机构牌照，可以申请启用依赖模式。这使您能够完全自主地管理商户入驻流程，而 VelaFi 提供底层基础设施。

> [!NOTE]
>
> 在依赖模式下，您负责商户入驻、持续审查和合规监控。VelaFi 不会干预您的工作流程——它提供技术基础设施、结算通道和监管支持，以确保交易安全合规。

> [!NOTE]
>
> 依赖模式需要 VelaFi 合规团队进行额外的合规审查后才能在您的账户上启用。请联系您的 VelaFi 代表以开始申请流程。

## 激活法币支付渠道

商户创建并验证后，激活您需要的法币渠道。支持的币种为 **MXN、ARS、BRL、COP、PEN、USD 和 EUR**。激活后即可通过各国的本地银行通道收付资金。

**1. 选择激活端点**

根据商户类型（个人或企业）和目标法币选择相应的端点。

| 端点 | 使用场景 |
| - | - |
| [激活商户账户（个人）](https://docs.velafi.com/cn/api-reference/merchant/activate-merchant-account-for-individual.md) | 适用于已通过 KYC 验证商户的个人账户 |
| [激活商户账户（企业）](https://docs.velafi.com/cn/api-reference/merchant/activate-merchant-account-for-business.md) | 适用于已通过 KYB 验证商户的企业账户 |

**2. 提交激活请求**

发送包含商户 MID、法币和 `trench`（支付渠道）的请求。响应会返回渠道 `status`：本地通道渠道返回 `1`（处理中）或 `2`（已激活），USD/EUR Lead Bank 返回 `4` 以及供商户完成后续步骤的 `verifyLink`。企业商户也可能收到 `0` 以及用于额外企业验证的 `verifyLink`。`3` 表示激活失败；请查看 `failReason`。

**3. 获取虚拟账户信息**

当[获取商户账户列表](https://docs.velafi.com/cn/api-reference/merchant/get-a-list-of-merchant-accounts.md)显示状态为 `2` 时，使用[获取待处理资金账户](https://docs.velafi.com/cn/api-reference/merchant/get-pending-fund-account.md)获取该渠道的充值信息。例如，ARS 渠道会返回与阿根廷银行网络关联的 **CVU 号码**和 **CUIT**。

**4. 通过电汇充值**

商户可以通过标准电汇将资金存入其虚拟账户。VelaFi 会自动对账入账交易，并将资金计入商户账户余额。

### 各国虚拟账户信息

每个已激活的法币渠道都提供专属虚拟账户，使入账付款能够自动匹配到正确的商户。

| 国家 | 币种 | 虚拟账户类型 |
| - | - | - |
| 🇦🇷 阿根廷 | ARS | CVU 号码 + CUIT |
| 🇧🇷 巴西 | BRL | Pix 密钥 / 银行账户 |
| 🇨🇴 哥伦比亚 | COP | 本地银行账户 |
| 🇲🇽 墨西哥 | MXN | CLABE |
| 🇵🇪 秘鲁 | PEN | 银行账户 |
| 🇺🇸 美国 | USD / EUR | USD：ACH / FedWire 路由信息；EUR：SEPA |

> [!TIP]
>
> 每个法币渠道均支持个人和企业账户类型，让您能够灵活应对各种支付场景。


## Related topics

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


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