退款

交易退款。

TRADE_PROCESSING(交易处理中)
↓
APPLY_SUCCESS(申请成功，只有申请退款时才有的状态)
↓
TRADE_REFUND(部分退款) / TRADE_CLOSED(全额退款，退款交易关闭) / TRADE_FAIL(交易失败)

相关信息

{domain}/Servlet/JSAPIService.do

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

名称	类型	描述
service	String	接口名称，详见支持的service
user_confirm_key	String(12)	用户Key，由 eftPay 提供
return_amount	String(8)	退款金额。要求数字，小数位最大长度为2
total_fee	String(8)	交易总金额。要求数字，小数位最大长度为2
out_trade_no	String(28)	原消费商户订单号
payType	String(6)	支付类型，详见支持的payType
buyerType	String(7)	设备类型 `ios`，`android`，`others`
reason	String(256)	退款原因
wallet	String(20)	钱包类型，与原消费交易的一致，详见支持的wallet
out_refund_no	String(28)	商户退款号
eft_trade_no	String(28)	依付得订单号
pay_scene	String	支付场景
notify_url	String(240)	通知地址，投产环境只支持 `80` 和 `443` 端口，其他端口需要申请。P.S. 调用申请退款接口时生效，详见支持的service
time	String	时间，格式：`yyyyMMddHHmmss`
sign	String(64)	签名

查看支持的 service 以及其对应的 payType 和 wallet

以下是 service、payType 和 wallet 三者之间的对应关系

service	payType	wallet	描述
service.alipay.web.Refund	`Alipay`	`ALIPAYCN` `ALIPAYHK`	支付宝 web 退款接口
service.wechat.web.Refund	`WeChat`	`WECHATCN` `WECHATHK`	微信 web 退款接口
service.wechat.web.ApplyRefund	`WeChat`	`WECHATCN` `WECHATHK`	微信 web 申请退款接口
service.icbc.wap.Refund	`ICBC`	`ICBCWAP`	ICBC wap 退款接口
service.atome.v2.wap.Refund	`ATOME`	`ATOME`	ATOME 线上退款接口
service.unionpay.online.web.Refund	`UnionPay`	`UNIONPAY`	银联线上收银退款接口
service.oct.online.Refund	`OCT`	`OCT`	八达通线上申请退款接口
service.fdms.web.Refund	`Fdms`	`FDMS`	FDMS 的 VISA ，Master 退款
service.mpgs.web.Refund	`Mpgs`	`MPGS`	MPGS 的 VISA ，Master 退款
service.ae.web.Refund	`AE`	`AE`	AE 退款
service.nuvei.web.Refund	`NUVEI`	`NUVEI`	NUVEI 的 VISA ，Master 退款
service.jetco.wap.Refund	`Jetco`	`JETCOHK`	银通 wap 退款接口
service.payme.web.Refund	`PAYME`	`PAYME`	PayMe web 退款接口
service.bocvmp.unionpay.web.Refund	`BOCVMP`	`BOCVMPUPW`	BOC web 退款接口

提示

只有使用以下申请退款接口时，notify_url参数才生效
- service.wechat.web.ApplyRefund
- service.oct.online.Refund

名称	类型	描述
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)	终端号，当消费请求有送的时候返回

{
	"service": "service.alipay.web.Refund",
	"user_confim_key": "12345678",
	"return_amount": "0.01",
	"total_fee": "0.02",
	"out_trade_no": "20190823191819",
	"payType": "Alipay",
	"buyerType": "ios",
	"reason": "",
	"out_refund_no": "20190824094947",
	"pay_scene": "WEB",
	"eft_trade_no": "08520005269190823191801988",
	"wallet": "ALIPAYCN",
	"time": "20230609110646",
	"sign": "580e4a26db5e601e3a1b89b3fc815b5c2122a4ccc18fa90742c8641c172e8c77"
}

{
    "user_confirm_key": "12345678",
    "return_amount": "0.01",
    "wallet": "ALIPAYCN",
    "return_char": "",
    "out_refund_no": "20190823191819",
    "sign": "cd6a175f61ff941fcd8b8bb4467944e3eaa64bfe572e6b6361624890bcda3d82",
    "fee_type": "HKD",
    "eft_trade_no": "08520005269190823191801988",
    "out_trade_no": "20190823191819",
    "payType": "Alipay",
    "refund_time": "20190824094950",
    "trade_status": "TRADE_CLOSED",
    "total_fee": "0.02",
    "return_status": "00",
    "buyerType": "ios",
    "time": "20230609110646"
}

退款

#

#

#

#

#

#

#