---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/appendix/docUpdateRecord/index.md
description: 记录文档和接口能力的更新历史，帮助商户追踪 API、SDK、支付方式和字段变更。
---
## 2025年1月
| 发布日期        | 发布事项               | 内容简介                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|-------------|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 2025年1月5日   | Element SDK 文档重构 | **文档重构**：更新 Element SDK 集成指南至 2.0 版本<br/>**架构升级**：<ul><li>新增模块化架构设计（PingPongSDK、sdkController、registry、paymentService、EventHub）</li><li>支持两种业务模式：payment（下单并支付）和 codeGrant（绑定钱包）</li><li>统一的事件模型：所有支付元素支持相同的事件类型（ready、success、error、cancel、click）</li></ul>**新增功能**：<ul><li>支持 Apple Pay、Google Pay、PayPal 三种支付方式</li><li>支持营销活动配置（payDiscount 参数）</li><li>完整的初始化流程和支付流程时序图</li></ul>**文档优化**：<ul><li>添加完整的代码示例（HTML/CSS/JavaScript）</li><li>详细的 API 参数说明</li><li>10个常见问题解答</li><li>版本历史记录</li></ul>**文档路径**：`/notes/zh/integrate/sdk-elements/`
| 2025年1月6日   | SDK v4.2 接口参数优化 | **参数调整**：优化 PingPong.Checkout.create 接口参数<br/>**删除参数**：<ul><li>删除 `goodsName` - 商品名称</li><li>删除 `goodsDesc` - 商品描述</li></ul>**新增参数**：<ul><li>新增 `goods` - 商品列表数组，包含 description、imgUrl、name、number、sku、unitPrice、virtualProduct 等字段</li></ul>**功能增强**：<ul><li>`updateCheckoutHook` 支持更新 goods 参数</li><li>添加商品信息动态更新示例</li></ul>**文档优化**：<ul><li>统一代码示例风格，移除特殊标记</li><li>更新完整示例代码配置</li></ul>**文档路径**：`/notes/zh/integrate/sdk-v4-2/` |

## 2025年10月
| 发布日期        | 发布事项               | 内容简介                                                                                                                                                                                                                                                                                                |
|-------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 2025年10月31日  | 新增API端点地址文档 | **新增文档**：开发指南中新增"API端点地址"文档<br/>**主要内容**：<ul><li>站点架构说明（在线业务/终端业务/商户后台）</li><li>三大站点域名配置（FRA/SG/US）</li><li>站点选择原则（基于商户主体注册地）</li><li>站点数据互通说明（FRA↔SG互通，US独立）</li></ul>**文档路径**：`/notes/zh/onlinePayment/developer/endpoint/`                                                                                         |
| 2025年10月13日  | 统一下单接口参数优化 | **客户信息字段扩展**：在customer对象中新增支付相关字段<br/>**包含字段**：<ul><li>`accountNumber` - 银行账号</li><li>`domesticCardNumber` - 本地卡号</li><li>`domesticCardIssuingDate` - 本地卡发行日期</li><li>`domesticCardExpireMonth` - 本地卡到期月份</li><li>`domesticCardExpireYear` - 本地卡到期年份</li></ul>**字段优化**：删除重复的merchantUserId字段，简化字段描述 |
| 2025年10月13日  | 面对面支付接口参数优化 | **支付方式明确化**：更新paymentMethod字段描述<br/>**支持方式**：<ul><li>`Card Purchase` - 刷卡支付</li><li>`QR-POSScan` - B扫C支付</li><li>`QR Payment` - C扫B支付</li><li>`Octopus` - 八达通刷卡支付（香港）</li></ul>                                                                                                                     |

## 2025年9月
| 发布日期        | 发布事项               | 内容简介                                                     |
|-------------|--------------------|---------------------------------------------------------|
| 2025年9月11日  | /v4/payment/unifiedPay接口响应参数新增 | **新增字段**：为微信小程序支付新增extraParam响应参数<br/>**包含参数**：<ul><li>`wxTimeStamp`</li><li>`wxNonceStr`</li><li>`wxPackage`</li><li>`wxSignType`</li><li>`wxPaySign`</li></ul> |
| 2025年9月11日  | 内嵌SDK功能增强 | **新增参数**：<ul><li>`useTabMode` - 当商户仅有卡支付时可隐藏选项框</li></ul>**新增事件**：<ul><li>`ready` - 初始化成功事件</li><li>`error` - 初始化失败事件</li></ul> |

