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

      API change history

      #2020.08.20

      #Online payments

      • For the Payment Notification interface, the result code PROCESS_FAIL, REQUEST_TRAFFIC_EXCEED_LIMIT, and PARAM_ILLEGAL are removed.
      • For the Token Application interface, the result code USER_NOT_EXIST and USER_STATUS_ABNORMAL are added.


      #In-store payments

      • For the Payment Notification interface, the result code PROCESS_FAIL, REQUEST_TRAFFIC_EXCEED_LIMIT, and PARAM_ILLEGAL are removed.


      #2020.07.30

      #Online payments

      • For the Settlement Items file, descriptions of the transactionId, originalTransactionId, and originalTransactionRequestId fields are updated for adding the auth/capture scenario.
      • For the Transaction Items file, descriptions of the transactionId, originalTransactionId, and originalTransactionRequestId fields are updated for adding the auth/capture scenario.


      #2020.06.09

      #Online payments

      • For the Access Token Application interface, the note about the extend field is deleted.
      • For the Settlement Items, Settlement Summary, and Transaction Items files, the file name for the case that no transaction exists is updated.
      • Add the following error codes for the Payment interface:
        • USER_NOT_EXIST
        • NO_PAY_OPTION
        • PAYMENT_NOT_EXIST
        • ORDER_NOT_EXIST
        • ORDER_IS_CLOSED
      • Add the following error code for the Payment Result Notification interface:
        • ORDER_IS_CLOSED
      • Add the creditPayPlan field to the following interfaces:
        • Payment (Cashier Payment)
        • Payment (Auto Debit Payment)


      #In-store payments

      • The following change is made to the Payment Result Notification:

      For a payment process with a failed or unknown status, no notification is to be returned to the merchant.

      • The following change is made to the Payment (Consumer-presented Mode Payment) interface:

      Additional instructions for the order field are provided.

      • Add the following error codes for the Payment interface:
        • USER_NOT_EXIST
        • NO_PAY_OPTION
        • PAYMENT_NOT_EXIST
        • ORDER_NOT_EXIST
        • ORDER_IS_CLOSED
      • Add the following error code for the Payment Result Notification interface:
        • ORDER_IS_CLOSED


      #2020.04.30

      #Online payments

      The settlementStrategy field is added to the following interface:

      • Payment (Cashier Payment)
      • Payment (Auto Debit Payment)


      The originalTransactionRequestId is added to the following files:

      • Settlement Items
      • Transaction Items


      #In-store payments

      The originalTransactionRequestId is added to the following files:

      • Settlement Items
      • Transaction Items


      #2020.04.17

      #Online payments & In-store payments

      The actualPaymentAmount and paymentQuote fields are removed from the following interfaces:

      • Payment (Cashier Payment)
      • Payment (Agreement Payment)
      • Payment (User-presented Mode Payment)
      • Payment (Order Code Payment)
      • Payment (Entry Code Payment)
      • Payment Result Notification
      • Payment Result Inquiry


      #In-store payments

      Description of the paymentExpiryTime field is modified for the following interfaces:

      • Payment (Order Code Payment)
      • Payment (Entry Code Payment)


      #2020.03.20

      #Online payments

      The Authorization Inquiry interface is removed.


      #2020.03.12

      #Online payments

      The following result codes were removed from the Payment Result Notification interface:

      • KEY_NOT_FOUND
      • ACCESS_DENIED
      • API_INVALID
      • CLIENT_INVALID
      • METHOD_NOT_SUPPORTED
      • MEDIA_TYPE_NOT_ACCEPTABLE


      The following changes were made to the Settlement Items file name, Settlement Summary file name, and Transaction Items file name:

      • settlementItems_<settlementCurrency>_<settlementBatchId>_<seq>.csv, was updated to settlementItems_<pspName>_<settlementCurrency>_<settlementBatchId>_<seq>.csv.
      • settlementSummary_<settlementCurrency>_<settlementBatchId>_<seq>.csv, was updated to settlementSummary_<pspName>_<settlementCurrency>_<settlementBatchId>_<seq>.csv.
      • transactionItems_<transactionCurrency>_<seq>.csv, was updated to transactionItems_<pspName>_<transactionCurrency>_<transactionDate>_<seq>.csv.


      # In-store payments

      The following result codes were removed from the Payment Result Notification interface:

      • KEY_NOT_FOUND
      • ACCESS_DENIED
      • API_INVALID
      • CLIENT_INVALID
      • METHOD_NOT_SUPPORTED
      • MEDIA_TYPE_NOT_ACCEPTABLE


      #2020.03.03

      #Online payments

      The following parameters were removed from the Payment, Payment Result Notification, Payment Result Inquiry, and Refund interfaces:

      • totalSettlementAmount
      • settlementQuote


      #In-store payments

      The following parameter was updated for the Payment, Payment Result Notification, Payment Result Inquiry, and Refund interfaces:

      • totalSettlementAmount was modified to grossSettlementAmount


      #2020.02.25

      #Online payments & In-store payments

      The following parameters were added to the response of Payment, Payment Result Inquiry, and Refund interfaces:

      • totalSettlementAmount
      • settlementQuote

       

      The following parameters were added to the request of Payment Result Notification interface:

      • totalSettlementAmount
      • settlementQuote


      The following parameters were added to the request of Payment Result Inquiry interface:

      • paymentResultCode
      • paymentResultMessage
      • transaction

       

      #2020.02.06

      #Online payments & In-store payments

      The following changes were made to the request of Settlement Items, Settlement Summary, and Transaction Items:

      • partnerId: modified to customerId
      • extendInfo: removed

       

      #2020.02.04

      #Online payments & In-store payments

      The following changes were made to the request of Payment interface:

      • merchant: removed
      • env: removed
      • order: its sub fields were updated in the following ways:
        • Added the merchant field
        • Added the env field


      #2020.01.20

      #In-store payments

      The Entry Code Payment is added to in-store payments.

       

      #2020.01.15

      #Online payments & In-store payments

      The following changes were made to the request of Payment interface:

      • paymentVerificationData:  the length of this field is changed to /
      • merchant: added a note to state that the sub-field merchant.merchantName must be required for in-store payments

       

      #2019.12.30

      #Online payments & In-store payments

      The following changes were made to the request of Payment interface:

      • merchant: added 
      • env: added
      • order: its sub fields were updated in the following ways:
        • Removed the merchant field
        • Removed the env field

       

      #2019.12.25

      #In-store payments

      The following change was made to the request of Payment interface:

      • paymentNotifyUrl: updated to mandatory

       

      #2019.12.20

      #Online payments & In-store payments

      The extendInfo field is removed from all the following interfaces:

      • Payment (Cashier Payment)
      • Payment (User-presented Mode Payment)
      • Payment (Order Code Payment)
      • Payment Result Notification
      • Payment Result Inquiry
      • Payment Cancellation
      • Refund
      • Authorization Consult
      • accessToken Application
      • Authorization Revocation
      • Authorization Inquiry

       

      #2019.11.14

      #Online payments & In-store payments

      The following change was made to Data Dictionary:

      • For DisplayType, the value IMAGE was updated to MIDDLEIMAGE.

       

      #2019.11.12

      #Online payments & In-store payments

      1. For the following interfaces, the result code INVALID_API is modified to API_INVALID and the result code INVALID_CLIENT is modified to CLIENT_INVALID:

      • Payment (Cashier Payment)
      • Payment (User-presented Mode Payment)
      • Payment (Order Code Payment)
      • Payment Result Notification
      • Payment Result Inquiry
      • Payment Cancellation
      • Refund
      • Authorization Consult
      • accessToken Application
      • Authorization Revocation
      • Authorization Inquiry

       

      2. The following changes were made to the response of Payment interface:

      • paymentActionForm: removed
      • challengeActionForm: added
      • redirectActionForm: added
      • orderCodeForm: added


      1. The following change was made to the request of Payment interface:
      • order.referenceOrderId: updated to optional

       

      1. The following change was made to the request of Payment Result Notification interface:
      • paymentCodeForm: removed

       

      1. The following change was made to the response of Payment Result Inquiry interface:
      • paymentActionForm: removed
      • redirectActionForm: added

       

      #2019.11.06

      #Online payments & In-store payments

      For the following interfaces, the result code INVALID_SIGNATURE is modified to SIGNATURE_INVALID:

      • Payment (Cashier Payment)
      • Payment (User-presented Mode Payment)
      • Payment (Order Code Payment)
      • Payment Result Notification
      • Payment Result Inquiry
      • Payment Cancellation
      • Refund
      • Authorization Consult
      • accessToken Application
      • Authorization Revocation
      • Authorization Inquiry

       

      #2019.10.24

      #Online payments & In-store payments

      1. The following changes were made to the request of Payment interface:

      • payToAmount: removed
      • paymentQuote: removed
      • paymentAmount: its description is updated and is updated to mandatory
      • paymentFactor: its sub-fields are updated


      2. The following changes were made to the response of Payment interface:

      • payToAmount: removed
      • paymentQuote: its description is updated
      • paymentAmount: its description is updated and this field is updated to mandatory
      • actualPaymentAmount: added
      • nonGuaranteeCouponValue: removed


      1. The following changes were made to the request of Payment Result Notification interface:
      • payToAmount: removed
      • paymentQuote: its description is updated
      • paymentAmount: its description is updated and this field is updated to mandatory
      • actualPaymentAmount: added
      • nonGuaranteeCouponValue: removed

       

      4. The following changes were made to the response of Payment Result Inquiry interface:

      • paymentAmount: its description is updated and this field is updated to mandatory
      • payToAmount: removed
      • actualPaymentAmount: added
      • paymentQuote: its description is updated
      • nonGuaranteeCouponValue: removed


      5. The following change was made to the request of Payment Cancellation interface:

      • paymentRequestId: added

       

      6. The following change was made to the request of Refund interface:

      • refundStrategyType: removed
      • asyncRefund: removed
      • isAsyncRefund: added
      • extendInfo: the length is updated to 512