影响集成的 API 与 Webhook 变更,按时间倒序排列。
2026-11-18
- 变更 破坏性变更(2026-11-18 生效):沙箱现在与生产环境一样校验 API IP 白名单。来自未加入白名单 IP 地址的沙箱请求返回 HTTP
403(Your IP address is not API whitelisted.),未携带X-PARTNER-ID请求头的沙箱请求返回 HTTP400(Missing X-PARTNER-ID header.)。在沙箱中测试前,请先注册您的服务器 IP 地址。已关闭 IP 白名单的账户不进行 IP 白名单匹配。参见 IP 白名单。
2026-11-17
- 变更
POST /api/inquiry现在会拒绝缺失、不是数字或小于 1 的amount,返回 HTTP400及新错误代码INVALID_AMOUNT(Invalid amount, minimum 1.)。不会创建查询,也不会预留余额。金额为 1 及以上时行为不变。参见付款查询。
2026-11-16
- 新增
POST /api/create/va、POST /api/checkout与POST /api/checkout/va可选字段company_name:贵公司名称,在客户通过虚拟账户付款时显示为虚拟账户名称。仅部分银行支持;其他银行显示默认名称。允许字符:字母 A-Z、空格和.,其他字符(包括数字)会被移除。超过 30 个字符的值会被截断,剩余字母少于 3 个时该值将被忽略(例如A+B变为AB,因此被忽略)。如有发送,该值也会在结账响应的customer_details/customer_obj以及支付完成 Webhook 的customer_info中返回。参见虚拟账户。
2026-11-12
- 新增 客户账户被停用时,所有签名 API 接口返回 HTTP
403及错误码40301001(Client is inactive)。参见认证。
2026-11-05
- 新增
POST /api/inquiry(含重复调用)、POST /api/check/inquiry以及 V2 出款 Webhook(disbursement.v2.completed、disbursement.v2.fail、disbursement.v2.expired)中的data.similarity_score与data.trigger_source:收款人姓名相似度分数及姓名校验的决定方。V1disbursement.completed回调不变。参见付款查询。 - 新增 沙箱关键词
NONAME、REJECT、REVIEW(放在customer_name中)用于测试姓名校验。参见付款查询。 - 新增 姓名校验自动拒绝(按账户开启,Enforce 模式):姓名相似度分数低于自动拒绝阈值的查询在
POST /api/inquiry直接失败,reason为既有的Rejected,trigger_source为auto_reject。不扣减余额;disbursement.v2.fail与 V1disbursement.completed回调(状态fail)立即发送。没有新的状态、错误代码或原因。 - 变更 对开启姓名校验的账户:银行未返回账户持有人姓名的查询现在会挂起等待审核(
status为pending,similarity_score为0),不再直接通过为valid;若自动拒绝处于 Enforce 模式,则直接失败,reason为Rejected。此前银行未返回姓名时会跳过姓名校验。
2026-10-30
- 新增
POST /api/inquiry可选字段transfer_type:bifast(默认,行为不变)或rtol(出款走实时在线转账)。参见付款查询。 - 新增 错误代码
INVALID_TRANSFER_TYPE(HTTP 400):transfer_type既不是bifast也不是rtol时返回。 - 新增
POST /api/inquiry与POST /api/check/inquiry响应中的data.transfer_type:本次出款实际使用的转账类型,bifast或rtol。 - 新增 出款 Webhook(
disbursement.completed、disbursement.v2.completed、disbursement.v2.fail、disbursement.v2.expired)中的data.transfer_type:bifast或rtol。参见出款完成 Webhook。
2026-10-29
- 新增
payment.completed与payment.v2.completedWebhook 增加payer_info(付款人姓名、PAN、发卡方代码、发卡方名称),仅对在接入时开通此功能的商户发送。支付渠道未提供的字段为null。