统一查询退款

应用场景

根据商户订单号、商户退款单号、易票联退款单号查询退款记录的具体信息。

接口地址

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) 退款的交易类型代码固定为refundQuery
partner 商户号 String(20) 由易票联统一分配的商户号
out_trade_no 商户系统订单号 String(32) 退款单对应的商家系统支付订单号。
refund_id 易票联退款单号 String(20) 易票联网关系统退款单号
out_refund_no 商户系统退款单号 String(32) 商户系统生成的退款单号。仅可以使用大小写英文字符、数字、下划线、中划线组成。(易票联根据商户编码和这个退款单号,保证其在网关系统的退款单唯一性)

举例如下:

https://www.epaylinks.cn/paycenter/gateways.do?refund_id=&sign_type=SHA256withRSA&beginTime=2014-03-30&out_trade_no=1502177672585&out_refund_no=1502177710591&endTime=2014-05-21&version=4.0&certId=335902764374016746163578510918738695929360058949&partner=EC130422C0003&trans_type=refundQuery&sign=FZmQStiOrU5zKC3NxmjYkcRPwajDUrbN3XQ5N1GNpf8caVD9XOE7fcjaTNgf3CA309xNwigS5WhyOPAsSRoeOE0sFYhyIy8KfUdGslRz%2bqbL2NphykButyGRn2%2fDtyjSb3EG%2fNu1VQVGOV36Pd%2fZJOZkHaMZs4DVlsQhpKip6Ez%2fU%2fd3hE1wffYYfEYm6sz2AKTeVLyGml4GE52Q06%2fitjTX%2b8PByXgjllI1%2fhmALBDMtfzUfHUtFoMaMcwXQGeTvT5oAwLPQi0k4GWhBkpmCpR2JcKPy7AB3MF%2beUyNDkggAc8SqFS7ekua9%2f0vv80kXt5vKru5X8NXtY6jXz%2fYhg%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退款失败
create_time 申请时间 String(14) 格式:YYYYMMDDHHMISS
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>
   <refunds>
      <refund>
         <out_trade_no>1502177672585</out_trade_no>
         <out_refund_no>1502177710591</out_refund_no>
         <refund_id>31318</refund_id>
         <refund_amount>0.01</refund_amount>
         <refund_result>1</refund_result>
         <create_time>20170808153519</create_time>
         <refund_time>20170808153548</refund_time>
      </refund>
   </refunds>
   <sign_type>SHA256withRSA</sign_type>
  <sign>
  <Z92LV2gRqUqiYmfZi5NucdfccAJBxoLAUhOdVaSZ0XiKjKFU/dpxCWOsuKsWNJ/UdxP/7c+JAoMfPv0NQF2elW6L6V/AAaDXQ0k+CIae65LsIsVIYcJw53vz+yArCneQL9D1o5BnnMqJN52pIps8EJJBJwjwlWFmqCi1m96+ExD6fCSWv2sZ0iTmrCVHaajG+n/sQ3Zefz5g5liIdo7pkvBUQLMjBKaRlcRejXtNvkLat8oaBObkHC+NBBCGqjczD12x4UvN2REskoEVVdkTxAGHrlLlA9r3INqmmFH1+hId/6YG7bNQDl0+KApfZ9U8sEXuNqBU2zcz4+WU9BBdVw== </sign>
</root>