变更日志

记录 VM API 的每次变更。此变更日志按时间顺序列出 VM API 的新增、更新和删除，便于开发者了解版本差异并完成接口对接。

2026-08-05

概述

本次版本新增 vm_card_id，这是 VM 系统生成的专属卡 ID。
为了兼容现有系统，card_id 本版本仍保留可用，但后续会逐步废弃，建议新接入优先使用 vm_card_id。

接口变更

新增 `vm_card_id` 入参支持

以下接口现在支持通过 vm_card_id 查询或操作卡：

POST /cardDetail

POST /deleteCard

POST /freezeCard

POST /rechargeCard

POST /refundCard

POST /cardTransaction

POST /updateCardLimit

POST /getCardList

POST /getCardFlow

新增 `vm_card_id` 出参

以下接口返回结果中新增 vm_card_id：

POST /createCard

POST /cardDetail

POST /cardTransaction

POST /getCardList

POST /getCardFlow

其他说明

card_id 仍然保留，兼容历史调用。

如果同时传了 card_id 和 vm_card_id，两者必须指向同一张卡。

vm_card_id 是 VM 内部专属卡标识，后续会作为主标识使用。

非卡相关接口本次无变更。

Webhook / 回调

如果你们对接了 VM 的 webhook 或回调消息，消息体中也会同步增加 vm_card_id 字段，方便下游系统统一使用 VM 卡标识。

2026-06-09

为提高 VM API 对外对接能力，本次更新如下：

新增

新增对外开放用户自定义请求标识。开发者可在请求头中传入 X-Client-Request-Id，用于请求追踪、重复请求识别和日志关联；如请求中传入该参数，响应头也会返回相同的 X-Client-Request-Id。

新增获取卡流水接口：/getCardFlow。

更新

获取产品码接口 /getProductCode 响应结果新增返回值：remaining_open_card_num，表示当前产品码剩余可开卡数量。

变更明细

类型	接口/能力	变更内容
新增	用户自定义 `X-Client-Request-Id`	支持开发者在请求头中传入自定义请求标识；如传入，响应头会返回相同的 `X-Client-Request-Id`
新增	`/getCardFlow`	新增获取卡流水接口
更新	`/getProductCode`	返回值新增 `remaining_open_card_num`

请求头说明

Header	必填	说明
`X-Client-Request-Id`	否	用户自定义请求标识；同一应用下重复传入相同值时会返回 `Duplicate Client Request Id`

响应头说明

Header	说明
`X-Client-Request-Id`	当请求头传入 `X-Client-Request-Id` 时，响应头会返回相同值

2026-08-05#

概述#

接口变更#

新增 vm_card_id 入参支持#

新增 vm_card_id 出参#

其他说明#

Webhook / 回调#

2026-06-09#

新增#

更新#

变更明细#

请求头说明#

响应头说明#