---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/appendix/docUpdateRecord/index.md
description: >-
  The document update record lists the payment API and SDK updates for each
  month of 2025, including new API endpoint addresses, optimized unified order
  and face-to-face payment interface parameters, additional WeChat Mini Program
  payment response parameters, and enhanced embedded SDK functionality.
---
## January 2025
| Release Date | Release Item | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|-------------|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| January 5, 2025 | Element SDK Documentation Refactoring | **Documentation Refactoring**: Updated Element SDK integration guide to version 2.0**Architecture Upgrade**:<ul><li>New modular architecture design (PingPongSDK, sdkController, registry, paymentService, EventHub)</li><li>Supports two business models: payment (order creation and payment) and codeGrant (wallet binding)</li><li>Unified event model: All payment elements support the same event types (ready, success, error, cancel, click)</li></ul>**New Features**:<ul><li>Support for three payment methods: Apple Pay, Google Pay, PayPal</li><li>Support for marketing campaign configuration (payDiscount parameter)</li><li>Complete initialization flow and payment flow sequence diagrams</li></ul>**Documentation Optimization**:<ul><li>Added complete code examples (HTML/CSS/JavaScript)</li><li>Detailed API parameter descriptions</li><li>10 frequently asked questions</li><li>Version history</li></ul>**Documentation Path**: `/en/notes/integrate/sdk-elements/` |
| January 6, 2025 | SDK v4.2 Interface Parameter Optimization | **Parameter Adjustment**: Optimized PingPong.Checkout.create interface parameters**Removed Parameters**:<ul><li>Removed `goodsName` - Product name</li><li>Removed `goodsDesc` - Product description</li></ul>**New Parameters**:<ul><li>Added `goods` - Product list array, containing fields such as description, imgUrl, name, number, sku, unitPrice, virtualProduct</li></ul>**Feature Enhancement**:<ul><li>`updateCheckoutHook` supports updating goods parameters</li><li>Added dynamic product information update example</li></ul>**Documentation Optimization**:<ul><li>Unified code example style, removed special markings</li><li>Updated complete example code configuration</li></ul>**Documentation Path**: `/en/notes/integrate/sdk-v4-2/` |

## October 2025
| Release Date | Release Item | Description                                                                                                                                                                                                                                                                                                |
|-------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| October 31, 2025 | New API Endpoint Address Documentation | **New Documentation**: Added "API Endpoint Addresses" documentation in development guide**Main Content**:<ul><li>Site architecture explanation (Online Business/Terminal Business/Merchant Backend)</li><li>Three major site domain configurations (FRA/SG/US)</li><li>Site selection principles (based on merchant entity registration location)</li><li>Site data interoperability explanation (FRA↔SG interoperable, US independent)</li></ul>**Documentation Path**: `/en/notes/guide/endpoint/`                                                                                         |
| October 13, 2025 | Unified Order Interface Parameter Optimization | **Customer Information Field Extension**: Added payment-related fields in customer object**Included Fields**:<ul><li>`accountNumber` - Bank account number</li><li>`domesticCardNumber` - Domestic card number</li><li>`domesticCardIssuingDate` - Domestic card issuing date</li><li>`domesticCardExpireMonth` - Domestic card expiry month</li><li>`domesticCardExpireYear` - Domestic card expiry year</li></ul>**Field Optimization**: Removed duplicate merchantUserId field, simplified field descriptions |
| October 13, 2025 | Face-to-Face Payment Interface Parameter Optimization | **Payment Method Clarification**: Updated paymentMethod field description**Supported Methods**:<ul><li>`Card Purchase` - Card swipe payment</li><li>`QR-POSScan` - B-scans-C payment</li><li>`QR Payment` - C-scans-B payment</li><li>`Octopus` - Octopus card swipe payment (Hong Kong)</li></ul>                                                                                                                     |

