Alipay+ DocsAlipay+ Docs

User-presented Mode Payment

Version: 1.9.1

Release date: 2026/05/13

    • env.terminalType
    • env.osType
    • env.clientIp
    • env.cookieId
    • env.userAgent

Version: 1.9.0

Release date: 2026/02/28

Version: 1.8.6

Release date: 2026/02/25

  • Added a note to the MPP highlighting the requirement to support multiple currencies for transactions within a single country.

Version: 1.8.5

Release date: 2025/10/31

Version: 1.8.4

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 about code refreshing in the User-presented Mode Payment. For more information, refer to User-presented Mode Payment.

Version: 1.8.3

Release date: 2025/02/30

Version: 1.8.1

Release date: 2024/06/28

    • otpVerification
    • authorizationInfo
    • paymentFactor.isAuthorizationAndPay
    • paymentFactor.isAuthorizationPayment
    • paymentFactor.isDeferredPayment
    • paymentFactor.needCheckCompliance
    • paymentFactor.needOtpVerification
    • paymentFactor.isCrossborderSettlement

Version: 1.8.0

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

Version: 1.7.0

Release date: 2023/10/31

  • Added a limitation for the MPP to verify the paymentCodeRegion parameter in the pay API for the User-presented Mode Payment scenario.
  • Updated Alipay+ brand mark and page detail requirements in the User-presented Mode payment scenario.
  • Added a requirement about displaying exchange rates to users for in-store payments. For more information, refer to the Page detail requirements section in User-presented Mode Payment.

Version: 1.6.0

Release date: 2023/08/31

  • Added a requirement that MPPs need to display the merchant name in multiple languages on the Payment Result page and the Transaction Detail page for User-presented Mode Payment.

Version: 1.5.0

Release date: 2023/06/30

  • Added the ability for the MPP to obtain logos of acceptance marks. For more information, see Obtain logos of acceptance marks.
  • Updated the page detail requirements for User-Presented Mode Payment as follows and user experience design accordingly. For more information, refer to User-Presented Mode Payment:
    • 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.
    • 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.
    • Removed options to use a button or a dropdown list as an entry to switch to the Alipay+ code on the Payment Code 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:
  • Added the paymentCodeRegion child parameter to the paymentMethod.paymentMethodMetaData parameter for the pay API.

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.

Version: 1.2.0

Release date: 2022/12/30

  • Provide accelerated domain names to enable faster access to Alipay+ APIs. For more information, see Environment.
  • Added the following page detail requirements for the MPPs in the User-presented Mode Payment scenario:
    • 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.

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.

Version: 1.0.0

Release date: 2022/07/29

  • Released the User-presented Mode Payment product.

Learn more about

Home
Get Support
Need more help?