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

API change history

2020.11

Modifications

  • For alipay.overseas.secmerchant.online.maintain, modified the registration_no and contact_no fields from Optional to Required.

2020.10

Modifications

  • Added a new API alipay.acquire.refund.query. The API lists is also updated.
  • For alipay.overseas.secmerchant.offline.maintain, modified the register_address and registration_no fields from Optional to Required.

2020.04

Modifications

  • Added RSA2 as the supported value to sign_type in the following APIs:
    • mobile.securitypay.pay
  • Added order_create and updated the description of timeout_rule in the following APIs:
    • create_forex_trade_wap

2019.12

Modifications

  • Deleted payment_inst of Asynchronous response in the following APIs:
    • create_forex_trade
    • create_forex_trade_wap
    • mobile.securitypay.pay

2019.10

Modifications

Modified the description of the trans_currency field of the following APIs:

  • alipay.acquire.precreate
  • alipay.commerce.qrcode.create

2019.09

Modifications

  • 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:
    • create_forex_trade
    • create_forex_trade_wap
    • mobile.security.pay
  • The value of sign_type field is changed to RSA, RSA2, or MD5 for all APIs, except for mobile.securitypay.pay.

2019.06

Modifications

alipay.overseas.secmerchant.maintain.queryStatus: modified the value of store_status field to ARCHIVED, ACTIVATED, or INACTIVATE.

2019.05

Modifications

alipay.acquire.precreate: added a new parameter of qr_code_it_b_pay, and updated the it_b_pay parameter.

2019.04

Modifications

Added the trade_information field and its sub fields to the following APIs:

  • alipay.acquire.overseas.spot.pay
  • alipay.acquire.precreate

alipay.overseas.secmerchant.online.maintain: 

  • Added the service of modifying the registed information of secondary merchants.
  • Modified the length of the shareholder_name and representative_name parameters to 64 bytes.
  • Modified the following required parameters to optional parameters:
    • registration_no
    • representative_name
    • representative_id
    • settlement_no
    • contact_no
    • contact_email
  • Added the following error codes:
    • BUSINESS_NAME_UPDATE_FORBIDDEN
    • REGISTRATION_NO_UPDATE_FORBIDDEN
    • REGISTER_COUNTRY_UPDATE_FORBIDDEN
    • MERCHANT_TYPE_UPDATE_FORBIDDEN
    • REPRESENTATIVE_NAME_UPDATE_FORBIDDEN
    • REPRESENTATIVE_ID_UPDATE_FORBIDDEN

alipay.overseas.secmerchant.offline.maintain:

  • Added the function of modifying the registed information of secondary merchants.
  • Modified the length of the shareholder_name and representative_name parameters to 64 bytes.
  • Modified the following required parameters to optional parameters:
    • registration_no
    • register_address
    • representative_name
    • representative_id
    • settlement_no
    • contact_no
    • contact_email
  • Added the following error codes:
    • BUSINESS_NAME_UPDATE_FORBIDDEN
    • REGISTRATION_NO_UPDATE_FORBIDDEN
    • REGISTER_COUNTRY_UPDATE_FORBIDDEN
    • MERCHANT_TYPE_UPDATE_FORBIDDEN
    • REPRESENTATIVE_NAME_UPDATE_FORBIDDEN
    • REPRESENTATIVE_ID_UPDATE_FORBIDDEN

For the alipay.overseas.secmerchant.maintain.queryStatus (online) and alipay.overseas.secmerchant.maintain.queryStatus (offline) interfaces, the updates are as follows:

  • Added the following parameters in synchronous response:
    • payment_method
    • partner
    • secondary_merchant_name
    • secondary_merchant_type
    • secondary_merchant_industry
    • registration_no
    • register_country
    • register_address
    • shareholder_name
    • shareholder_id
    • representative_name
    • representative_id
    • settlement_no
    • contact_no
    • contact_email
    • cs_no
    • cs_email
    • site_infos
  • Modified the description of the status parameter.