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_info:  terminal_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.query, registerAddress 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 S 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.pay, mobile.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