> ## 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 API 版本发布的完整历史——涵盖各版本的新接口、工作流更新、新增 Webhook 以及文档改进。

本页记录 VelaFi API 平台的所有重要变更，包括新接口、工作流更新、新增 Webhook 以及文档改进。每当你升级集成或希望使用新功能时，请查阅本更新日志。变更按时间倒序列出。

***

## 2026-09-18 — Pix - Woovi 活体检测

* 重命名：[`POST /v2/merchant/woovi/liveness`](https://docs.velafi.com/cn/api-reference/merchant/get-woovi-liveness-url)：获取 Pix - Woovi 激活所需的活体检测 URL（由 Avenia 提供）。

***

## 2026-09-14 — 阿根廷 Alias 和 CVU 查询

* 新增 [`GET /v2/merchant/check/alias`](https://docs.velafi.com/cn/api-reference/beneficiary/check-alias)：将阿根廷 alias 解析为对应的 CBU/CVU、状态及账户持有人。
* 新增 [`GET /v2/merchant/check/cvu`](https://docs.velafi.com/cn/api-reference/beneficiary/check-cvu)：查询 CVU 或 CBU 对应的持有人 CUIT 和姓名。

***

## 2026-09-07 — 订单详情中的费用明细

* [`GET /v2/order/detail`](https://docs.velafi.com/cn/api-reference/order/retrieve-a-specific-order) 现在会为法币到加密货币和加密货币到法币订单返回 `orderFeeDetail`，其中包含 `grossAmount`、`netAmount` 和 `feeLines`。
* 对于法币到法币订单，会返回 `onRampOrderFeeDetail` 和 `offRampOrderFeeDetail`。

***

## 2026-05-28 — 沙盒环境加密货币充值模拟器

* 新增仅限沙盒环境的接口 `/v2/platform/test/crypto/deposit`，用于向商户添加测试加密资金。参见[沙盒环境测试工具](https://docs.velafi.com/cn/docs/sandbox.md#sandbox-testing-tools)。

***

## 2026-04-23 — 订单失败详情

* [`GET /v2/order/detail`](https://docs.velafi.com/cn/api-reference/order/retrieve-a-specific-order) 现在会为法币到加密货币和加密货币到法币订单返回 `failCode` 和 `failReason`。

***

## 2026-04-22 — 加密货币提现备注

* [`POST /v2/assets/withdraw`](https://docs.velafi.com/cn/api-reference/crypto-wallet/create-crypto-withdrawal) 支持可选参数 `remark`。
* `GET /v2/assets/withdrawalOrders` 会返回该字段。

***

## 2026-04-17 — 支付方式模板元数据

* 新增 [`GET /v2/payments/templates/metamessage`](https://docs.velafi.com/cn/api-reference/beneficiary/get-payment-templates-metamessage)：支付方式模板的字段级元数据。

***

## 2026-02-28 — 订单过期时间戳

* 当订单处于等待加密货币充值状态（`orderStatus` `32`）时，[`GET /v2/order/detail`](https://docs.velafi.com/cn/api-reference/order/retrieve-a-specific-order) 会返回 `orderExpireTimestamp`。

***

## 2026-02-05 — 沙盒环境法币充值模拟器

* 新增仅限沙盒环境的接口 `/v2/platform/test/deposit`，用于模拟向商户已激活的法币账户进行银行充值。参见[沙盒环境测试工具](https://docs.velafi.com/cn/docs/sandbox.md#sandbox-testing-tools)。

***

## 2026-01-17 — 报价 ID

* [加密货币报价](https://docs.velafi.com/cn/api-reference/quote/get-user-quote-for-crypto-fiat.md)（`GET /v2/user/crypto-quote`）和[法币报价](https://docs.velafi.com/cn/api-reference/quote/get-user-quote-for-fiat-fiat.md)（`GET /v2/user/fiat-quote`）支持可选参数 `createQuoteId`，并返回 `quoteId`。
* `POST /v2/order/fiat_to_crypto`、`POST /v2/order/crypto_to_fiat` 和 `POST /v2/order/fiat_to_fiat` 支持 `quoteId`。

***

## 2026-01-08 — 虚拟账户

* 新增 [`POST /v2/merchant/virtual/accounts`](https://docs.velafi.com/cn/api-reference/merchant/create-multiple-virtual-account)：在已激活的法币账户下创建虚拟账户。
* 新增 [`GET /v2/merchant/virtual/addfunds`](https://docs.velafi.com/cn/api-reference/merchant/get-multiple-virtual-account)：列出商户的虚拟账户。

***

## 2025-12-12 — 订单详情中的银行订单 ID

* [`GET /v2/order/detail`](https://docs.velafi.com/cn/api-reference/order/retrieve-a-specific-order) 现在会为法币到加密货币和加密货币到法币订单返回 `bankOrderId`。

***

## 2025-12-01 — 法币流水记录

* 新增 [`GET /v2/merchant/fiat/flows`](https://docs.velafi.com/cn/api-reference/merchant/get-a-list-merchant-fiat-flow)：商户法币余额变动的流水账。

***

## 2025-11-18 — 指南与 API 参考更新

本次发布对文档进行了全面改进，涵盖商户入驻流程、全新的限额指南，以及商户限额管理相关的 API 参考页面更新。

### 指南

> [accordion] 1. 分步指南
>
> 更新了入驻流程说明，使其更加清晰，并反映最新的商户设置流程。

> [accordion] 2. 创建商户
>
> 更新了 KYC/KYB 商户创建流程，包括更清晰的验证步骤和要求说明。

> [accordion] 3. 激活商户账户
>
> 更新了商户账户激活流程，更清晰地说明了法币账户的激活要求。

> [accordion] 4. 限额 — 新指南
>
> 新增指南，介绍商户限额等级、审批标准以及申请提升限额的操作说明。

### API 参考

> [accordion] 5. 账户 — 获取账户详情
>
> 更新了 API 响应结构，新增商户限额信息及相关字段。

> [accordion] 6. 商户 — 创建商户
>
> 更新了商户创建的 KYC/KYB 流程。新增改进后的 API 请求和响应示例。

> [accordion] 7. 商户 — 获取商户列表
>
> 更新了与商户限额相关的 API 字段，包括限额状态以及审批通过/拒绝原因。

> [accordion] 8. 商户 — 激活商户账户（个人）
>
> 更新了个人商户法币账户的激活流程。

> [accordion] 9. 商户 — 激活商户账户（企业）
>
> 更新了企业商户法币账户的激活流程，并完善了流程要求。

> [accordion] 10. 商户 — 获取商户账户列表
>
> 更新了与商户账户限额及限额状态跟踪相关的 API 响应字段。

> [accordion] 11. 商户 — 提升商户限额
>
> 更新了商户限额提升流程，修订了审批逻辑并完善了参数定义。

***

## 2025-06-13 — KYC/KYB 商户创建流程

本次发布将商户创建流程切换为 KYC/KYB 模式，并引入了激活商户账户接口。

> [!NOTE]
>
> **2025-06-13** 之前发布的接口将暂时继续可用，但已计划弃用。请尽快迁移到新的 KYC/KYB 流程，以免业务中断。

> [card] 流程更新：商户创建
>
> 商户创建流程已更新为采用 KYC/KYB 模式。有关更新后的步骤和验证要求，请参阅**创建商户**指南。

> [card] API 更新：创建商户接口
>
> `create merchants` API 接口已更新，以适配新的 KYC/KYB 流程。请更新你的集成以使用修订后的请求结构。

> [card] 新指南：激活商户账户
>
> 新增的指南步骤介绍了在成功创建商户实体后如何激活法币账户，确保商户能够完整地进行法币交易。

> [card] 新接口：激活商户账户
>
> 新的 API 接口允许商户在完成初始设置后激活其法币账户。商户必须完成此步骤才能处理法币交易。

***

## 2025-05-08 — 资金记录 Webhook 字段与划转接口

本次发布为资金记录消息推送 Webhook 增加了更丰富的付款方信息，并新增了内部资金划转接口。

### 资金记录消息推送 Webhook

Webhook 负载现在包含两个新字段，提供更详细的资金记录信息，便于更好地跟踪和管理资金来源。

**payerName** `string`

汇款方名称。

**payerAccount** `string`

汇款方银行账户。

### 新接口：内部资金划转

新增 `POST /v2/merchant/transfer` 接口，用于在账户之间发起内部资金划转。

```http theme={null}
POST /v2/merchant/transfer
```

***

## 2025-04-14 — 待用资金系统

本次发布引入了待用资金 (Pending Fund) 系统——包括一种新的支付方式、三个新的 API 接口，以及一个用于实时事件通知的专用 Webhook。

### 新支付方式：VelaFi Pending Fund（ID：70）

通过 API 创建订单时，你现在可以选择 **VelaFi Pending Fund**（支付 ID `70`）作为付款或收款方式。使用预存资金可以绕过外部转账确认的延迟，从而加快交易处理速度。

### 新 API 接口

**1. 查询待用资金**

通过 API 查询你的**待用资金账户**余额和状态。你还可以向该账户预存资金，避免实时交易过程中因外部转账确认而产生的延迟。

**位置：** API 参考 → 商户

**2. 领取待用资金**

随时将**待用资金账户**中的可用余额提取到指定的支付方式。这提供了灵活、按需的资金管理。

**位置：** API 参考 → 商户

**3. 查询资金记录**

获取所有**待用资金相关活动**的详细记录——包括充值、提取、使用和退款——实现完整的可追溯性和财务透明度。

**位置：** API 参考 → 商户

### 新 Webhook：资金记录消息推送

> [card] 资金记录消息推送
>
> 接收待用资金事件的实时 Webhook 通知。每条通知都会将结构化的交易数据推送到你的端点，提升运营自动化水平和资金监控能力。
>
> **位置：** Webhooks


## Related topics

- [更新 Webhook](https://docs.velafi.com/cn/api-reference/webhooks/update-a-webhook.md)
- [获取 Webhook 列表](https://docs.velafi.com/cn/api-reference/webhooks/get-webhook-endpoints.md)
- [Webhook](https://docs.velafi.com/cn/docs/guides/webhooks.md)
- [全球支付（法币兑法币）](https://docs.velafi.com/cn/docs/guides/global-payments.md)
- [获取资金记录](https://docs.velafi.com/cn/api-reference/merchant/retrieve-funding-records.md)


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