## September 2025
| Release Date | Release Item | Description                                                     |
|-------------|--------------------|---------------------------------------------------------|
| September 11, 2025 | /v4/payment/unifiedPay interface response parameter addition | **New Field**: Added extraParam response parameter for WeChat Mini Program payment**Included Parameters**:<ul><li>`wxTimeStamp`</li><li>`wxNonceStr`</li><li>`wxPackage`</li><li>`wxSignType`</li><li>`wxPaySign`</li></ul> |
| September 11, 2025 | Embedded SDK Function Enhancement | **New Parameters**:<ul><li>`useTabMode` - Can hide option box when merchant only has card payment</li></ul>**New Events**:<ul><li>`ready` - Initialization success event</li><li>`error` - Initialization failure event</li></ul> |

## August 2025
| Release Date | Release Item | Description                                                     |
|-------------|--------------------|---------------------------------------------------------|
| August 28, 2025 | WeChat Mini Program Payment Feature Launch | **New Payment Method**: Officially launched WeChat Mini Program payment feature**Feature Characteristics**:<ul><li>Supports payment scenarios within WeChat Mini Programs</li><li>Complete payment process and parameter examples</li><li>Dedicated technical documentation and integration guide</li></ul> |

## June 2024 (Professional API Documentation Launch)
| Release Date | Release Item | Description                                                      |
|-----------|--------|-----------------------------------------------------------|
| June 8, 2024 | New Version Documentation Release | The new version documentation provides more precise categorization of document product functions and optimizes document content for easier developer access. Subsequent version updates will be based on the new version documentation |

## December 2023
| Release Date | Release Item | Description                               |
|-------------|-----------------------|------------------------------------|
| December 1, 2023 | Dispute Process Flowchart Update | Replaced the flowchart                             |
| December 12, 2023 | 3DS Enumeration Value Change in Asynchronous Notifications and Transaction Query Interfaces | 3DS enumeration value change in asynchronous notifications and transaction query interfaces, enumeration values changed from numbers to uppercase letters |
| December 13, 2023 | New JS-SDK-2.0 Documentation | /                                  |
| December 14, 2023 | New JS-SDK-2.0 Debugging Tool | /                                  |
| December 15, 2023 | Adjusted Country Code/Transaction Currency List, Added Chinese Translation Column | /                                  |
| December 21, 2023 | Dispute Added Exception Code | UploadFileNumMaxError, indicating `file exceeds maximum quantity` |

## November 2023
| Release Date | Release Item | Description                                       |
|-------------|-------------------------------|--------------------------------------------|
| November 16, 2023 | Dispute Active Retrieval of Chargeback Details and Dispute Details Return Processing Deadline Format Adjustment | Format updated from YYYY/MM/DD to yyyy-MM-dd HH:mm:ss     |
| November 22, 2023 | Risk Management Section Adjustment | (1) Dispute section integrated into risk management section; (2) Added SecureShieldJs component to risk control components |

## October 2023
| Release Date | Release Item | Description                          |
|-------------|-----------|-------------------------------|
| October 12, 2023 | New Error Codes | Added error codes: 301021, 301022, see Appendix Status Code Table for details |
| October 23, 2023 | Transaction Reconciliation Interface Removal | Added SFTP reconciliation service                    |

## September 2023
| Release Date | Release Item | Description                                                                       |
|------------|------------------|----------------------------------------------------------------------------|
| September 5, 2023 | New Product Documentation | Added offline barcode payment product documentation, documentation URL: https://acquirer-api-docs-v4.pingpongx.com/en/notes/onlinePayment/offlineBarcodePayment/ |
| September 5, 2023 | New Chargeback Notification reasonCode | Documentation URL: https://acquirer-api-docs-v4.pingpongx.com/en/notes/appendix/chargebackReasonCode/, see chargeback reason code description section |
| September 6, 2023 | New Error Codes | Error code: 108003, refund failed (insufficient refund balance)                                                    |
| September 8, 2023 | New Asynchronous Notification | Added asynchronous notification: fraud alert notification, eventCode: NOTIFICATION_OF_FRAUD                              |
| September 12, 2023 | New Interface | Added interface: one-click payment query interface, interface name: /v4/authorization/list                                |
| September 14, 2023 | Asynchronous Notification Retry Rule Adjustment | After update, retry intervals are 5s/5s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h                         |
| September 20, 2023 | New Error Codes | Error code: 107101, The transaction is closed before completing it. Transaction failed (transaction closed)      |