应用场景
根据商户订单号、商户退款单号、易票联退款单号查询退款记录的具体信息。
接口地址
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>