Alipay+ DocsAlipay+ Docs

Merchant-presented Mode Payment

Version: 1.9.1

Release date: 2026/05/13

  • Upgraded the Alipay+ MPP Client SDK version. For more information, refer to SDK Reference.

Version: 1.9.0

Release date: 2026/02/28

    • 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 in the Merchant-presented Mode Payment scenario for details.

Version: 1.8.9

Release date: 2026/02/25

  • Added a note to the MPP highlighting the requirement to support multiple currencies for transactions within a single country.
  • Corrected sample code errors in the CodeIdentificationService#identifyCode API of the Alipay+ MPP Server SDK.

Version: 1.8.8

Release date: 2025/10/31

Version: 1.8.7

Release date: 2025/08/29

  • Added iTest, iMock, iNotify, and iScan tools in Alipay+ Developer Center for MPPs.
  • Removed the inquiryCodeRules API.
  • Added a requirement 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.

Version: 1.8.6

Release date: 2025/02/30

  • Updated the example explanations in the Send a response section in Sign a request and validate the 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.

Version: 1.8.5

Release date: 2024/12/31

  • Removed the description that codeValue is an API idempotency field in the userInitiatedPay 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.8.4

Release date: 2024/10/31

Version: 1.8.2

Release date: 2024/06/28

Version: 1.8.1

Release date: 2024/04/30

  • 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

Version: 1.8.0

Release date: 2024/02/29

  • Updated the supported signature algorithm in constructing API request headers and API response headers to the RSA256 algorithm, which refers to SHA256withRSA. For more information, refer to API Reference.
  • Updated the integration of Merchant-presented Mode Payment (MPM) as follows:
    • Added the actionForm object to the userInitiatedPayAPI, 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:
    • Updated the definitions of the payCompletionHandle parameter in the decode API of Alipay+ Client SDK. For more information, see either of the following documents:

Version: 1.7.0

Release date: 2023/10/31

  • 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:

Version: 1.6.0

Release date: 2023/08/31

  • 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.
  • Added the acDecodeConfig response parameter to the CodeIdentificationService#identifyCode API.

Version: 1.5.0

Release date: 2023/06/30

  • 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.
  • 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.

Version: 1.4.0

Release date: 2023/04/28

  • 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:

Version: 1.3.0

Release date: 2023/02/28

  • 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 specification and User-presented Mode Payment integration guide.
  • Modified the maximum length of the order.merchant.referenceMerchantId and order.merchant.store.referenceStoreId parameters in the pay and userInitiatedPay APIs from 64 characters to 32 characters.
  • Updated the code rule to identify EMV codes in the Merchant-presented Mode Payment scenario. For more information, refer to Merchant-presented Mode Payment.

Version: 1.2.0

Release date: 2022/12/30

Version: 1.1.1

Release date: 2022/10/28

Version: 1.1.0

Release date: 2022/08/31

  • 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.
  • Removed the following response parameters from the userInitiatedPay API:
    • order.goods.goodsBrand
    • order.merchant.store.storeOperatorId
    • order.merchant.store.storePhoneNo
    • merchant
    • paymentCurrency
    • Value STORE_CODE of the codeType parameter

Version: 1.0.0

Release date: 2022/07/29

  • Released the Merchant-presented Mode Payment product.

Learn more about

Home
Get Support
Need more help?