文档更新记录

约 1654 字大约 6 分钟

2025-03-07

2025年1月

发布日期发布事项内容简介

2025年1月5日

Element SDK 文档重构

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

文档重构：更新 Element SDK 集成指南至 2.0 版本
架构升级：

新增模块化架构设计（PingPongSDK、sdkController、registry、paymentService、EventHub）
支持两种业务模式：payment（下单并支付）和 codeGrant（绑定钱包）
统一的事件模型：所有支付元素支持相同的事件类型（ready、success、error、cancel、click）

新增功能：

支持 Apple Pay、Google Pay、PayPal 三种支付方式
支持营销活动配置（payDiscount 参数）
完整的初始化流程和支付流程时序图

文档优化：

添加完整的代码示例（HTML/CSS/JavaScript）
详细的 API 参数说明
10个常见问题解答
版本历史记录

文档路径：/notes/zh/integrate/sdk-elements/

2025年1月6日

SDK v4.2 接口参数优化

参数调整：优化 PingPong.Checkout.create 接口参数
删除参数：

删除 goodsName - 商品名称
删除 goodsDesc - 商品描述

新增参数：

新增 goods - 商品列表数组，包含 description、imgUrl、name、number、sku、unitPrice、virtualProduct 等字段

功能增强：

updateCheckoutHook 支持更新 goods 参数
添加商品信息动态更新示例

文档优化：

统一代码示例风格，移除特殊标记
更新完整示例代码配置

文档路径：/notes/zh/integrate/sdk-v4-2/

2025年10月

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

2025年9月

发布日期发布事项内容简介

2025年9月11日

/v4/payment/unifiedPay接口响应参数新增

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

新增字段：为微信小程序支付新增extraParam响应参数
包含参数：

wxTimeStamp
wxNonceStr
wxPackage
wxSignType
wxPaySign

2025年9月11日

内嵌SDK功能增强

新增参数：

useTabMode - 当商户仅有卡支付时可隐藏选项框

新增事件：

ready - 初始化成功事件
error - 初始化失败事件

2025年8月

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

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。交易失败(交易关单)