- 反掃場景:僅能撤銷尚未完成的交易。若原始交易已成功(
respcd=0000),請改用 退款 API。 - 信用卡 / Apple Pay 場景:用於撤銷已經完成的卡交易。執行後會直接取消該筆交易。
支援場景
目前以下支付場景支援
/trade/v1/reversal。請根據你的接入場景確認對應的交易行為。1. 反掃支付場景
通常用於商戶已建立訂單,但消費者尚未完成付款等狀態。- 支付寶
800108:支付寶反掃支付
- 微信支付
800208:微信反掃支付
- 銀聯雲閃付
800708:銀聯雲閃付反掃支付
2. 信用卡 / Apple Pay 場景(適用於「已完成」交易)
- 線上信用卡支付
802801: Visa/Mastercard
- Apple Pay 交易
806527: Apple Pay
- 行為說明:在此場景下,沖正的效果為**撤銷(Void)**該筆已扣款或已授權的卡交易。
如需對其他錢包或模式進行交易取消,請參考本文下方的「Reversal vs Close」或聯絡 QFPay 技術支援取得整合建議。
API 端點
- Endpoint:
/trade/v1/reversal - 方法:
POST
沖正成功通常回應
respcd=0000。若二維碼交易付款回應已為 respcd=0000,則無法發起沖正,請改用退款。請求參數
syssn 與 out_trade_no 至少提供其中一個。回應參數
程式碼範例
Python
Java
JavaScript
PHP
回應範例
JSON
補充說明
- 沖正不代表一定「不會扣款」。請務必搭配 交易查詢 API 驗證最終結果。
- 若回應為
respcd=1143或1145,代表處理中,請延遲後重試查詢直到取得最終狀態。
Reversal(沖正)vs Close(關閉訂單)
部分錢包在「取消未完成交易」時會使用/trade/v1/close(關閉訂單)取代 /trade/v1/reversal。
典型支援範圍(示例)
800201:微信正掃800212:微信H5支付800701:銀聯雲閃付正掃801514:支付宝PC正掃
/trade/v1/close方法:
GET
實際支援範圍可能因商戶配置與渠道而異。如需確認你方可用的取消方式,請聯絡技術支援。
Close 請求參數(摘要)
syssn 與 out_trade_no 至少提供其中一個。
