退款

交易退款。

目前只支持微信和支付宝。

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_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)	返回说明，可能会变化，不能作条件判断
return_status 大于 00 时返回
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"
}

退款

#

#

#

#

#

#