# Release Notes ## Version 1.7.2 Release date: 2026/05/13 ### New features - Upgraded the version of Alipay+ MPP Client SDK to 1.11.0. - [iOS SDK](../sdk_mpp/ios_overview): - Added the _title_ parameter to the **launch** API, which enables the MPP to customize the navigation bar title of the merchant H5 page. - Upgraded the SDK build baseline to support Xcode 26. - [Android SDK](../sdk_mpp/android_overview): - Added the _title_ parameter to the **launch** API, which enables the MPP to customize the navigation bar title of the merchant H5 page. - Added support for Android 16. ## Version 1.7.1 Release date: 2026/04/27 ### New Features - Published the Alipay+ NFC Payment documentation publicly for all customers as a standard product. For more information, see [Alipay+ NFC Payment Product Introduction](../product_intro_mpp/product_nfc). ### Document improvements - Added supported discount details to the Merchant-presented Mode Payment and User-presented Mode Payment product introductions. For more information, see the [Merchant-presented Mode Payment Product Introduction](../product_intro_mpp/product_mpm_mpp) and the [User-presented Mode Payment Product Introduction](../product_intro_mpp/product_upm_mpp). - Removed the following optional parameters from the [getPaymentCode](../api_mpp/get_payment_code) API. - _env.terminalType_ - _env.osType_ - _env.clientIp_ - _env.cookieId_ - _env.userAgent_ ## Version 1.7.0 Release date: 2026/02/28 ### New Features - Removed special reporting and settlement requirements for AlipayCN. Accordingly, the related notes have been removed from the [reconcile overview](../reconcile_mpp/reconcile_overview) topic. - Added the _indirectMpp_ parameter to the following APIs: - [getPaymentCode](../api_mpp/get_payment_code) - [userInitiatedPay](../api_mpp/pay_private_order_code) - [applyToken](../api_mpp/apply_token) ### Document improvements - In the [Merchant-presented Mode Payment](../product_intro_mpp/product_mpm_mpp) product introduction: - Added the Back to Merchant page UI sample to the _User experience_ and _Payment Result Page_ section. - Updated the description of the Return button on the Payment Result Page to include design guidance for the merchant redirect URL. - Corrected the order code and entry code workflow figures and corresponding steps. - Clarified that the MPP must obtain any required licenses (for example, an ICP license) for the domain name used in the Chinese mainland, rather than specifying ICP as the only required license. See [Make a payment](../integration_merchant_mode_mpp/accept_payments) in the Merchant-presented Mode Payment scenario for details. ## Version 1.6.0 Release date: 2026/02/25 ### Document improvements - Added a note to the MPP highlighting the requirement to support multiple currencies for transactions within a single country. ## Version 1.5.12 Release date: 2025/12/31 ### Document improvements - Added instructions about configuring log monitoring in the Alipay+ MPP Client SDK (iOS and Android). For more information, see the following documents: - [Quick Start](../sdk_mpp/android_quick) (Alipay+ MPP Android SDK) - [Quick Start](../sdk_mpp/ios_quick) (Alipay+ MPP iOS SDK) - Optimized the description for the Transaction No. in the _Transaction Detail Page_ section of the Cashier Payment, Auto Debit, User-presented Mode Payment, and Merchant-presented Mode Payment product introduction. - Corrected sample code errors in the [CodeIdentificationService#identifyCode](../sdk_mpp/identify_code) API of the Alipay+ MPP Server SDK. ## Version 1.5.11 Release date: 2025/10/31 ### Document improvements - Added error codes for Alipay+ MPP Client SDK (iOS and Android). For more information, see the following documents: - [Error Codes](../sdk_mpp/error_code_android) (Alipay+ MPP Android SDK) - [Error Codes](../sdk_mpp/error_code_ios) (Alipay+ MPP iOS SDK) - Added a note about the display logo size. For more information, see the following documents: - [User-presented Mode Payment](../product_intro_mpp/product_upm_mpp) - [Merchant-presented Mode Payment](../product_intro_mpp/product_mpm_mpp) ## Version 1.5.10 Release date: 2025/08/29 ### New Features - Added iTest, iMock, iNotify, and iScan tools in Alipay+ Developer Center for MPPs. ## Version 1.5.9 Release date: 2025/06/30 ### Document improvements - Added a note about setting _configuration.envType_ to `PROD` in sandbox for the Alipay+ MPP Client SDK (iOS and Android). - Added information about the privacy manifest file location in the Alipay+ MPP Client SDK (iOS). ## Version 1.5.8 Release date: 2025/04/30 ### Document improvements - Removed the _inquiryCodeRules_ topic from the _API Reference_ section. - Added a note explaining that MPP needs to support aggregated code if it wants to support Merchant-presented Mode Payment in the Chinese mainland. For more information, see [Make a payment](../integration_merchant_mode_mpp/accept_payments). - Added a note about code refreshing in the User-presented Mode Payment. For more information, see [User-presented Mode Payment](../product_intro_mpp/product_upm_mpp). ## Version 1.5.7 Release date: 2025/02/30 ### Document improvements - Updated the example explanations in the _Send a response_ section in [Sign a request and validate the signature](../api_mpp/signature). - Added information about QR code requirements and the URL encoded format during the Merchant-presented Mode Payment integration. For more information, see [Make a payment](../integration_merchant_mode_mpp/accept_payments). - Added requirements about the access token when MPPs provide the access token to bind the user account in Auto Debit. For more information, see [Bind the user account](../integration_auto_debit_mpp/account_binding). ## Version 1.5.6 Release date: 2024/12/31 ### Document improvements - Added notes to explain that Participant ID and _participantId_ refer to Partner ID. - Removed the description that _codeValue_ is an API idempotency field in the [**userInitiatedPay**](https://docs.alipayplus.com/alipayplus/alipayplus/api_mpp/pay_private_order_code.md) API because the same codeValue can be used in different payment orders, and instead, added the description that the value of the response parameter _paymentRequestId_ is unique for each payment order. If the MPP receives payment orders with the same _paymentRequestId_, the MPP must regard them as repeated and process them only once. ## Version 1.5.5 Release date: 2024/10/31 ### Deprecated features - Removed support for using Alipay+ code rules locally to identify Alipay+ code in the Cashier Payment scenario. The [Cashier Payment integration guide](../integration_cashier_mpp/identify_code) is updated accordingly. ### Document improvements - Corrected the descriptions for the [CodeIdentificationService#identifyCode](../sdk_mpp/identify_code) API of Alipay+ MPP Server SDK as follows: - Corrected the request parameter name from _CodeIdentificationIdentifyRequest_ to _CodeIdentificationRequest_ and the response parameter name from _CodeIdentificationIdentifyResult_ to _CodeIdentificationResult_. - Removed _openId_ from the request parameter list. - Removed the following unused request parameters from the [**pay**](../api_mpp/pay) API reference: - _otpVerification_ - _authorizationInfo_ - _paymentFactor.__isAuthorizationAndPay_ - _paymentFactor.__isAuthorizationPayment_ - _paymentFactor.__isDeferredPayment_ - _paymentFactor.__needCheckCompliance_ - _paymentFactor.__needOtpVerification_ - _paymentFactor.__isCrossborderSettlement_ - Corrected the calculation formula for _refundFromAmount_ and _surchargeAmount_ values in the [**refund**](../api_mpp/refund) API. - Refined the description for the _refundPromoInfo.refundPromoDetails.refundAmount_ parameter in the [**refund**](../api_mpp/refund) API to clarify the unrefunded amount for full refund and partial refund. - Added precision and length requirements for the _quotePrice_ parameter in the [**pay**](../api_mpp/pay), [**userInitiatedPay**](../api_mpp/pay_private_order_code), and [**refund**](../api_mpp/refund) APIs. - Corrected the description for the _settlementAmountValue_ field in the [Transaction Detail Report](../reconcile_mpp/trans_detail). - Updated the description for Object Identification Number. For more information, see [Code Format Specification-Collection code](../code_scanning_payment_standards_mpp/code_format#Tr6Vv). - Optimized the [Partner services FAQ](../faq_mpp/partner_services) section in the following aspects: - Added several FAQs. - Removed outdated FAQs. - Updated and refined answers to some FAQs. - Added a navigation menu on each page to facilitate easy access to specific FAQs. ## Version 1.5.4 Release date: 2024/08/30 ### Document improvements - Fixed some minor errors in the [reconciliation reports' naming convention descriptions](../reconcile_mpp/trans_detail). ## Version 1.5.3 Release date: 2024/06/28 ### Enhanced features - Added the _ac.route.preset-file-path_ component property to the Alipay+ MPP Server SDK for customizing the path of the local backup file, which stores the code rules. For more information, see [Alipay+ MPP Server SDK quick start](../sdk_mpp/server_quick). ### Document improvements - Updated the download file for the [Alipay+ Brand Mark Assets](../brand_guidelines_mpp/brand_assets) and the user experience images in the [Product Introductions](https://docs.alipayplus.com/alipayplus/mpp_payment_product_overview_1.5.3) with the latest Alipay+ logo. - 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](../reconcile_mpp/trans_detail). - Corrected the instruction on obtaining the payment result notification URL in Cashier Payment to clarify that it is returned by Alipay+ in the **userInitiatedPay** API response instead of the **pay** API response. And added another way to obtain the URL. For more information, see [Receive the notification URL](../integration_cashier_mpp/notify_payment_result#Rigpa). - Added the following risk management FAQs: - [What should I do to become an Alipay+ Partner?](../faq_mpp/risk_management#AZGh2) - [What are the payment risk management requirements for a Mobile Payment Partner?](../faq_mpp/risk_management#sSDZb) - Optimized the [Integration and acceptance FAQ](../faq_acq/integration) section in the following aspects: - Removed outdated FAQs. - Updated and refined answers to some FAQs. - Added a navigation menu on each page to facilitate easy access to specific FAQs. ## 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 quick start](../sdk_mpp/server_quick). ### Document improvements - Refined the description of the _paymentFactor.isCashierPayment_ parameter in the [**userInitiatedPay**](../api_mpp/pay_private_order_code) API. - Added release notes for Alipay+ MPP Client SDK and Alipay+ MPP Server SDK. For more information, see the following documents: - [Release notes for Alipay+ Server SDK](../sdk_mpp/release_note_server) - [Release notes for Alipay+ Client SDK (iOS)](../sdk_mpp/release_note_client_ios) - [Release notes for Alipay+ Client SDK (Android)](../sdk_mpp/release_note_client_android) ## Version 1.5.1 Release date: 2024/02/29 ### Enhanced features - Modified the maximum length of the _codeValue_ parameter in the [prepare](../api_mpp/prepare) API from 64 characters to 2048 characters. ### 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](../api_mpp/api_overview). - Reorganized the [Before you begin](../integration_auto_debit_mpp/account_binding#spR3v) section in the Bind the user account chapter of the Auto Debit integration guide to make it more logical. - Added an FAQ specifying the usage of the API endpoint in both the production and sandbox environments. For more information, see [Integration and acceptance](../faq_mpp/integration_and_acceptance#iCi3B). ## Version 1.5.0 Release date: 2023/12/29 ### Enhanced features - Updated the integration of Merchant-presented Mode Payment (MPM) as follows: - Added the _actionForm_ object to the [**userInitiatedPay**](../api_mpp/pay_private_order_code) API, which contains the _actionForm.actionType_ and _actionForm.sdkActionPayload_ parameters. - Added the **handleAction** API to the Alipay+ Client SDK. For more information, see either of the following documents: - [iOS](../sdk_mpp/ios_handle_action) - [Android](../sdk_mpp/android_handle_action) - Updated the definitions of the _payCompletionHandle_ parameter in the **decode** API of Alipay+ Client SDK. For more information, see either of the following documents: - [iOS](../sdk_mpp/ios_decode) - [Android](../sdk_mpp/android_decode) - Updated the workflow and detailed steps for integrating the MPM product. For more information, see [Merchant-presented Mode Payment](../integration_merchant_mode_mpp). ### Document improvements - Split the Workflow section in the [Merchant-presented Mode Payment](../integration_merchant_mode_mpp) integration guide into Entry code and Order code to improve readability. ## Version 1.4.2 Release date: 2023/10/31 ### Enhanced features - Added the **preload** API to the Alipay+ MPP Client SDK, which enables page loading acceleration for Merchant-presented Mode Payment. To utilize the preload API, you need to integrate components in your SDK. For more information, see: - Android SDK: [preload](../sdk_mpp/android_preload) and [Add SDK to your project](../sdk_mpp/android_quick#OuLLW) - iOS SDK: [preload](../sdk_mpp/ios_preload) and [Add SDK to your project](../sdk_mpp/ios_quick#qAnN0) - Added a limitation for the MPP to verify the _paymentCodeRegion_ parameter in the [**pay**](../api_mpp/pay) API for the User-presented Mode Payment scenario. - Updated Alipay+ brand mark and page detail requirements in the product introduction of [User-presented Mode payment](../product_intro_mpp/product_upm_mpp) and [Merchant-presented Mode Payment](../product_intro_mpp/product_mpm_mpp). - Changed the e-mail address for Alipay+'s after-sales service from connect\_support@service.alipay.com to overseas\_support@service.alibaba.com. ### 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](../product_intro_mpp/product_upm_mpp#eBdwz) and [Merchant-presented Mode Payment](../product_intro_mpp/product_mpm_mpp#dFmig). - 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](../api_mpp/api_overview). - 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](../reconcile_mpp/reconcile_overview#b7GmN). ## Version 1.4.1 Release date: 2023/08/31 ### Enhanced features - Added a requirement that MPPs need to display the merchant name in multiple languages on the Payment Confirmation page, the Payment Result page, and the Transaction Detail page for [Merchant-presented Mode Payment](../product_intro_mpp/product_mpm_mpp), and on the Payment Result page and the Transaction Detail page for [User-presented Mode Payment](../product_intro_mpp/product_upm_mpp). - Added the sandbox report directories to the [Download reports](../reconcile_mpp/download_report) chapter in _Reconcile_. - Added the _acDecodeConfig.params_ request parameter to the **launch** API, which is used in the Merchant-presented Mode Payment scenario. Of which, _forceHttps.acDecodeConfig.params_ can be used to require Alipay+ MPP Client SDK to redirect the user to the merchant page via an HTTPS URL by replacing `http://` with `https://` in case of an HTTP URL. - For Alipay+ Server SDK: - Added the _acDecodeConfig_ response parameter to the [CodeIdentificationService#identifyCode](../sdk_mpp/identify_code) API. - Added the following four component properties in integrating the SDK: - ac.route.remote-identify-url - ac.route.http.identify.socket-timeout - ac.route.http.identify.connect-timeout - ac.route.http.identify.connection-request-timeout For more information, see [Quickstart](../sdk_mpp/server_quick). - Added the log keyword \[AC\_SDK\]\[INVALID\_REMOTE\_IDENTIFICATION\_RESULT\] for troubleshooting. For more information, see [Troubleshooting](../sdk_mpp/server_troubleshooting). - Added the _codeRules.extendInfo_ response parameter to the [inquiryCodeRules](../api_mpp/inquiry_code_rules) API in _API Reference_. ### Document improvements - Removed the value `U` from the value list of the _paymentResult.resultStatus_ parameter in the [notifyPayment](../api_mpp/notify_payment) API. ## Version 1.4.0 Release date: 2023/06/30 ### 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](../integration_merchant_mode_mpp/notify_availability). - Added the ability for the MPP to obtain logos of acceptance marks. For more information, see [Obtain logos of acceptance marks](../integration_user_mode_mpp/accept_payments#sSldM) in the _User-presented Mode Payment integration guide_ and [Render the Scan page](../integration_merchant_mode_mpp/accept_payments#zXq8J) 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_mpp/cancel_payment) 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_intro_mpp/product_upm_mpp) _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_intro_mpp/product_mpm_mpp) _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**. ### Deprecated features - Removed support for using Alipay+ code rules locally to identify Alipay+ code in the Merchant-presented Mode Payment scenario. The [_Merchant-presented Mode Payment integration guide_](../integration_merchant_mode_mpp/) is updated accordingly. ### Document improvements - Updated the [Reconcile](../reconcile_mpp/how_to_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_mpp/pay) API specification. ## Version 1.3.0 Release date: 2023/04/28 ### New features - Added support for account binding by scanning a QR code rendered on the merchant Web page in the Auto Debit scenario. To support this feature, added the _codeValue_ and _codeExpireTime_ parameters to the [prepare](../api_mpp/prepare) API. For more information, see the following topics: - [Auto Debit user experience](../product_intro_mpp/product_debit_mpp#rhyRd) - [Bind the user account](../integration_auto_debit_mpp/account_binding) - Added the `REGULATION_RESTRICTION` result code for you to specify the scenario where the payment failed due to regulatory restriction. For more information, see the following API specifications: - [pay](../api_mpp/pay) - [inquiryPayment](../api_mpp/inquiry_payment) - [notifyPayment](../api_mpp/notify_payment) - Added the _paymentCodeRegion_ child parameter to the _paymentMethod.paymentMethodMetaData_ parameter for the [pay](../api_mpp/pay) API. ### Enhanced features - Changed the _openId_ parameter in the [CodeIdentificationService#identifyCode](../sdk_mpp/identify_code) API from Required to Optional. - Changed the maximum length of the _customerBelongsTo_ parameter in the [prepare](../api_mpp/prepare) API from 16 to 32 characters. - Updated the Alipay Server SDK in the following aspects: - Changed the mode of initiating the SDK (specified by the _ac.route.init-route-config-level_ property) from `REMOTE` or `STORAGE` to `PRESET`. For more information, see [Quickstart](../sdk_mpp/server_quick). - Added support for configuring the log path (specified by the _ac.log.path_ property). For more information, see [Log file locations](../sdk_mpp/location). ### Document improvements - Updated the [Idempotency](../api_mpp/idempotency) topic in the _API reference_ to include key parameters that are checked for consistency in idempotency control. - Added the [Timeout](../api_mpp/timeout) topic to the _API reference_ to introduce the timeout values set by Alipay+ for each API request and how to set the timeout value when calling Alipay+. - Added the _How are the different amounts calculated_ section to illustrate how Alipay+ calcluates different amounts in the following API specifications: - [userInitiatedPay](../api_mpp/pay_private_order_code) - [refund](../api_mpp/refund) - Added the [Support Alipay+ marketing activities](../best_practice_mpp/support_marketing_activities) topic to the _Best practices_ guide to introduce how to handle marketing information and support Alipay+ in performing risk evaluation. - Refined the workflow diagram of making a payment and its description in the Cashier Payment integration guide. For more information, see [Make a payment](../integration_cashier_mpp/make_payment#TKrkm). ## Version 1.2.1 Release date: 2023/02/28 ### New features - Released the **getPaymentCode** API for MPPs to obtain payment codes from Alipay+ in the User-presented Mode Payment scenario. For more information, see the [getPaymentCode](../api_mpp/get_payment_code) API specification and [User-presented Mode Payment](../integration_user_mode_mpp) integration guide. ### Enhanced features - Modified the maximum length of the _order.merchant.referenceMerchantId_ and _order.merchant.store.referenceStoreId_ parameters in the [pay](../api_mpp/pay) and [userInitiatedPay](../api_mpp/pay_private_order_code) APIs from 64 characters to 32 characters. - Updated the code rule to identify EMV codes in the Cashier Payment and Merchant-presented Mode Payment scenarios. For more information, see the following documents: - [Cashier Payment](../integration_cashier_mpp/identify_code#XnYbI) - [Merchant-presented Mode Payment](../integration_merchant_mode_mpp/alipayplus_code_rules#XnYbI) ### Document improvements - Corrected the endpoint of the **inquiryCodeRules** API from `/aps/api/v1/payments/inquiryCodeRules` to `/aps/api/v1/codes/inquiryCodeRules`. For more information, see the [inquiryCodeRules](../api_mpp/inquiry_code_rules) API specification. - Added a note in the _Reconcile_ documentation to emphasize that Alipay+ reports prevail when discrepancies exist due to payment status inconsistencies between the MPP system and the Alipay+ system. For more information, see [Process overview](../reconcile_mpp/how_to_reconcile#YN0ye) of the _Perform reconciliation_ topic. - Added troubleshooting instructions about signature validation to the message transmission section of the [FAQ](../faq_mpp/integration_and_acceptance) documentation. - Removed the enumeration value `MINI_APP` from the _terminalType_ parameter in the [prepare](../api_mpp/prepare) API specification because currently authorization cannot be initiated via mini apps. ## Version 1.2.0 Release date: 2022/12/30 ### New features - Provide accelerated domain names to enable faster access to Alipay+ APIs. For more information, see [Environment](../api_mpp/api_overview#bfZS0). ### Enhanced features - Added page detail requirements for the MPPs in the product introductions for [User-presented Mode Payment](../product_intro_mpp/product_upm_mpp) and [Merchant-presented Mode Payment](../product_intro_mpp/product_mpm_mpp), specifically: - For Merchant-presented Mode Payment: Added the design requirements and suggestions for the **Payment confirmation page**, **Payment result page**, and **Transaction Detail page**. - For User-presented Mode Payment: - Added the design requirements and suggestions for the **Alipay+ payment code page**, **Payment result page**, and **Transaction Detail page**. - Added optional design standards in terms of country/region list display, QR code and barcode design, screen brightness, and dropdown list design of the Alipay+ QR code entrance. - Removed the User Experience Guidelines because the content is merged into product introductions. - A new set of design requirements and suggestions for the **Transaction Detail Page** is added for Cashier Payment and Auto Debit. For more information, see the Page detail requirements of the product introductions for [Cashier Payment](../product_intro_mpp/product_cashier_mpp) and [Auto Debit](../product_intro_mpp/product_debit_mpp). - Changed the _order.merchant.merchantDisplayName_ parameter in the [pay](../api_mpp/pay) and [userInitiatedPay](../api_mpp/pay_private_order_code) APIs from Optional to Required. - Removed the value `OTHER` from the _osType_ parameter in the [prepare](../api_mpp/prepare) API. - Updated the Alipay+ MPP Android SDK as follows: - Added the _siteName_ parameter to the public class [_Configuration_](../sdk_mpp/android_appendix#HoRJF). - Added the _authSuccessScopes_ and _authErrorScopes_ parameters to the public class [_CommonOAuthServiceResult_](../sdk_mpp/android_appendix#jFKzK) to better indicate the authorization result. - Updated the samples in the [setConfiguration](../sdk_mpp/android_get_configuration) and [getAuthCode](../sdk_mpp/android_get_auth_code) APIs accordingly. - Updated the Alipay+ MPP iOS SDK as follows: - Added the _siteName_ parameter to the public class [_MPPConfiguration_](../sdk_mpp/ios_appendix#HoRJF). - Added the _authSuccessScopes_ and _authErrorScopes_ parameters to the public class [_MPPCommonOAuthServiceResult_](../sdk_mpp/ios_appendix#jFKzK) to better indicate the authorization result. - Updated the samples in the [setConfiguration](../sdk_mpp/ios_get_configuration) and [getAuthCode](../sdk_mpp/ios_get_auth_code) APIs accordingly. ### Document improvements - Added the Get Started document to guide the MPPs through the integration and acceptance guide. For more information, see [Get started with Alipay+ integration](../get_started_mpp). - Updated the integration guides of the following payment products: - [Cashier Payment](../integration_cashier_mpp/) - Updated the workflow diagram for making a payment and integration steps. - Updated the code identification step to make it clearer and more accurate. Specially: - Refined the process flow diagram and its description. - Removed the Allowlist solution and Blocklist solution sections, which are deprecated for the Cashier Payment product. - Reorganized and improved the [How to identify Alipay+ codes](../integration_cashier_mpp/identify_code) chapter. - Updated the processing logic of integrating the **userInitiatedPay** API. - [Auto Debit](../integration_auto_debit_mpp) - In the [Bind the user account](../integration_auto_debit_mpp/account_binding) topic, clarified the integration methods that are available for different terminal types of the MPP client. - Updated the workflow diagrams for account binding and unbinding steps. - Reorganized the table of contents to make it clearer and easy to find. - Removed the topics about providing user information in certain conditions. If you need these topics, contact the Alipay+ Solution Architect. - [Merchant-presented Mode Payment](../integration_merchant_mode_mpp) - Updated the workflow diagram to better describe the payment workflow. - Divided the original Identify the code section into two substeps: Filter the code and Identify the code, to better describe the process. - Removed the specification documentation of the **inquiryUserInfo** and **inquiryCustomerId** APIs from the Alipay+ Document Center. If you need to implement these APIs to provide user information, contact the Alipay+ Solution Architect. - Added an [Integration and acceptance](../faq_mpp/integration_and_acceptance) chapter to the FAQ. - Updated the Reconcile documentation as follows: - Added an introduction about Banker's rounding. For more information, see [Banker's rounding](../reconcile_mpp/bank_rounding). - Improved the description of the _settlementAmountValue_ parameter and the _feeSettlementAmountValue_ parameter to clarify how they are calculated. ## Version 1.1.2 Release date: 2022/10/28 ### New features - Released the documentation that provides guidance for MPPs on how to display Alipay+ brand-related elements on digital user interfaces before, during, and after the payment is processed by Alipay+ Core. For more information, see [Brand Display Guidelines for Alipay+ Core MPP Integration](../brand_guidelines_mpp/mpp_integration). ### Document improvements - Updated the definition of the following terms: Acquiring Service Provider (ACQP), Mobile Payment Provider (MPP), and Common Business Day. For more information, see [Glossary](../glossary/v1). ## Version 1.1.1 Release date: 2022/09/30 ### New features - Added a new domain name (https://open-na.alipayplus.com) for Alipay+ APIs. Now there are two domain names for you to select. For more information, see [API reference](../api_mpp/api_overview#bfZS0). ### Document improvements - Updated the product introduction for Auto Debit and Cashier Payment. Now the product introduction includes a new section, Page detail requirements, which replaces the UX design guidelines provided in the User Experience Guidelines. For more information, see Product Introduction for [Auto Debit](../product_intro_mpp/product_debit_mpp) and [Cashier Payment](../product_intro_mpp/product_cashier_mpp). - Updated the integration document of the payment products: - Improved the Reconcile section in that: - Optimized the Overview topic to include information about some basic concepts about reconciliation. - Added a topic Perform reconciliation to introduce a step-to-step guide on how to do reconciliations. - Updated the samples and the description of the parameters in each financial report. For more information, see [Reconcile](../reconcile_mpp/reconcile_overview). - Replaced the Post payment section with two new sections, Return payment results and Cancel or refund a payment for the integration document of Auto Debit, Cashier Payment, User-presented Mode Payment, and Merchant-presented Mode Payment. The new sections explain the related topics in an optimized method. ## Version 1.1.0 Release date: 2022/08/31 ### New features - Upgraded the Alipay+ MPP Client SDK. The new SDK features broader applicability, higher security, and faster response, and is well-documented and open-sourced to MPPs who have signed NDAs with Alipay+. For more information, see [Alipay+ MPP Client SDK](../sdk_mpp/client). - Accordingly, the following documents are updated: - [Auto Debit integration guide](../integration_auto_debit_mpp/integration) - [Cashier Payment integration guide](../integration_cashier_mpp/integration) - [Merchant-presented Mode Payment integration guide](../integration_merchant_mode_mpp/integration) - [User-presented Mode Payment integration guide](../integration_user_mode_mpp/integration) - [Alipay+ Center Integration Guide](../alipayplus_center/integration) - [Alipay+ MPP Server SDK](../sdk_mpp/server_overview) - Meanwhile, Alipay+ continues to maintain the older SDK edition. MPPs that have integrated the older SDK edition are not impacted. For more information, see [Alipay+ client SDK integration guide](../sdk_mpp/client?role=MPP&product=Payment1&version=1.0.0). ### Enhanced features The redirection-back from an MPP app to the merchant WAP page for Cashier Payment is now properly supported, so relevant modifications are made. For details, see [Guide on redirections between the merchant and the Mobile Payment Partner](../best_practice_mpp/redirection_guide_mpp) and [Cashier Payment](../integration_cashier_mpp). ### Document improvements - Added the FAQ documentation for MPPs, containing frequently asked questions about Alipay+ risk management and partner services. For more information, see [FAQ](../faq_mpp). - Removed the **inquiryRiskScore** API from the API Reference documentation and [Auto Debit](../integration_auto_debit_mpp/payment_processing) integration guide. - Removed the SDK download addresses from the SDK Reference documentation. You can contact the Alipay+ Solution Architect to obtain SDK packages. - Removed the following parameters from the API reference. > **Note**: This change is backward compatible. - From the request parameters of the [pay](../api_mpp/pay) API: - _order.goods.goodsBrand_ - _order.merchant.store.storeOperatorId_ - _order.merchant.store.storePhoneNo_ - From the response parameters of the [pay](../api_mpp/pay) API: - _paymentAmount_ - _payToAmount_ - From the response parameters of the [userInitiatedPay](../api_mpp/pay_private_order_code) API: - _order.goods.goodsBrand_ - _order.merchant.store.storeOperatorId_ - _order.merchant.store.storePhoneNo_ - _merchant_ - _paymentCurrency_ - Value `STORE_CODE` of the _codeType_ parameter - From the response parameters of the [inquiryPayment](../api_mpp/inquiry_payment) API: _paymentRequestId_ ## Version 1.0.0 Release date: 2022.07.29 > **Important**: > > Since 2022/07/29, the Alipay+ Document Center has been restructured to provide you with a better user information experience in the following terms: > > - **Centralized content reading**: You can select the role and the product that you want to explore to enter a dedicated content domain. > - **Better navigation experience**: Horizontal tab navigation plus vertical navigation allows you to find the information more easily and quickly; the aggregated overview page for each tab guides you through the important content that Alipay+ provides to you; quick entry provided for you to arrive at the API and SDK reference in one step. > - **Public technical content informatio**n: Since this version, most of the documentation on the Alipay+ Documentation Center has been disclosed to all users except for the following three books: > > - Rules > - Operation guides > - Alipay+ Partner Workspace User Guide > > - **Standardized version control**: Alipay+ supports you in switching the version as you require. > - **Optimized content structure**: The content structure of the integration guides is restructured to allow you to find the product introduction, and the content about reconciliation more conveniently. In addition, the product introduction and the integration guides for the Online Payment are also refined to improve the content quality. > - **Useful support information**: Find the support information at the footer if you need any help with technical issues or business operations. ### Other document improvements - Removed the **registration** and **notifyRegistrationStatus** APIs from the API Reference (MPP) documentation. If you need to implement the merchant registration capability, contact the Alipay+ Solution Architect. # History for previous updates > **Note**: Starting from 2022/07/29, the Alipay+ documentation is restructured to support version control. The following list describes important updates to our documentation before this date. ## July 15 2022 ### New features Released new features to support MPPs in adopting two modes for merchant registration: Reporting Mode and Approval Mode. This leads to the following document updates: - Added an integration guide on merchant registration for MPPs. For more information, see [Register a merchant](../registration_mpp/merchant_registration). - Added the [notifyRegistrationStatus](../api_mpp/notify_registration_status) API in the API Reference (MPP) documentation. - Updated the [registration](../api_mpp/registration) API in the API Reference (MPP) documentation as follows: - Added the `REGISTRATION_In_PROCESS` result code and the description about when to use it in the More information section. - Updated the result message for the `SUCCESS` result code. ### Enhanced features Changed the _merchantInfo.registrationDetail.registrationNo_ parameter in the [registration](../api_mpp/registration) API from `Required` to `Optional` to satisfy the needs of individual merchant registration. ## June 30 2022 ### New features Released the non-client-SDK integration solution for the Cashier Payment, Auto Debit, and Merchant-presented Mode Payment products. For more information, see the following documents: - [Cashier Payment](../integration_cashier_mpp) - [Auto Debit](../integration_auto_debit_mpp) - [Merchant-presented Mode Payment](../integration_merchant_mode_mpp) - [Server SDK for Non-Client-SDK Integration](../sdk_mpp/server_for_non_client) ### Enhanced features Updated the logic of calculating the following amounts: paymentAmount, payToAmount, and surchargeAmount. For more information, see [pay](../api_mpp/pay). ### Document improvements - Updated the API reference documentation, to make it more accurate and clear. This includes: - Added more detailed descriptions. For example, for optional request parameters, added conditions when these parameters are specified by Alipay+; for optional response parameters, added conditions when these parameters are required to be returned by the MPP. - Refined the _Result processing logic_ section for APIs that are invoked by the MPP. - Added the _How to return the result_ section for APIs that are invoked by Alipay+. - Adjusted the sequence of some parameters based on their relevance. - Fixed several errors in the sample codes. - Fixed some grammatical errors to improve readability. For more information, see [API Reference (MPP)](../api_mpp/pay). - Updated the Result codes table as follows: - Added the `NO_INTERFACE_DEF` result code for all APIs. - Added the `USER_PAYMENT_VERIFICATION_FAILED` and `MERCHANT_NOT_REGISTERED` result codes for the **pay** API. - Added the `ORDER_IS_CLOSED` result code for the **userInitiatedPay** API. - Added the `REPEAT_REQ_INCONSISTENT` result code for the **refund** and **prepare** APIs. - Deleted the `INVALID_API` result code for all APIs. - Deleted the `REPEAT_REQ_INCONSISTENT` result code for the **registration** API. - Deleted the `INVALID_CONTRACT` result code for the **responseRetrieval** API. - Updated the Payment result codes table for the **notifyPayment** and **inquiryPayment** APIs as follows: - Added the following payment result codes: - `UNAVAILABLE_PAYMENT_METHOD` - `USER_PAYMENT_VERIFICATION_FAILED` - `MERCHANT_NOT_REGISTERED` - Deleted the following 21 response parameters in the [registration](../api_mpp/registration) API while maintaining backward compatibility: - _merchantInfo.registrationDetail.attachments.attachmentType_ - _merchantInfo.registrationDetail.attachments.file_ - _merchantInfo.registrationDetail.attachments.attachmentName_ - _merchantInfo.registrationDetail.attachments.content_ - _merchantInfo.registrationDetail.attachments.contentType_ - _merchantInfo.registrationDetail.contactInfo.contactNo_ - _merchantInfo.registrationDetail.contactInfo.contactType_ - _merchantInfo.registrationDetail.registrationEffectiveDate_ - _merchantInfo.registrationDetail.registrationExpireDate__merchantInfo.merchantAddress.region_ - _merchantInfo.merchantAddress.state_ - _merchantInfo.merchantAddress.city_ - _merchantInfo.merchantAddress.address1_ - _merchantInfo.merchantAddress.address2_ - _merchantInfo.merchantAddress.zipCode_ - _merchantInfo.logo.logoName_ - _merchantInfo.logo.logoUrl_ - _storeInfo.storeContacts.fullName_ - _storeInfo.storeContacts.identificationId_ - _storeInfo.storeContacts.contactNo_ - _storeInfo.feeTier_ - Released the documentation for Alipay+ Center that contains an introduction and integration solutions for MPPs. For more information, see [Alipay+ Center](../alipayplus_center). - Updated the brand display guidelines. This includes the following documents: - [Alipay+ Fundamental Brand Guidelines](../brand_guidelines/foundational_brand). The original [Alipay+ foundational brand guidelines](../brand_guidelines_older_edition/foundational_brand) is moved to older edition documents. - [Alipay+ Brand Mark Assets](../brand_guidelines/brand_assets). This provide an entry to download the Alipay+ logo asset. - [Brand Display Guidelines for Cashier Payment](../brand_guidelines/brand_cashier_acq). This replaces the UX design guideline for Cashier Payment. - [Brand display guidelines for in-store payment](../brand_guidelines/brand_in_store_acq). This replaces the Brand display guidelines for in-store payment in [UX design guideline](../ux/acq_overview). - Changed a condition of cancelling the payment in all the integration documents for MPPs. For more information, see [Cancel the transaction](../integration_user_mode_mpp/post_payments#AVS6F) section in each integration guide for MPPs. ## May 27 2022 ### Enhanced features Added an entry to download the Alipay+ logo asset in [Alipay+ foundational brand guidelines](https://docs.alipayplus.com/alipayplus/alipayplus/brand_guidelines/foundational_brand.md) and [UX design guidelines for Mobile Payment Partners](https://docs.alipayplus.com/alipayplus/alipayplus/ux/mpp_overview.md). ### Document improvements - Updated the [client SDK interface documentation](https://docs.alipayplus.com/alipayplus/alipayplus/sdk_mpp/client_api.md) to improve accuracy in terms of parameter description. - Deleted the _scopes_ parameter from [the idempotency fields](https://docs.alipayplus.com/alipayplus/alipayplus/api_mpp/idempotency.md) table as it can not be used to control the idempotency for the **prepare** API. ## April 29 2022 ### Document improvements - Changed the accuracy of the _Request-Time_ and _Response-Time_ header fields from milliseconds to seconds. - Added the retry mechanism of the **inquiryPayment**, **cancelPayment**, and **refund** APIs in the integration guides. - Changed the refund time window from 365 days to 366 days. - Updated the values of the _scopes_ parameter in the **prepare** API. ## March 31 2022 ### New features Open sourced the Alipay+ Server SDK to MPPs who have signed NDAs with Alipay+. Added a glossary of terms that are used in Alipay+ for your convenience. For more information, see [Glossary](../glossary/v1). ### Fixed bugs Fixed the spelling of the following parameters in the Transaction Detail Report and Fee Report: - Updated _orignalTransactionRequestId_ to _originalTransactionRequestId_. - Updated _feeSettleAmountValue_ to _feeSettlementAmountValue_.