跳转到内容
PGSwift Docs
文档/更新日志

更新日志

影响集成的 API 与 Webhook 变更,按时间倒序排列。

2026-11-18

  • 变更 破坏性变更(2026-11-18 生效):沙箱现在与生产环境一样校验 API IP 白名单。来自未加入白名单 IP 地址的沙箱请求返回 HTTP 403(Your IP address is not API whitelisted.),未携带 X-PARTNER-ID 请求头的沙箱请求返回 HTTP 400(Missing X-PARTNER-ID header.)。在沙箱中测试前,请先注册您的服务器 IP 地址。已关闭 IP 白名单的账户不进行 IP 白名单匹配。参见 IP 白名单。

2026-11-17

  • 变更 POST /api/inquiry 现在会拒绝缺失、不是数字或小于 1 的 amount,返回 HTTP 400 及新错误代码 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:收款人姓名相似度分数及姓名校验的决定方。V1 disbursement.completed 回调不变。参见付款查询。
  • 新增 沙箱关键词 NONAME、REJECT、REVIEW(放在 customer_name 中)用于测试姓名校验。参见付款查询。
  • 新增 姓名校验自动拒绝(按账户开启,Enforce 模式):姓名相似度分数低于自动拒绝阈值的查询在 POST /api/inquiry 直接失败,reason 为既有的 Rejected,trigger_source 为 auto_reject。不扣减余额;disbursement.v2.fail 与 V1 disbursement.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.completed Webhook 增加 payer_info(付款人姓名、PAN、发卡方代码、发卡方名称),仅对在接入时开通此功能的商户发送。支付渠道未提供的字段为 null。
© 2026 PGSwift. 保留所有权利。