跳至主要內容

退款


交易退款。

目前只支援微信和支付寶。

TRADE_PROCESSING(交易處理中)

APPLY_SUCCESS(申請成功,只有申請退款時才有的狀態)

TRADE_REFUND(部分退款) / TRADE_CLOSED(全額退款,退款交易關閉) / TRADE_FAIL(交易失敗)

相關信息

退款:

{domain}/Servlet/AppTradeRefund.do

申請退款:

{domain}/Servlet/AppTradeApplyRefund.do

(此接口僅對微信交易有效,支付寶交易調用此接口相當於調用退款接口)

// 退款:
https://vmp.eftpay.com.cn/VMP/Servlet/AppTradeRefund.do

// 申请退款:
https://vmp.eftpay.com.cn/VMP/Servlet/AppTradeApplyRefund.do

名稱類型描述要求
user_confirm_keyString(12)用戶Key,由 eftPay 提供
return_amountString(8)退款金額。要求數字,小數位最大長度為2
eft_trade_noString(28)依付得訂單號
eft_trade_noout_trade_no 二選一
out_trade_noString(28)原消費商戶訂單號
out_trade_noeft_trade_no 二選一
out_refund_noString(28)商戶退款號
buyerTypeString(7)設備類型
iosandroidothers
reasonString(256)退款原因
notify_urlString(240)通知地址,投產環境只支援 80443 端口,其他端口需要申請。P.S. 調用申請退款接口時生效
timeString時間,格式: yyyyMMddHHmmss
signString(64)簽名

提示

  • 優先級eft_trade_no>out_trade_no

名稱類型描述要求
return_statusString(3)返回狀態碼,代表。注:此參數不可作為交易狀態是否成功的判斷
其他狀態碼見 附錄3
return_charString(100)返回說明,可能會變化,不能作條件判斷
return_status 大於 00 時返回
timeString時間,格式:yyyyMMddHHmmss
return_status>=00時返回
signString(64)簽名
return_status>=00時返回

名稱類型描述要求
out_trade_noString(28)原消費商戶訂單號
out_refund_noString(28)商戶退款號
eft_trade_noString(28)依付得訂單號
trade_statusString(32)交易狀態,見 附錄2
refund_timeString退款交易時間,格式: yyyyMMddHHmmss
user_confirm_keyString用戶Key,由 eftPay 提供
payTypeString(6)支付類型
buyerTypeString(7)設備類型
walletString(20)錢包類型
fee_typeString(5)貨幣
return_amountString(8)退款金額
total_feeString(8)原交易金額
tidString(20)終端號,當消費請求有送的時候返回
rateString(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"
}