Return payment results
After the user makes a payment, Mobile Payment Provider (MPP) can return the payment result to Alipay+ by the following three ways:
- Return the payment result in the response of the pay API.
- Return the payment result in the asynchronous request of the notifyPayment API.
- Return the payment result in the response of the inquiryPayment API.
The following diagram illustrates all the possible combinations of the payment results that you (the MPP) might return in the three ways.
Figure 1. All the possible combinations of the payment results
If the payment reaches a final status (success or failure), make sure to keep the returned payment results consistent in the above three 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.
Integration requirements
It is required that you (the MPP) support the inquiryPayment API to ensure that Alipay+ receives the final payment result (success or failure). It is recommended that you support the notifyPayment API so that Alipay+ can receive your payment result notification.
For how to respond to payment result inquiry through the inquiryPayment API, see Respond to payment inquiry.
For how to notify the payment result using the notifyPayment API, see Notify payment result.