Release Notes

This topic records the changes that are made to Alipay+ Merchant-presented Mode Payment and User-presented Mode Payment products since the baseline version 1.0.0.

Version 1.5.5

Release date: 2024/10/31

Document improvements

Corrected the description for the settlementAmountValue field in the Transaction Detail Report.
Added precision and length requirements for the quotePrice parameter in the pay, userInitiatedPay, and refund APIs.

Version 1.5.3

Release date: 2024/06/28

Document improvements

Corrected the descriptions for the transactionCurrency fields in the reconciliation reports to clarify that their values correspond to the payToAmount.currency parameter instead of paymentAmount.currency in the pay API. For more information, see Reports.

Version 1.5.2

Release date: 2024/04/30

Enhanced features

Added the ability for Alipay+ MPP Server SDK to utilize HTTP proxies when making requests to retrieve code rules or perform remote QR code identification. You can configure the HTTP proxies by setting the following parameters:

ac.route.http.proxyHost
ac.route.http.proxyPort
ac.route.http.proxyScheme

For more information, see Alipay+ MPP Server SDK integration guide.

Version 1.5.1

Release date: 2024/02/29

Document improvements

Deleted the misrepresentation that ECC256 is a supported signature algorithm in constructing API request headers and API response headers, retaining the RSA256 algorithm, which refers to SHA256withRSA. For more information, see API Reference.

Version 1.4.2

Release date: 2023/10/31

Enhanced features

Updated Alipay+ brand mark and page detail requirements in the product introduction of User-presented Mode payment and Merchant-presented Mode Payment.

Document improvements

Added the following descriptions for displaying exchange rates to users for in-store payments. For details, see the respective Page detail requirements sections for User-presented Mode Payment and Merchant-presented Mode Payment.

The exchange rates are not always greater than or equal to 1.
The order currency can be displayed either before or after the user's payment currency.

Similar descriptions are also added to the quoteCurrencyPair and quotePrice fields because exchange rates are transmitted via API in the preceding formats. For more information, see API Reference.

Added a note that all amount values in the reconciliation reports are provided in the smallest unit of the corresponding currency without decimal places. For more information, see Reports and reconciliation tasks.

Version 1.4.1

Release date: 2023/08/31

Enhanced features

For Alipay+ Server SDK:

Added support for configuring the log path (specified by the ac.log.path property) and provided a sample Log4j2 configuration file for it. For more information, see Server SDK integration guide and Log file locations.
Deprecated the two modes of initiating the SDK (specified by the ac.route.init-route-config-level property): REMOTE and STORAGE, keeping PRESET only. For more information, see Server SDK integration guide.
Renamed the log keyword name from [AC_SDK][REMOTE_IDENTIFY_RESULT_IS_INVALID] to [AC_SDK][INVALID_REMOTE_IDENTIFICATION_RESULT]. For more information, see Troubleshooting.

Document improvements

Removed the value U from the value list of the paymentResult.resultStatus parameter in the notifyPayment API.

Version 1.4.0

Release date: 2023/07/17

New features

Added Alipay+ availability notification functionality that enables the MPP to inform the users of Alipay+ availability when the user is abroad in a location where Alipay+ is available. For more information, see Notify users of Alipay+ availability.
Added the ability for the MPP to obtain logos of acceptance marks. For more information, see Obtain logos of acceptance marks in the User-presented Mode Payment integration guide and Render the Scan page in the Merchant-presented Mode Payment integration guide.
Added the CANCEL_WINDOW_EXCEED result code for you to specify the scenario where the cancelation failed because the cancelation window is closed. For more information, see the cancelPayment API specification.

Enhanced features

Updated the page detail requirements for User-Presented Mode Payment as follows and user experience design accordingly. For more information, see the User-Presented Mode Payment product introduction.

Added requirements for displaying the brand mark and the acceptance mark on the Payment Code page.
Added an upgraded version of the Payment Code page where the region selector and exchange rate are displayed. If the number of regions/countries takes up over two mobile screens, the regions/countries must be listed alphabetically.
Added the requirement that the payment amount and order amount must be both displayed on the Payment Result page.
Added the favorable exchange rate provided by Alipay+ on the Payment Result page.
Removed options to use a button or a dropdown list as an entry to switch to the Alipay+ code on the Payment Code page.

Updated the page detail requirements for Merchant-presented Mode Payment as follows and user experience design accordingly. For more information, see the Merchant-presented Mode Payment product introduction.

Added requirements for displaying acceptance marks on the Scan page.
Added the favorable exchange rate provided by Alipay+ on the Payment Confirmation page and Payment Result page.
Added the requirement that the payment amount and order amount must both be displayed on the Payment Result page.

Document improvements

Updated the Reconcile documentation as follows to improve accuracy and consistency:

Corrected the field name feeSettleAmountValue to feeSettlementAmountValue in the sample fee reports of the Fee Report topic.
Unified the service fee rates to 1% and interchange fee rates to 3% in the sample reconciliation reports of the Perform reconciliation and Reports topics.

Removed the authExpiryTime parameter from the response of the pay API specification.

Version 1.0.1

Release date: 2023/06/30

Enhanced features

Upgraded Alipay+ Server SDK in the following aspects:

Added the ac.route.mode property to enable the switch between the production environment and the acceptance testing environment.
Added the following 4 properties to ensure that the SDK calls the Alipay+ server to identify the code and decode the code value.

ac.route.remote-identify-url
ac.route.http.identify.socket-timeout
ac.route.http.identify.connect-timeout
ac.route.http.identify.connection-request-timeout

Added the log keyword [AC_SDK][REMOTE_IDENTIFY_RESULT_IS_INVALID] for troubleshooting when integrating the SDK.

For more information, see the Alipay+ Server SDK reference.