Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

      Release notes

      #V13.16

      Release Date: 2021-3-31


      Enhanced features

      • Removed the error code ​MCC_CAN_NOT_MODIFY​ for the following docs:


      #V13.15

      Release Date: 2021-1-29


      Enhanced features


      #December 31

      Explore Alipay December 2020 release notes to have an overview of key updates.


      API

      • Modified the contact_no field from Required to Optional for the following interfaces:


      #November 30

      Explore Alipay November 2020 release notes to have an overview of key updates.


      Product

        • Updated the links of Alipay Sandbox Development Portal and Alipay Sandbox Global Mercahnt Portal.
        • Removed the video.


      API

        • Request parameter: order_create


      #October 30

      Explore Alipay October 2020 release notes to have an overview of key updates.


      API

        • Request parameter: _input_charset
        • Transaction status: WAIT_SELLER_SEND_GOODS, WAIT_BUYER_CONFIRM_GOODS, SYS_CONFIRM_PAY, WAIT_SYS_PAY_SELLER, TRADE_REFUSE, TRADE_REFUSE_DEALING, TRADE_CANCEL, TRADE_PENDING, TRADE_SUCCESS, BUYER_PRE_AUTH, COD_WAIT_SELLER_SEND_GOODS, COD_WAIT_BUYER_PAY, COD_WAIT_SYS_PAY_SELLER


      #September 28

      Explore Alipay July to September 2020 release notes to have an overview of key updates.


      Product

      • Updated the "Properly use Alipay interfaces" process in Best practice topic for the following documents:


      API

        • Asynchronous response parameters: notify_time, notify_type, and notify_id.
      • Modified the notify_url field from Optional to Required for the following interfaces:
      • Modified the registration_no and contact_no fields from Optional to Required for the following interfaces:


      #June 24

      Explore Alipay June 2020 release notes to have an overview of key updates.


      Product

      Updated the "Obtaining the user ID by using auth_code" process in Third-party Merchant QR Code Payment.


      API

        • Request parameters: app_id, method, format, charset, sign_type, sign, timestamp, version and app_auth_token.
        • Response parameters: code, msg, sub_code, sub_msg, and sign.


      #June 05

      Explore Alipay May and early June 2020 release notes to have an overview of key updates.


      Product

      • Updated the demo download link in AlipayHK - SDK.
      • Updated the description of status in the Transaction File Format documents of the following product:
      • Updated the Getting support document.
      • Updated the method to obtain reconciliation files in sandbox document in Services & Tools. It is clear now that file download in the Alipay global portal (Sandbox environment) is not available.


      API

      • Updated the description of trade_status_error in alipay.acquire.customs API.
      • Updated the description of price in the following documents:
      • Added a new API alipay.acquire.refund.query in both Global API and AlipayHK API. The API lists of the respective products are also updated.


      #April 29

      Explore Alipay April 2020 release notes to have an overview of key updates.


      Product

      • Released a new product document Alipay Checkout.
      • Updated the Demo & SDK download link and the corresponding integration details for the following documents:


      API

      • Added RSA2 as the supported value to sign_type in the following APIs:
      • For alipay.dut.customer.agreement.unsign, added information about the asynchronous response. 
      • Added order_create and updated the description of timeout_rule in the following APIs:
      • Updated the enum of Site in the following APIs:


      #March 20

      Explore Alipay March 2020 release notes to have an overview of key updates.


      Product


      API

      #

      #February 21

      Explore Alipay February 2020 release notes to have an overview of key updates.


      API

      • Removed an API: alipay.intl.merchant.common.indirectMerchant.maintain (for online payments)
      • For alipay.intl.acquiring.offline.pay, added two sub-fields for extendInfo: storeTerminalRequestTime and last_payment_info.
      • For alipay.acquire.overseas.spot.pay, added two sub-fields for entend_infoterminal_create_time and last_payment_info; removed the extra_common_param field from the Asynchronous response

      For alipay.intl.merchant.common.indirectMerchant.maintain (for offline payments), and alipay.intl.merchant.common.indirectMerchant.queryregisterAddress is changed to registrationAddress


      #

      #January 21

      Explore Alipay January 2020 release notes to have an overview of key updates.


      Product

      • Added Chinese version doc for Barcode payment.
      • Updated Digital Signature topic to add information about how to exchange RSA2 key with Alipay and remove DSA related information.
      • For HK in-store payment transaction file, added fields Secondary_merchant_id and Issue.
      • For HK in-store payment settlement file, added fields Secondary_merchant_id and Issue, removed fields Rmb_amount, RMB_settlement, and Rate.


      API




      #December 30

      Explore Alipay Developer December 2019 release notes to have an overview of key updates.


      Product

      • Added a Trade status topic and updated related docs.
      • Added an API idempotency topic and updated related docs.
      • Modified refund_amount to return_amount and modified total_amount to total_fee in Split Detail Info for the following docs:
      • Added the Before you begin section to clarify that the H5 page must be loaded before obtaining Alipay user ID for Third-party Merchant QR Code Payment.
      • Added the Reconciliation files section in Sandbox.
      • For transaction file viewed on Alipay global open platform, when a refund is successfully processed, the value of status is changed from P to in the following docs:


      API


      #November 26

      Explore Alipay Developer November 2019 release notes to have an overview of key updates.


      API

      • Removed the forex_compare_file and forex_liquidation_file APIs. If you need information about these two APIs, contact Alipay technical support.
      • Updated the description of product_code for the following APIs to clarify that this field is not required for the old cross-border website payment product. Contact technical support if you are not sure about your product type.
      • Modified the notifyUrl field of alipay.intl.acquiring.offline.pay from Optional to Required.


      #October

      Explore Alipay Developer October 2019 release notes to have an overview of key updates.

      #October 31

      Product

      • Updated the System interaction flow for Transaction QR code (new)
      • Updated the Demo & SDK download link and the corresponding integration details for the following documents:


      API

      • Deleted out_biz_no field in the following APIs:
      • Updated the description of is_success for the following APIs:
      • Updated asynchronous responses handling for the following APIs:



      #October 15

      Product

      The following fields were changed from Required to Optional for the file content of Settlement File - Detail:

      • remark
      • conversionRate
      • conversionRateRelation


      API

      #

      #September 12

      Explore Alipay Developer September 2019 release notes to have an overview of key updates.


      Product

      For the transaction file of online payment products (web payment, in-app payment, and wap payment), the status value is updated to be either P (transaction succeeds) or L (transaction liquidated). 


      API

      • Added the is_show_memo and notify_charset fields to the following APIs:
      • The value of sign_type field is changed to RSA, RSA2, or MD5 for all APIs, except for mobile.securitypay.paymobile.security.pay (HK wallet), and APIs of Barcode Payment (New), Transaction QR Code Payment (New), and Third-party Merchant QR Code Payment (New).
      • For the following APIs, the secondary_merchant_name, secondary_merchant_id, and secondary_merchant_industry fields are required for acquirers and system integrators with secondary merchants, and are not required for merchants that are directly integrated with Alipay:


      #August 15

      Explore Alipay Developer August 2019 release notes to have an overview of key updates.


      Product

      The sandbox address for checking the transaction and settlement information is updated to https://globalprod.alipaydev.com/transaction/fpSeniorTransInfo.htm


      Split Detail Info for the Chinese documentation of the following products are updated: 

      Cross-border Website Payment 

      Cross-border WAP Payment 

      Cross-border APP Payment 


      API

      • The value of secondary_merchant_name, secondary_merchant_type, registration_no, register_country, representative_name, and representative_id fields of the secondary merchant registration interfaces cannot be modified once specified. Now this restriction is cancelled. The secondary merchant registration interfaces include:
      • Added an error code MORE_THAN_ALLOW_REFUND_FOREX_FEE to the forex_refund interface.


      #July

      Explore Alipay Developer July 2019 release notes to have an overview of key updates.

      #July 31

      Product

      Added or updated the following docs:

      • Added Integration Guide.
      • For Transaction file - detail, the length of orderTitle is changed from 64 to 256.
      • For both online and in-store payment products, updated the information on how to obtain reconciliation files in product/sandbox environment.
      • For online payment products, updated the reconciliation file information:
        • For the settlement file, added a stem_from field.
        • For the transaction file, updated the enum value of the status field.


      API

      Added error codes SECONDARY_MERCHANT_ID_BLANK, SECONDARY_MERCHANT_ID_INVALID, and SECONDARY_MERCHANT_STATUS_ERROR to the following APIs:



      #July 15

      Product

      Deleted information about sandbox reconciliation files.


      API

      #

      #June

      Explore Alipay Developer June 2019 release notes to have an overview of key updates.

      #June 29

      Product

      For Reconciliation files, specified the generation time of transaction files.


      API

      Modified the value of store_status field to ARCHIVED, ACTIVATED, or INACTIVATE for the following interfaces:



      #June 15

      Product

      Added the following in-store payment docs:

      For Barcode Payment (New):

      For Cross-Border In-App Payment:

      • Modified the Demo&SDK download link


      #May

      Explore Alipay Developer May 2019 release notes to have an overview of key updates.

      #May 31

      Product

      Updated the following docs:

      • Digital signature: Two versions of signature specification are provided
      • Reconciliation files: Updated the description of settlement day and settlement cycle
      • iValidate: Added the scenario of online payment
      • iDiagnose: Added a new error code INVALID_PARAMETER


      API

      The following APIs are updated:


      #May 15

      Product

      Added Chinese version docs for online payment products, including:


      API

      The following APIs are updated:

      #

      #April 

      Explore Alipay Developer April 2019 release notes to have an overview of key updates.

      #April 30

      Product

      For new barcode payment, the files for reconciliation are updated. See transaction detail, settlement detail, and settlement summary for details. 


      API

      The following APIs are newly added for indirect merchant information management:

      • alipay.intl.merchant.common.importIndirectMerchant (for online payments)
      • alipay.intl.merchant.common.indirectMerchant.maintain (for offline payments
      • alipay.intl.merchant.common.indirectMerchant.archive
      • alipay.intl.merchant.common.indirectMerchant.query

      For alipay.intl.acquiring.offline.pay, the seller field is changed from Required(C) to Required(Y).

      See New API - API updates for details.



      #April 8

      Platform

      A new version of Alipay Global Open Platform is released on Apr 8th. Technical documentation on original portal https://global.alipay.com/service is merged to this new platform for a better user experience. You can go to Documentation > Developer (https://global.alipay.com/open/doc.htm) to view details. 


      API

      Due to compliance requirements, the following APIs are updated:

      • create_forex_trade
      • create_forex_trade_wap
      • mobile.securitypay.pay
      • alipay.acquire.createandpay
      • alipay.acquire.overseas.spot.pay
      • alipay.acquire.precreate
      • alipay.overseas.secmerchant.online.maintain
      • alipay.overseas.secmerchant.offline.maintain
      • alipay.overseas.secmerchant.maintain.queryStatus