2026-09-18 — Pix - Woovi 活体检测
- 重命名：
POST /v2/merchant/woovi/liveness：获取 Pix - Woovi 激活所需的活体检测 URL（由 Avenia 提供）。
2026-09-14 — 阿根廷 Alias 和 CVU 查询
- 新增
GET /v2/merchant/check/alias：将阿根廷 alias 解析为对应的 CBU/CVU、状态及账户持有人。 - 新增
GET /v2/merchant/check/cvu：查询 CVU 或 CBU 对应的持有人 CUIT 和姓名。
2026-09-07 — 订单详情中的费用明细
GET /v2/order/detail现在会为法币到加密货币和加密货币到法币订单返回orderFeeDetail，其中包含grossAmount、netAmount和feeLines。- 对于法币到法币订单，会返回
onRampOrderFeeDetail和offRampOrderFeeDetail。
2026-05-28 — 沙盒环境加密货币充值模拟器
- 新增仅限沙盒环境的接口
/v2/platform/test/crypto/deposit，用于向商户添加测试加密资金。参见沙盒环境测试工具。
2026-04-23 — 订单失败详情
GET /v2/order/detail现在会为法币到加密货币和加密货币到法币订单返回failCode和failReason。
2026-04-22 — 加密货币提现备注
POST /v2/assets/withdraw支持可选参数remark。GET /v2/assets/withdrawalOrders会返回该字段。
2026-04-17 — 支付方式模板元数据
- 新增
GET /v2/payments/templates/metamessage：支付方式模板的字段级元数据。
2026-02-28 — 订单过期时间戳
- 当订单处于等待加密货币充值状态（
orderStatus32）时，GET /v2/order/detail会返回orderExpireTimestamp。
2026-02-05 — 沙盒环境法币充值模拟器
- 新增仅限沙盒环境的接口
/v2/platform/test/deposit，用于模拟向商户已激活的法币账户进行银行充值。参见沙盒环境测试工具。
2026-01-17 — 报价 ID
- 加密货币报价（
GET /v2/user/crypto-quote）和法币报价（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：在已激活的法币账户下创建虚拟账户。 - 新增
GET /v2/merchant/virtual/addfunds：列出商户的虚拟账户。
2025-12-12 — 订单详情中的银行订单 ID
GET /v2/order/detail现在会为法币到加密货币和加密货币到法币订单返回bankOrderId。
2025-12-01 — 法币流水记录
- 新增
GET /v2/merchant/fiat/flows：商户法币余额变动的流水账。
2025-11-18 — 指南与 API 参考更新
本次发布对文档进行了全面改进，涵盖商户入驻流程、全新的限额指南，以及商户限额管理相关的 API 参考页面更新。指南
1. 分步指南
1. 分步指南
更新了入驻流程说明，使其更加清晰，并反映最新的商户设置流程。
2. 创建商户
2. 创建商户
更新了 KYC/KYB 商户创建流程，包括更清晰的验证步骤和要求说明。
3. 激活商户账户
3. 激活商户账户
更新了商户账户激活流程，更清晰地说明了法币账户的激活要求。
4. 限额 — 新指南
4. 限额 — 新指南
新增指南，介绍商户限额等级、审批标准以及申请提升限额的操作说明。
API 参考
5. 账户 — 获取账户详情
5. 账户 — 获取账户详情
更新了 API 响应结构，新增商户限额信息及相关字段。
6. 商户 — 创建商户
6. 商户 — 创建商户
更新了商户创建的 KYC/KYB 流程。新增改进后的 API 请求和响应示例。
7. 商户 — 获取商户列表
7. 商户 — 获取商户列表
更新了与商户限额相关的 API 字段，包括限额状态以及审批通过/拒绝原因。
8. 商户 — 激活商户账户（个人）
8. 商户 — 激活商户账户（个人）
更新了个人商户法币账户的激活流程。
9. 商户 — 激活商户账户（企业）
9. 商户 — 激活商户账户（企业）
更新了企业商户法币账户的激活流程，并完善了流程要求。
10. 商户 — 获取商户账户列表
10. 商户 — 获取商户账户列表
更新了与商户账户限额及限额状态跟踪相关的 API 响应字段。
11. 商户 — 提升商户限额
11. 商户 — 提升商户限额
更新了商户限额提升流程，修订了审批逻辑并完善了参数定义。
2025-06-13 — KYC/KYB 商户创建流程
本次发布将商户创建流程切换为 KYC/KYB 模式，并引入了激活商户账户接口。2025-06-13 之前发布的接口将暂时继续可用，但已计划弃用。请尽快迁移到新的 KYC/KYB 流程，以免业务中断。
流程更新：商户创建
商户创建流程已更新为采用 KYC/KYB 模式。有关更新后的步骤和验证要求，请参阅创建商户指南。
API 更新：创建商户接口
create merchants API 接口已更新，以适配新的 KYC/KYB 流程。请更新你的集成以使用修订后的请求结构。新指南：激活商户账户
新增的指南步骤介绍了在成功创建商户实体后如何激活法币账户，确保商户能够完整地进行法币交易。
新接口：激活商户账户
新的 API 接口允许商户在完成初始设置后激活其法币账户。商户必须完成此步骤才能处理法币交易。
2025-05-08 — 资金记录 Webhook 字段与划转接口
本次发布为资金记录消息推送 Webhook 增加了更丰富的付款方信息，并新增了内部资金划转接口。资金记录消息推送 Webhook
Webhook 负载现在包含两个新字段，提供更详细的资金记录信息，便于更好地跟踪和管理资金来源。string
汇款方名称。
string
汇款方银行账户。
新接口：内部资金划转
新增POST /v2/merchant/transfer 接口，用于在账户之间发起内部资金划转。
2025-04-14 — 待用资金系统
本次发布引入了待用资金 (Pending Fund) 系统——包括一种新的支付方式、三个新的 API 接口，以及一个用于实时事件通知的专用 Webhook。新支付方式：VelaFi Pending Fund（ID：70）
通过 API 创建订单时，你现在可以选择 VelaFi Pending Fund（支付 ID70）作为付款或收款方式。使用预存资金可以绕过外部转账确认的延迟，从而加快交易处理速度。
新 API 接口
1
查询待用资金
通过 API 查询你的待用资金账户余额和状态。你还可以向该账户预存资金，避免实时交易过程中因外部转账确认而产生的延迟。位置： API 参考 → 商户
2
领取待用资金
随时将待用资金账户中的可用余额提取到指定的支付方式。这提供了灵活、按需的资金管理。位置： API 参考 → 商户
3
查询资金记录
获取所有待用资金相关活动的详细记录——包括充值、提取、使用和退款——实现完整的可追溯性和财务透明度。位置： API 参考 → 商户
新 Webhook：资金记录消息推送
资金记录消息推送
接收待用资金事件的实时 Webhook 通知。每条通知都会将结构化的交易数据推送到你的端点，提升运营自动化水平和资金监控能力。位置： Webhooks