Payment APIs
- The merchant needs to pass in the unique out_trade_no. Also suggest that the out_trade_no could contain the information of date and time.
- Please pass in the detailed list of purchased items.
- Please pass in terminal_id, store_id, seller_id.
- The processing code for the response value inside “fund_bill_list” field. The field will be expanded in the future.
- Set the timeout value (timeout_express). The order will be closed after the timeout and no further operation will be allowed on the payment. Please set the value for the business need, for example, 30 min. Otherwise, the default value will be 15 days.
- If the merchant has a fee-split agreement with the service provider, please pass in partnered of the vendor in “sys_service_provider_id” field inside “extend_params”.
- If the merchant passes in only the amount for the full order, without the details of discountable amount, and non-discountable amount. The full amount will be treated as the discountable amount.
Qurey APIs
- In Barcode payment and sound wave payment, if the response of the payment request is “10003”, the merchant needs to call Query API to poll. Suggest to poll every 5 seconds with a max of 30 seconds.
- For QR Code payment, after the QR code is displayed, we suggest the polling should start, with a query every 5 seconds with a max of 3 minutes. If no successful result, please call Cancel API.
- If the QR code is printed, the cahier needs to trigger the polling manually.
Cancel APIs
- It has a time limit, normally 24 hours.
- If the cancel fails, please pay attention to the retry flag in the response. Please refer to API document for retry frequency, times.
- For invalid QR code, we should call the Cancel API to invalidate the QR code.
Refund APIs
- Alipay supports multiple refunds for a single payment. The refunds must provide the Alipay payment id and unique refund id for each refund request. The total of the refund amounts could not be greater than the payment amount.
- If a refund request fails, and needs to be resubmitted, it should use the original refund id.
POS
- When the POS is polling:
1) The “waiting” UI should be displayed.
2) The UI should have a count-down value, or a timing sliding bar displayed such that the cashier could know the progress of the order.
3) No other transaction should be processed when polling.
4) The UI should offer a function to cancel the polling/waiting.
- When the POS times out with unfinished payment, the POS should call cancel API such that the cashier could handle the exceptions.
- If the cashier cancels the polling, POS should call cancel API to close the payment order.
- If the POS is not link with Internet, the Alipay function should be disabled, and the cashier should be notified.
Recipt
The receipt should contain the store id, POS / terminal id, Alipay transaction id, payer account info (desensitize), order amount and discount amount etc.
FAQ
关于此文档暂时还没有FAQ
