Barcode Payment

Notes:

• For calling the SDK API, please refer the quick integration section.
• Please pay attention to the combination of API calls. Since all API calls are synchronous return, there might be needs to call query API for polling the payment result. The polling will start 5 seconds after payment. We would suggest 5 seconds time interval for each query call and the max time of 30 seconds for the polling. If there is no success status on the payment, the merchant should call the cancel API. The merchant can adjust the time value for their own business need.
• If the network latency causes the merchant to issue the Cancel API call. After the cancel, the user completes the payment successfully. The payment will be still cancelled and the order will be closed.
• The caller of payment API can set timeout value for the payment call. After the timeout, the payment will be closed automatically.
• The merchant must call Cancel API within 24 hours after the payment.
• Regular refund should call Refund API, which will return the fund to the original funding channel. The default valid refund window is three months, if not specified in contract.

QR Code Payment

Notes:

• QR Code Payment is as following.
  1) The merchant generates the order first for Alipay to generate the payment URL.
  2) The merchant will generate the QR code based on the returned payment URL.
  3) The buyer can scan the QR code with Alipay Wallet.
  4) Alipay will return the payment result asynchronously.
• Please pay attention for the combination of API calls. Since all API calls are synchronous return. There might be needs to call query API for polling the payment result. The polling will start 5 seconds after payment. We would suggest 5 seconds time interval for each query call and the max time of 30 seconds for the polling. If there is no success status on the payment, the merchant should call the cancel API. The merchant can adjust the time value for their own business need.
• If the network latency causes the merchant to issue the Cancel API call. After the cancel, the user completes the payment successfully. The payment will be still cancelled and the order will be closed.
• The caller of payment API can set timeout value for the payment call. After the timeout, the payment will be closed automatically.
• The merchant must call Cancel API within 24 hours after the payment.
• Regular refund should call Refund API, which will return the fund to the original funding channel. The default valid refund window is three months, if not specified in contract.

Sound Wave Payment

Notes:

• This function could be used at vending machine or in-store POS machine. The payment flow is similar to the Barcode payment.
• Please pay attention to the combination of API calls. Since all API calls are synchronous return. There might be needs to call query API for polling the payment result. The polling will start 5 seconds after payment. We would suggest 5 seconds time interval for each query call and the max time of 30 seconds for the polling. If there is no success status on the payment, the merchant should call the cancel API. The merchant can adjust the time value for their own business need.
• If the network latency causes the merchant to issue the Cancel API call. After the cancel, the user completes the payment successfully. The payment will be still cancelled and the order will be closed.
• The caller of payment API can set timeout value for the payment call. After the timeout, the payment will be closed automatically.
• The merchant must call Cancel API within 24 hours after the payment.
• Regular refund should call Refund API, which will return the fund to the original funding channel. The default valid refund window is three months, if not specified in contract.

FAQ