跳至主要內容

退款


交易退款。

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

TRADE_PROCESSING(交易處理中)

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

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

相關信息

{domain}/Servlet/JSAPIService.do

https://vmp.eftpay.com.cn/VMP/Servlet/JSAPIService.do

名稱類型描述要求
serviceString接口名稱
service.alipay.jsapi.Refund
service.wechat.jsapi.Refund
申請退款接口:service.wechat.jsapi.ApplyRefund
user_confirm_keyString(12)用戶Key,由 eftPay 提供
transaction_amountString(8)退款金額。要求數字,小數位最大長度為2
out_trade_noString(28)原消費商家訂單號
paytypeString(6)支付類型
payment_typeString(20)錢包類型,與原消費交易的一致
refund_noString(28)商家退款號
tidString(20)商家終端號
total_feeString(8)交易總金額。要求數字,小數位最大長度為2
refund_descString(256)退款原因
notify_urlString(240)通知地址,投產環境只支援 80443 端口,其他端口需要申請。P.S. 調用申請退款接口時生效
timeString時間,格式:yyyyMMddHHmmss
signString(64)簽名

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

名稱類型描述要求
out_trade_noString(28)原消費商戶訂單號
trade_statusString(32)交易狀態,見 附錄2
user_confirm_keyString用戶Key,由 eftPay 提供
paytypeString(6)支付類型
refund_noString(28)商戶退款號
transaction_amountString(8)退款金額
total_feeString(8)原交易金額
payment_typeString(20)錢包類型
tidString(20)終端號,當消費請求有送的時候返回
rateString(10)交易匯率,配置返回
eftpay_trade_noString(28)依付得訂單號,配置返回
refund_trade_noString(28)依付得退款號,配置返回

{
    "service": "service.wechat.jsapi.Refund",
    "user_confirm_key": "S0003469",
    "transaction_amount": "0.01",
    "out_trade_no": "rrn_1686280006045",
    "paytype": "WeChat",
    "time": "20230609110646",
    "payment_type": "WECHATCN",
    "refund_no": "201901010011",
    "tid": "tid_3378",
    "total_fee": "10.01",
    "refund_desc": "test测试退款",
    "sign": "1029a666f791da4c2c65ecf37e4d16571ba868f88e2494101a9c6c76b7ac20eb"
}

{
    "return_status": "00",
    "return_char": "",
    "sign": "d2b6b03c564f87936d3a367f7c199ad607a405e7c0effa2db3eccff6178bd13e",
    "time": "20230609110646",
    "out_trade_no": "20190823191819",
    "trade_status": "TRADE_CLOSED",
    "user_confirm_key": "S0003469",
    "paytype": "WeChat",
    "refund_no": "10000000001",
    "transaction_amount": "0.03",
    "total_fee": "10.01",
    "payment_type": "WECHATCN",
    "tid": "t1230001",
    "rate": "0.88"
}