跳至主要內容

退款


交易退款。

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
user_confirm_keyString(12)用户Key,由 eftPay 提供
transaction_amountString(8)退款金额。要求数字,小数位最大长度为2
out_trade_noString(28)原消费商户订单号
paytypeString(6)支付类型,详见 支持的paytype
buyertypeString(7)设备类型
iosandroidothers
payment_typeString(20)钱包类型,与原消费交易的一致,详见 支持的payment_type
refund_noString(28)商户退款号
timeString时间,格式:yyyyMMddHHmmss
signString(64)签名

查看支持的 service 以及其对应的 paytype 和 payment_type

以下是 service、paytype 和 payment_type 三者之间的对应关系

servicepaytypepayment_type描述
service.alipay.qrcode.RefundAlipayALIPAYCN
ALIPAYHK
ALIPAYBOTH
支付宝 qrcode Refund 接口
service.wechat.qrcode.RefundWeChatWECHATCN
WECHATHK
微信 qrcode Refund 接口
service.atome.v1.qrcode.RefundATOMEATOMEATOME qrcode Refund 接口
service.unionpay.qrcode.csb.RefundUnionPayUNIONPAY银联 qrcode Refund 接口
api.service.gbpay.qrcode.cash.RefundGBPAYGBPAYGBPAY qrcode Refund 接口
service.payme.qrcode.RefundPAYMEPAYMEPAYME qrcode Refund 接口

名称类型描述要求
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 提供
trade_typeString(10)订单类型,REFUND
buyer_idString(30)用户标识
tidString(20)终端号,当消费请求有送的时候返回
transaction_idString(64)支付提供方单号
eftpay_trade_noString(28)依付得订单号,配置返回
payment_typeString(20)钱包类型
trade_timeString退款时间,格式:yyyy-MM-dd HH:mm:ss
transaction_amountString(8)退款金额
original_amountString(8)原交易金额
currencyString(10)货币
refund_noString(28)商户退款号
refund_trade_noString(28)依付得退款号,配置返回
payment_amountString(12)商家实收款金额,UnionPay 类型返回
cost_amountString(12)用户支付的金额,UnionPay 类型返回
uplan_discountString(12)Uplan 优惠金额,UnionPay 类型返回
amount_discountString(12)立减优惠金额,UnionPay 类型返回

{
    "service": "service.alipay.qrcode.Refund",
    "user_confim_key": "1234567890000",
    "transaction_amount": "0.01",
    "out_trade_no": "20190823191819",
    "paytype": "Alipay",
    "buyertype": "ios",
    "refund_no": "20190824094947",
    "payment_type": "ALIPAYCN",
    "time": "20230609110646",
    "sign": "a8239928297673469163534067af8c50dbd1d8edaf283453572fd36a78498a40"
}

{
    "return_char": "",
    "return_status": "00",
    "sign": "80082137c57af4d3f3113c2b9cd805649bbcb2a88ae6931f16a8a9ff1d4a8bd0",
    "time": "20190824094950",
    "out_trade_no": "20190823191819",
    "trade_status": "TRADE_CLOSED",
    "user_confirm_key": "S0003469",
    "trade_type": "SALE",
    "buyer_id": "",
    "tid": "",
    "transaction_id": "20190823191819",
    "eftpay_trade_no": "20190823191819",
    "payment_type": "ALIPAYCN",
    "trade_time": "20190824094950",
    "transaction_amount": "10.01",
    "original_amount": "10.01",
    "currency": "HKD",
    "refund_no": "20190823191819"
}