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

​
核心工作流

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

法币 → 加密货币入金

接收客户的本地法币，并立即将等值的稳定币或加密货币记入其托管钱包。

加密货币 → 法币出金

兑换加密货币或稳定币余额，并以当地货币将法币资金直接打入收款人的银行账户。

法币 → 法币全球支付

以稳定币作为结算通道进行跨境汇款，付款方和收款方各自使用本地货币进行交易。

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

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

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

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

​
全球支付：法币 → 法币

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

​
接入概览

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

创建 VelaFi 账户

在 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，申请为您的账户激活 API 访问权限。VelaFi 支持团队会在您的账户启用后进行确认。
5

激活商户支付账户

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

​
API 环境

VelaFi 提供两个相互隔离的环境。在切换到生产环境之前，请使用沙盒环境开发和测试您的集成。
沙盒环境凭证与您的生产环境 API 密钥相互独立。请联系 VelaFi 团队获取沙盒环境凭证——访问沙盒环境无需完成 KYC 或创建 API 密钥。

​
认证

需要认证的请求在 X-BH-TOKEN 请求头中携带业务令牌。您的服务器使用 API key 和 API secret 对请求签名，从 GET /v2/token/generate 获取令牌，并在令牌过期前申请新令牌。未携带令牌的请求会失败并返回代码 -1002，携带无效或已过期令牌的请求会失败并返回代码 -1022。
以下是一个获取账户详情的最简示例：
有关签名步骤和 IP 白名单要求，请参阅认证。
请像对待密码一样对待您的 API secret 和令牌。切勿在客户端代码、公开代码仓库或日志文件中泄露它们。如果您怀疑密钥或 secret 已泄露，请在 API Management 页面删除该密钥并创建新的密钥。

​
浏览文档

快速入门

创建账户、生成 API 密钥，并在几分钟内完成首次 API 调用。

沙盒环境

上线前使用模拟数据测试您的完整集成。

入金指南

构建法币到加密货币入金流程的分步说明。

API 参考

完整的接口文档，包括参数、请求体和响应结构。