Return payment results

After the user makes a payment, Mobile Payment Provider (MPP) can return the payment result to Alipay+ by the following two ways:

• Return the payment result in the asynchronous request of the notifyPayment API.
• Return the payment result in the response of the inquiryPayment API.

If the payment reaches a final status (success or failure), make sure to keep the returned payment results consistent in the above two ways. However, there is one exception. If a payment succeeds (the parameters paymentResult.resultStatus is S and paymentResult.resultCode is SUCCESS) but then is successfully cancelled, you need to return the parameters paymentResult.resultStatus of F and paymentResult.resultCode ofORDER_IS_CLOSED to Alipay+ when Alipay+ calls the inquiryPayment API.

Note: A payment reaches the final status of failure means that the payment failed and cannot be retried anymore.

Integration requirements

It is required that you support both the notifyPayment API and the inquiryPayment API to ensure that Alipay+ receives the final payment result (success or failure). For example, when the payment result notification is not returned timely due to network or system problems, the inquiryPayment API can work as a complement to return the final payment result.

Learn more about how to respond to payment inquiry through the inquiryPayment API.

Learn more about how to notify the payment result through the notifyPayment API.