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
- Alipay Europe Customer Wallet Terms & Conditions and Alipay Europe Customer Wallet Privacy Notice are updated. For more information, see Alipay Europe Customer Wallet Terms & Conditions and Alipay Europe Customer Wallet Privacy Notice.
- Statistic Q4 2020 is provided. For more information, see Alipay Europe PSD2 API.
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
- For Sandbox:
- Updated the links of Alipay Sandbox Development Portal and Alipay Sandbox Global Mercahnt Portal.
- Removed the video.
API
- For alipay.overseas.secmerchant.online.maintain in AlipayHK API, modified the
registration_no
andcontact_no
fields from Optional to Required. - For create_forex_trade_wap_cn, added the following parameter:
- Request parameter: order_create
- For alipay.overseas.secmerchant.offline.maintain, modified the
operation_id
andcontact_person
fields from Required to Optional.
October 30
Explore Alipay October 2020 release notes to have an overview of key updates.
API
- For forex_rate_file, added the following parameter:
- Request parameter:
_input_charset
- For single_trade_query, removed the following transaction status:
- 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
- For alipay.intl.merchant.common.indirectMerchant.maintain (for offline payments), modified the
registrationAddress
field from Optional to Required. - For alipay.overseas.secmerchant.offline.maintain, modified the
register_address
field from Optional to Required. - For alipay.overseas.secmerchant.offline.maintain in AlipayHK API, modified the
register_address
andregistration_no
fields from Optional to Required.
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:
- For General Reference, removed the Getting support section.
- For Auto-debit Payment- Reconciliation file content, updated the description of Transaction file and Settlement file.
- Updated the client-side DEMO&SDK download link in Cross-border APP Payment.
API
- For alipay.dut.customer.agreement.page.sign, added the following parameters:
- Asynchronous response parameters:
notify_time
,notify_type
, andnotify_id
.
- Modified the
notify_url
field from Optional to Required for the following interfaces:
- Modified the
registration_no
andcontact_no
fields from Optional to Required for the following interfaces:
- For alipay.acquire.overseas.spot.pay, add a new parameter
terminal_create_time
inextend_info
.
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
- For alipay.system.oauth.token, added the following parameters:
- Request parameters:
app_id
,method
,format
,charset
,sign_type
,sign
,timestamp
,version
andapp_auth_token
. - Response parameters:
code
,msg
,sub_code
,sub_msg
, andsign
.
- Added Chinese version doc for the alipay.acquire.refund.query API.
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 oftimeout_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
- Added a topic General Reference- Refund that focuses on both synchronous and asynchronous refunds.
- For General Reference- Digital signature, added how to generate RSA/RSA2 keys by using openssl.
- Added rules about refund request frequency in the refund flows of WAP/WEB payment products.
- For Third-party Merchant QR Code Payment, removed the Testing credentials section.
API
- Added a new API: Alipay global heartbeat interface
- For alipay.acquire.overseas.spot.pay, updated the length and format of
trans_create_time
andterminal_create_time
. - Added rules about the length and contents of
secondary_merchant_id
andstore_id
in the following APIs:
- For alipay.overseas.secmerchant.offline.maintain,
registration_no
is now Required. - For alipay.acquire.precreate (for transaction QR code payment), removed
notify_action_type
from the asynchronous response. - For alipay.intl.acquiring.offline.pay, removed error codes
OAUTH_FAILED
,CLIENT_FORBIDDEN_ACCESS_API,
SIGN_TYPE_NOT_SUPPORT
,MERCHANT_HAS_REGISTER
, andUSER_BALANCE_PAY_OFF
. - For alipay.intl.acquiring.offline.payQuery, alipay.intl.acquiring.common.refund, and alipay.intl.acquiring.common.payCancel, removed error codes
OAUTH_FAILED
,CLIENT_FORBIDDEN_ACCESS_API,
SIGN_TYPE_NOT_SUPPORT
, andMERCHANT_HAS_REGISTER.
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
andlast_payment_info
. - For alipay.acquire.overseas.spot.pay, added two sub-fields for
entend_info
:terminal_create_time
andlast_payment_info
; removed theextra_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
andIssue
. - For HK in-store payment settlement file, added fields
Secondary_merchant_id
andIssue
, removed fieldsRmb_amount
,RMB_settlement
, andRate
.
API
- For alipay.acquire.overseas.spot.pay, under
extend_info
, added subfieldsterminal_create_time
andlast_payment_info
. - For alipay.intl.acquiring.offline.pay,under
extend_info
, added subfieldsstoreTerminalRequestTime
andlast_payment_info
.
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
toreturn_amount
and modifiedtotal_amount
tototal_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
- Modified the value of
result_code
from FAIL to FAILED in alipay.acquire.overseas.spot.refund. - Modified
split_fund_info
from Required to Optional in create_forex_trade_wap. - Deleted
payment_inst
of Asynchronous response in the following APIs:
- Modified
notifyUrl
from Optional to Required in alipay.intl.acquiring.offline.pay.
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.
- Added the new production gateway URL(https://globalmapi.alipay.com/gateway.do) in the following APIs:
- alipay.acquire.overseas.spot.pay
- alipay.acquire.precreate (for third-party QR code payment)
- alipay.acquire.precreate (for transaction QR code payment)
- alipay.acquire.create
- alipay.commerce.qrcode.create
- alipay.commerce.qrcode.modify
- alipay.commerce.qrcode.modifyStatus
- alipay.system.oauth.token
- alipay.acquire.cancel
- alipay.acquire.overseas.spot.refund
- alipay.acquire.overseas.query
- alipay.overseas.secmerchant.offline.maintain
- alipay.overseas.secmerchant.maintain.queryStatus
- 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
- Added the
notify_url
field to alipay.acquire.overseas.spot.pay. - Modified the
isSync
field of alipay.intl.acquiring.common.refund from Required to Optional, and the description was updated. - Added information about the minimum value of the
expiryTime
field of alipay.intl.acquiring.offline.preCreate (for transaction QR code payment). - Modified the description of the
trans_currency
field of the following APIs:
- alipay.commerce.qrcode.create
- alipay.acquire.precreate (for third-party QR code payment)
- alipay.acquire.precreate (for transaction QR code payment)
- alipay.commerce.qrcode.modify
- alipay.acquire.create
- alipay.acquire.overseas.query
- alipay.acquire.precreate (HK wallet)
- alipay.commerce.qrcode.create (HK wallet)
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
andnotify_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
, andsecondary_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:
API
- The value of
secondary_merchant_name
,secondary_merchant_type
,registration_no
,register_country
,representative_name
, andrepresentative_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:
- alipay.acquire.overseas.spot.pay
- alipay.acquire.precreate (for third-party QR code payment)
- alipay.acquire.precreate (for transaction QR code payment)
- alipay.acquire.create
- create_forex_trade
- create_forex_trade_wap
- mobile.securitypay.pay
July 15
Product
Deleted information about sandbox reconciliation files.
API
- Added the
notify_sign_type
field to the alipay.commerce.qrcode.modify interface. - Updated the service addresses for the following interfaces:
- alipay.intl.acquiring.offline.pay
- alipay.intl.acquiring.offline.payQuery
- alipay.intl.acquiring.common.refund
- alipay.intl.acquiring.common.payCancel
- alipay.intl.merchant.common.monitor
- alipay.intl.merchant.common.indirectMerchant.maintain (for online payments)
- alipay.intl.merchant.common.indirectMerchant.maintain (for offline payments)
- alipay.intl.merchant.common.indirectMerchant.archive
- alipay.intl.merchant.common.indirectMerchant.query
- alipay.intl.acquiring.offline.preCreate (for third-party QR code payment)
- alipay.intl.acquiring.offline.preCreate (for transaction QR code payment)
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:
- alipay.overseas.secmerchant.maintain.queryStatus
- alipay.overseas.secmerchant.maintain.queryStatus (HK)
June 15
Product
Added the following in-store payment docs:
- Added best practice
- Modified the SFTP host information
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:
- alipay.acquire.precreate (for transaction QR code payment): Added a new parameter qr_code_it_b_pay, and updated the description of the it_b_pay parameter.
- alipay.acquire.precreate (for AlipayHK transaction QR code payment): Added a new parameter qr_code_it_b_pay, and updated the description of the it_b_pay parameter.
- alipay.intl.acquiring.common.refund: Changed the length of the
refundreason
parameter from 512 to 256.
May 15
Product
Added Chinese version docs for online payment products, including:
- Cross-border Website payment - CN
- Cross-border WAP payment - CN
- Cross-border In-App payment - CN
- Customs Declaration - CN
API
The following APIs are updated:
- alipay.acquire.overseas.spot.refund: Added an error code
BUYER_NOT_EXIST
; added async notification - forex_refund: Added an error code
BUYER_NOT_EXIST
- alipay.intl.acquiring.offline.pay: Removed the
buyerId
field
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