## 2025年8月
| 发布日期        | 发布事项               | 内容简介                                                     |
|-------------|--------------------|---------------------------------------------------------|
| 2025年8月28日  | 微信小程序支付功能上线 | **新增支付方式**：正式上线微信小程序支付功能<br/>**功能特性**：<ul><li>支持微信小程序内支付场景</li><li>完整的支付流程和参数示例</li><li>专门的技术文档和集成指南</li></ul> |

## 2024年6月（API文档专业版上线）
| 发布日期      | 发布事项   | 内容简介                                                      |
|-----------|--------|-----------------------------------------------------------|
| 2024年6月8日 | 新版文档发布 | 新版文档对文档产品功能进行了更精准的划分，并且对文档内容进行了优化，更方便开发者查看，后续版本更新都会基于新版文档 |

## 2023年12月
| 发布日期        | 发布事项                  | 内容简介                               |
|-------------|-----------------------|------------------------------------|
| 2023年12月1日  | 拒付流程图更新               | 替换了流程图                             |
| 2023年12月12日 | 异步通知和交易查询接口中3DS枚举值变更  | 异步通知和交易查询接口中3DS枚举值变更，枚举值由数字变更成大写字母 |
| 2023年12月13日 | 新增JS-SDK-2.0文档        | /                                  |
| 2023年12月14日 | 新增JS-SDK-2.0调试工具      | /                                  |
| 2023年12月15日 | 调整国家代码/交易币种列表，新增中文翻译列 | /                                  |
| 2023年12月21日 | 拒付新增异常代码              | UploadFileNumMaxError，表示`文件超过最大数量` |

## 2023年11月
| 发布日期        | 发布事项                          | 内容简介                                       |
|-------------|-------------------------------|--------------------------------------------|
| 2023年11月16日 | 拒付主动获取调单明细和获取拒付明细返回处理截止时间格式调整 | 格式由原先的YYYY/MM/DD更新为yyyy-MM-dd HH:mm:ss     |
| 2023年11月22日 | 风险管理部分调整                      | （1）拒付部分整合到风险管理部分；（2）风控组件增加SecureShieldJs组件 |

## 2023年10月
| 发布日期        | 发布事项      | 内容简介                          |
|-------------|-----------|-------------------------------|
| 2023年10月12日 | 新增错误码     | 新增错误码：301021，301022，具体见附录状态码表 |
| 2023年10月23日 | 交易对账单接口下架 | 新增SFTP对账服务                    |

## 2023年9月
| 发布日期       | 发布事项             |内容简介                                                                       |
|------------|------------------|----------------------------------------------------------------------------|
| 2023年9月5日  | 新增产品文档           | 新增线下条码支付产品文档，文档地址：https://acquirer-api-docs-v4.pingpongx.com/notes/zh/onlinePayment/offlineBarcodePayment/ |
| 2023年9月5日  | 新增调单通知reasonCode | 文档地址：https://acquirer-api-docs-v4.pingpongx.com/notes/zh/appendix/chargebackReasonCode/，见调单类原因代码说明部分 |
| 2023年9月6日  | 新增错误码            | 错误码：108003，退款失败(退款余额不足)                                                    |
| 2023年9月8日  | 新增异步通知           | 新增异步通知：欺诈提醒通知，eventCode：NOTIFICATION_OF_FRAUD                              |
| 2023年9月12日 | 新增接口             | 新增接口：一键支付新增查询接口，接口名称：/v4/authorization/list                                |
| 2023年9月14日 | 异步通知重试规则调整       | 更新后重试间隔为 5s/5s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h                         |
| 2023年9月20日 | 新增错误码            | 错误码：107101，The transaction is closed before completing it。 交易失败(交易关单)      |