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

KYC 和 KYB 验证

VelaFi 在受监管的生态系统中运营,因此每个商户在交易前都必须完成身份验证。个人需完成**了解您的客户(KYC)验证;企业需完成了解您的企业(KYB)**验证。提交商户创建请求后,API 会返回一个唯一的重定向 URL,用于打开 VelaFi 的安全验证页面。 您可以通过两种方式向用户展示该验证页面:

重定向模式

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

嵌入模式

使用 <iframe> 将验证页面嵌入您自己的应用中。这样用户无需离开您的产品,可获得无缝的白标体验。
验证 URL 有时效限制。收到 API 响应后请尽快使用——根据会话和配置设置,它可能会过期或失效。
验证成功后,VelaFi 会为商户分配一个永久 MID。在后续所有 API 请求中使用此 MID。

商户状态参考

提交商户创建请求后,商户会依次经历以下状态。轮询获取商户列表端点以查看当前状态。

商户管理模式

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

多商户管理

您的主商户账户完成 KYB 验证后,即可在您的账户下创建和管理子商户——个人或实体均可。这支持分层商户管理以及灵活的基于角色的访问控制。 常见使用场景包括:
  • 聚合商为多个终端客户管理合规事务
  • 支付基础设施平台为下游子商户提供服务
  • 市场平台运营商针对每个卖家独立处理商户级合规事务

依赖模式(Reliance Mode)

如果您持有金融机构牌照,可以申请启用依赖模式。这使您能够完全自主地管理商户入驻流程,而 VelaFi 提供底层基础设施。
在依赖模式下,您负责商户入驻、持续审查和合规监控。VelaFi 不会干预您的工作流程——它提供技术基础设施、结算通道和监管支持,以确保交易安全合规。
依赖模式需要 VelaFi 合规团队进行额外的合规审查后才能在您的账户上启用。请联系您的 VelaFi 代表以开始申请流程。

激活法币支付渠道

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

选择激活端点

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

提交激活请求

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

获取虚拟账户信息

当获取商户账户列表显示状态为 2 时,使用获取待处理资金账户获取该渠道的充值信息。例如,ARS 渠道会返回与阿根廷银行网络关联的 CVU 号码和 CUIT。
4

通过电汇充值

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

各国虚拟账户信息

每个已激活的法币渠道都提供专属虚拟账户,使入账付款能够自动匹配到正确的商户。
每个法币渠道均支持个人和企业账户类型,让您能够灵活应对各种支付场景。