跳至主要內容

退款


交易退款。

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.united.wap.Refund
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 二选一
buyerTypeString(7)设备类型
iosandroidothers
reasonString(256)退款原因
out_refund_noString(28)商户退款号
pay_sceneString支付场景
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)终端号,当消费请求有送的时候返回

{
	"service": "service.united.wap.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": "2252437f5453b048636400b40be947c33fe916e24843791e47577fbeae32fa1f"
}

{
	"user_confirm_key": "12345678",
	"return_amount": "0.02",
	"wallet": "ALIPAYCN",
	"return_char": "",
	"out_refund_no": "20190824094947",
	"sign": "dc3cdc87d145ffade2462062a79c1053a08d15ef5302841282150f7fd2d994c4",
	"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": "20190824094950"
}