应用场景
商户针对某一个已经成功支付的订单发起退款申请,申请结果在同一会话中同步返回
一、退款资金到账
退款资金到账时间根据支付方式不同而不同,一般退到易票联帐号是即时到账;退到银行卡则是非实时的,每个银行的处理速度不同,一般发起退款后1-7个工作日内到账。
二、退款限制
商户在退款操作时应该注意退款限制,避免发起不会成功的退款请求,下面是主要的退款限制:
1.在易票联系统中,只要退款累计金额不超过交易单支付总额,一笔交易单可以多次退款,退款申请单号(退款接口中有此参数)唯一确定一次退款,而不是交易单号确定一次退款。退款申请单号由商户生成,所以商户一定要保证退款申请单的唯一性。商家在退款过程中要特别注意,只有在能确定退款失败的情况下,才能重新发起另一笔退款。
2.目前大多数银行都支持全额退款和部分退款,但是也有少数银行不支持全额退款或部分退款,或者不支持退款。在这种情况下,商户可以与买家协调,退到指定的易票联帐号。
接口地址
https://www.epaylinks.cn/paycenter/gateways.do
输入参数
通过get或post请求
参数 | 参数名称 | 类型 | 必填 | 描述 |
---|---|---|---|---|
协议参数 | ||||
version | 接口版本 | String(8) | 是 | 固定填写4.0 |
sign_type | 签名类型 | String(20) | 是 | 目前支持SHA256withRSA签名算法 |
certId | 证书序列号 | String(500) | 是 | 填写签名私钥证书的Serial Number |
sign | 签名 | String(500) | 是 | 数字签名 |
业务参数 | ||||
trans_type | 交易类型 | String(20) | 是 | 退款的交易类型代码固定为refund |
partner | 商户号 | String(20) | 是 | 由易票联统一分配的商户号 |
out_trade_no | 商户系统订单号 | String(32) | 是 | 退款单对应的商家系统支付订单号。 |
out_refund_no | 商户系统退款单号 | String(32) | 是 | 商户系统生成的退款单号。仅可以使用大小写英文字符、数字、下划线、中划线组成。(易票联根据商户编码和这个退款单号,保证其在网关系统的退款单唯一性) |
total_amount | 订单总金额 | String(12) | 是 | 式:元.角分,单位是元 |
refund_amount | 退款金额 | String(12) | 是 | 格式:元.角分,单位是元。可以做部分退款,累计退款总金额不能超过订单总金额。 |
举例如下:
https://www.epaylinks.cn/paycenter/gateways.do?certId=335902764374016746163578510918738695929360058949&out_refund_no=1502172941253&out_trade_no=1502172887608&partner=EC130422C0003&refund_amount=0.01&sign_type=SHA256withRSA&total_amount=0.01&trans_type=refund&version=4.0&sign=StSWVfh8NVw3%2feOX%2bkSJEDM0cw9jEe2Z42Mi7iEMEixOwl6B1MEFTV%2bBcMa3MuCAoXqaHk3tKU%2boTWPZdI9GE9CL6lQb6uhKbfdurZBdQuQHH8cTO41%2fKSgWrxDqeru%2fikzrCw%2bhHDpfIaST5FAxQfqUAYIs2lEQQaGX7dESqEjhyuxAy8ixqfv19N0%2fopWT8uVIOrlgCSeG%2fZeFK7ECbW91JaQfFdjx7d0GiPCOg%2foGMWgja%2bxQLCpmBBmszdCWv1NZhI5PcpyYmC%2b1fkWDbsEmrAzYdSnjNyDnbdj%2bPNZgEG73n%2f7CKpmClV1HWPISiYcL2XNk1BwMq8NYe%2f1JSw%3d%3d
返回结果
数据按XML的格式实时返回
参数 | 参数名称 | 类型 | 必填 | 描述 |
---|---|---|---|---|
协议参数 | ||||
version | 接口版本 | String(8) | 否 | 固定填写4.0 |
sign_type | 签名类型 | String(20) | 是 | 目前支持SHA256withRSA签名算法 |
certId | 证书序列号 | String(500) | 否 | 填写签名私钥证书的Serial Number |
sign | 签名 | String(500) | 是 | 数字签名 |
业务参数 | ||||
resp_code | 响应码 | String(2) | 是 | 00表示成功,其它表示失败 |
resp_desc | 响应描述 | String(100) | 是 | 响应描述 |
partner | 商户号 | String(20) | 是 | 由易票联统一分配的商户号 |
out_trade_no | 商户系统订单号 | String(32) | 是 | 退款单对应的支付订单号 |
out_refund_no | 商户系统退款单号 | String(32) | 是 | 商户系统退款单号 |
refund_id | 易票联退款单号 | String(20) | 是 | 易票联网关系统退款单号 |
refund_amount | 退款金额 | String(12) | 是 | 格式:元.角分,单位是元。可以做部分退款,累计退款总金额不能超过订单总金额。 |
refund_result | 退款结果 | String(1) | 是 | 0未处理,1退款成功,2退款失败 |
refund_time | 退款处理时间 | String(14) | 是 | 格式:YYYYMMDDHHMISS |
举例如下:
<?xml version="1.0" encoding="GBK" ?>
<root>
<resp_code>00</resp_code>
<resp_desc>Success</resp_desc>
<partner>EC130422C0003</partner>
<out_trade_no>1502153130338</out_trade_no>
<out_refund_no>1502155501813</out_refund_no>
<refund_id>31316</refund_id>
<refund_amount>0.01</refund_amount>
<refund_result>3</refund_result>
<refund_time/>
<sign_type>SHA256withRSA</sign_type>
<sign>
<U+T0gVfT65hmZ79RyfL0OXC9lXWhGG+LC/aC5ZKUrYlnOR0AJkhBZKPToWMK+H7BYKHYgjZtxBwd+UBvr4++/q1Vn6dgp6UaxESgvoGmOopQeE9hhHP2tPjWLL9pyrPIWZvG4qUT/YVewHOc9QRUEvNFnRID3IsVGhzJASs6EoMppr/D0XFsYjY7b/joq0oh5OxMSDAcA1BDWb19nt5tiyxcG9UhzuFt/KE+dK96G02WUPZ2cz3ffIEMOo6/Wo+tb2Az3BFo27fwNVug8zmuyploCs3urSo2NQc/rUyQxUs8ArMzGYUtPrXwv13WQepyhFj3+BJZyWy670F0chl2iw== </sign>
</root>