> ## 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 帮助企业开发者构建法币到加密货币的入金、加密货币到法币的出金，以及基于稳定币通道的全球法币支付流程。

VelaFi 是一个金融 API 平台，让您能够以编程方式大规模管理资产兑换和跨币种转账。无论您是需要接收本地法币并以稳定币结算、将加密货币余额支付到银行账户，还是在不依赖传统代理行网络的情况下跨境转移资金，VelaFi 都通过统一的 RESTful 接口提供各项工作流。API 接收和返回 JSON，通过 HTTPS 进行认证，并使用标准 HTTP 状态码——因此可以顺畅地集成到任何现有后端技术栈中。

## 核心工作流

VelaFi 将其能力组织为三种不同的支付流程。每个流程都基于相同的账户和商户基础设施，因此完成接入后，您可以启用其中任意组合。

> [card] [法币 → 加密货币入金](https://docs.velafi.com/cn/docs/guides/on-ramp.md)
>
> 接收客户的本地法币，并立即将等值的稳定币或加密货币记入其托管钱包。

> [card] [加密货币 → 法币出金](https://docs.velafi.com/cn/docs/guides/off-ramp.md)
>
> 兑换加密货币或稳定币余额，并以当地货币将法币资金直接打入收款人的银行账户。

> [card] [法币 → 法币全球支付](https://docs.velafi.com/cn/docs/guides/global-payments.md)
>
> 以稳定币作为结算通道进行跨境汇款，付款方和收款方各自使用本地货币进行交易。

### 入金 (On-Ramp)：法币 → 加密货币

入金流程让您的商户能够收取本地法币存款——例如阿根廷比索 (ARS) 或墨西哥比索 (MXN)——并自动获得相应的加密货币余额。激活商户法币账户后，您创建订单，VelaFi 会核对入账的银行转账并将加密货币记入商户的托管钱包。

### 出金 (Off-Ramp)：加密货币 → 法币

出金流程则正好相反。您的商户持有加密货币或稳定币余额，并希望以法币向收款方付款。您创建加密货币到法币的订单，VelaFi 验证加密货币、完成兑换，并将法币结算款项打入您指定的收款人账户。

### 全球支付：法币 → 法币

全球支付流程仅将稳定币作为内部结算通道。付款方以一种法币付款，收款方以另一种法币收款，双方都不涉及加密货币敞口。这使其适用于跨区域的薪资发放、供应商付款和平台分账。

***

## 接入概览

在调用 API 之前，请完成以下一次性设置流程。每一步完成后才能进行下一步。

**1. 创建 VelaFi 账户**

在 [velafi.com/signup](https://www.velafi.com/signup) 注册。注册成功后，VelaFi 会为您分配一个唯一的**用户 ID (UID)**，用于关联您的所有商户、API 密钥和交易历史。

**2. 创建商户并完成 KYC/KYB**

在您的账户下创建一个法律实体（个人或企业）并提交所需的合规文件。审核通过后，VelaFi 会分配一个**商户 ID (MID)**，并自动为该商户开通加密货币托管钱包。

**3. 生成 API 密钥**

登录 VelaFi 控制台，进入 **API Management**，然后点击 **Create API Key**。如果尚未启用双重身份验证 (2FA)，系统会提示您启用。复制 API key 和 API secret，然后将您服务器的公网 IP 地址添加到该密钥的白名单中。未配置白名单的密钥无法获取令牌。

**4. 激活 API 访问权限**

发送邮件至 [contact@velafi.com](mailto:contact@velafi.com)，申请为您的账户激活 API 访问权限。VelaFi 支持团队会在您的账户启用后进行确认。

**5. 激活商户支付账户**

提交特定国家所需的文件，以激活商户将要使用的法币通道（ARS、MXN、BRL、USD 等）。每个已激活的通道都会获得一个专用支付账户——例如用于阿根廷比索业务的 CVU 和 CUIT。

***

## API 环境

VelaFi 提供两个相互隔离的环境。在切换到生产环境之前，请使用沙盒环境开发和测试您的集成。

| 环境 | 基础 URL | 用途 |
| - | - | - |
| **沙盒环境** | `https://api-test.velafi.com` | 模拟交易，不涉及真实资金 |
| **生产环境** | `https://api.velafi.com` | 使用真实资金的实时交易 |

> [!NOTE]
>
> 沙盒环境凭证与您的生产环境 API 密钥相互独立。请联系 VelaFi 团队获取沙盒环境凭证——访问沙盒环境无需完成 KYC 或创建 API 密钥。

***

## 认证

需要认证的请求在 `X-BH-TOKEN` 请求头中携带业务令牌。您的服务器使用 API key 和 API secret 对请求签名，从 `GET /v2/token/generate` 获取令牌，并在令牌过期前申请新令牌。未携带令牌的请求会失败并返回代码 `-1002`，携带无效或已过期令牌的请求会失败并返回代码 `-1022`。

```http theme={null}
X-BH-TOKEN: YOUR_TOKEN
```

以下是一个获取账户详情的最简示例：

```bash theme={null}
curl --request GET \
  --url https://api.velafi.com/v2/user/account \
  --header "X-BH-TOKEN: YOUR_TOKEN"
```

有关签名步骤和 IP 白名单要求，请参阅[认证](https://docs.velafi.com/cn/api-reference/authentication.md)。

> [!WARNING]
>
> 请像对待密码一样对待您的 API secret 和令牌。切勿在客户端代码、公开代码仓库或日志文件中泄露它们。如果您怀疑密钥或 secret 已泄露，请在 API Management 页面删除该密钥并创建新的密钥。

***

## 浏览文档

> [card] [快速入门](https://docs.velafi.com/cn/docs/quickstart.md)
>
> 创建账户、生成 API 密钥，并在几分钟内完成首次 API 调用。

> [card] [沙盒环境](https://docs.velafi.com/cn/docs/sandbox.md)
>
> 上线前使用模拟数据测试您的完整集成。

> [card] [入金指南](https://docs.velafi.com/cn/docs/guides/on-ramp.md)
>
> 构建法币到加密货币入金流程的分步说明。

> [card] [API 参考](https://docs.velafi.com/cn/api-reference/overview.md)
>
> 完整的接口文档，包括参数、请求体和响应结构。


## Related topics

- [VelaFi API 文档](https://docs.velafi.com/cn/index.md)


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