统一申请退款

应用场景

商户针对某一个已经成功支付的订单发起退款申请,申请结果在同一会话中同步返回

一、退款资金到账

退款资金到账时间根据支付方式不同而不同,一般退到易票联帐号是即时到账;退到银行卡则是非实时的,每个银行的处理速度不同,一般发起退款后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>