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

      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.