退款
交易退款。
目前只支援微信和支付寶。
TRADE_PROCESSING(交易處理中)
↓
APPLY_SUCCESS(申請成功,只有申請退款時才有的狀態)
↓
TRADE_REFUND(部分退款) / TRADE_CLOSED(全額退款,退款交易關閉) / TRADE_FAIL(交易失敗)
相關信息
退款:{domain}/Servlet/AppTradeRefund.do
申請退款:{domain}/Servlet/AppTradeApplyRefund.do
(此接口僅對微信交易有效,支付寶交易調用此接口相當於調用退款接口)
https:/VMP/Servlet/AppTradeRefund.do
申请退款:
https:/VMP/Servlet/AppTradeApplyRefund.do
退款:
名稱 | 類型 | 描述 | 要求 |
---|---|---|---|
user_confirm_key | String(12) | 用戶Key,由 eftPay 提供 | |
return_amount | String(8) | 退款金額。要求數字,小數位最大長度為2 | |
eft_trade_no | String(28) | 依付得訂單號eft_trade_no 和 out_trade_no 二選一 | |
out_trade_no | String(28) | 原消費商戶訂單號out_trade_no 和 eft_trade_no 二選一 | |
out_refund_no | String(28) | 商戶退款號 | |
buyerType | String(7) | 設備類型ios ,android ,others | |
reason | String(256) | 退款原因 | |
notify_url | String(240) | 通知地址,投產環境只支援 80 和 443 端口,其他端口需要申請。P.S. 調用申請退款接口時生效 | |
time | String | 時間,格式: yyyyMMddHHmmss | |
sign | String(64) | 簽名 |
提示
- 優先級
eft_trade_no
>out_trade_no
名稱 | 類型 | 描述 | 要求 |
---|---|---|---|
return_status | String(3) | 返回狀態碼,代表。注:此參數不可作為交易狀態是否成功的判斷 其他狀態碼見 附錄3 | |
return_char | String(100) | 返回說明,可能會變化,不能作條件判斷 | |
time | String | 時間,格式:yyyyMMddHHmmss return_status >=00 時返回 | |
sign | String(64) | 簽名return_status >=00 時返回 |
名稱 | 類型 | 描述 | 要求 |
---|---|---|---|
out_trade_no | String(28) | 原消費商戶訂單號 | |
out_refund_no | String(28) | 商戶退款號 | |
eft_trade_no | String(28) | 依付得訂單號 | |
trade_status | String(32) | 交易狀態,見 附錄2 | |
refund_time | String | 退款交易時間,格式: yyyyMMddHHmmss | |
user_confirm_key | String | 用戶Key,由 eftPay 提供 | |
payType | String(6) | 支付類型 | |
buyerType | String(7) | 設備類型 | |
wallet | String(20) | 錢包類型 | |
fee_type | String(5) | 貨幣 | |
return_amount | String(8) | 退款金額 | |
total_fee | String(8) | 原交易金額 | |
tid | String(20) | 終端號,當消費請求有送的時候返回 | |
rate | String(10) | 交易匯率,配置返回 |
{
"return_amount": "0.61",
"reason": "退款原因",
"buyerType": "android",
"eft_trade_no": "20005269520084311t5rutcv1734",
"user_confim_key": "S0003469",
"out_trade_no": "rrn_1686280005979",
"out_refund_no": "rrn_1686280005979R",
"time": "20230609110645",
"sign": "0f81b3875590a29b84fbbb2527bff48cd340f2bfb94589ab5c8dd4635629dbdc"
}
{
"user_confirm_key": "S0003469",
"return_amount": "0.22",
"wallet": "ALIPAYCN",
"return_char": "",
"out_refund_no": "rrn_1686280005983R",
"sign": "46735e26e0012fb5e1ca16cc9e365d19cb3a486250ebd29c3be4c7166fcd47c1",
"fee_type": "HKD",
"eft_trade_no": "20005269520084311t5rutcv1734",
"out_trade_no": "rrn_1686280005983",
"payType": "Alipay",
"refund_time": "20230609110645",
"trade_status": "TRADE_CLOSED",
"total_fee": "0.22",
"return_status": "00",
"buyerType": "android",
"time": "20230609110645"
}