变更记录

Business Collection · On-Ramp v0.1复制锚点链接

变更类型：新增

• 首版。报价、下单、查单、开通收款账号、查询收款账号 5 个接口，以及订单 Webhook。路径前缀 /openapi/v1/collections/on-ramp。

详见 On-Ramp 指南。

Payment OpenAPI v1.7复制锚点链接

变更类型：文档澄清

• 行内转账补充 remarks 字符限制说明：仅支持字母数字、空格及特殊字符 / - ? : ( ) . , ' +。

v1.6复制锚点链接

变更类型：新增

• 资金入账 Webhook 新增 senderBankName、masterAccountNo 字段；source 取值新增 INTERNAL，移除 AC（实际未使用）。

v1.5复制锚点链接

变更类型：文档澄清

• 手续费币种，更新为手续费计价币种。

v1.4复制锚点链接

变更类型：文档澄清

• 资金入账 Webhook 字段格式说明：tradeDate / valueDate 使用银行原始格式 yyyyMMdd；tradeTime 使用 HHmmssSSS；source 补充 SWIFTMX。

v1.3复制锚点链接

变更类型：兼容性增强

• 转账结果查询接口增强 POBO 出账订单兼容性：建议传入 poboAccountNo；未传 accountNumber 时，系统将根据 referenceNo 自动匹配对应 POBO 出账账号。

v1.2复制锚点链接

变更类型：新增

• 转账接口响应新增 poboAccountNo、poboAccountName 字段。
• 转账结果查询接口新增 accountNumber Query 参数（支持显式指定 POBO 出账账号）。
• 行内转账响应 status 取值补充 SENT_TO_BANK。
• 新增查询转账预估手续费接口。

详见 Payment 产品指南。

Checkout B2C Payment Intent API v1.2复制锚点链接

变更类型：修改（不兼容）

• 金额改为标准单位十进制字符串（如 "20.00"），不再使用最小货币单位。
• 时间改为带时区偏移的 ISO 8601。
• Payment Intent 状态改为 AWAITING_PAYMENT / PROCESSING / PARTIALLY_PAID / PAID / COMPLETED / CANCELED。
• Refund 状态与退款原因改为大写码值。
• 字段改名：id → paymentIntentId / refundId，paymentIntent → paymentIntentId，amountReceived → receivedAmount，amountUsd → usdAmount，amountReceivedUsd → receivedUsdAmount，fee → feeAmount，succeededAt → completedAt。
• 删除 object、livemode、customerWalletAddress、paidChain、paidToken、txHash。付款明细见 payments[]。
• 列表改为 pageNum / pageSize 分页。
• Refund 创建路径改为 /refunds，详情路径改为 /{paymentIntentId}/refunds/{refundId}。
• 创建接口返回 HTTP 200。
• Webhook 载荷与查询接口返回相同对象。

详见 Checkout 产品指南。