1 退款申请

Ø 提交字段都需做去空格操作，加密字符串需去空格后加密。

Ø 服务器 IP 需登记，请联系技术支持。

Ø 需注意后加入V2版本退款申请接口，签名值有所区别。

Ø 接口地址：https://{SERVICE_URL}/servlet/ApplyRefund。

Ø 退款申请接口返回码为 00 时，表示退款正在处理中。

 

1.1 提交参数

示例代码

<form action="SERVICE_URL" method="post">
	<input name="merNo" type="hidden" value="99999" />
	<input name="gatewayNo" type="hidden" value="99999001" />
	<input name="signInfo" type="hidden" value="4B8FA15BBCA0A22F3FDB" />
	<input name="tradeNo" type="hidden" value="2012099999999999999999" />
	<input name="refundType" type="hidden" value="1" />
	<input name="tradeAmount" type="hidden" value="98" />
	<input name="refundAmount" type="hidden" value="98" />
	<input name="currency" type="hidden" value="EUR" />
	<input name="refundReason" type="hidden" value="test" />
</form>

参数名	类型	长度	是否必填	描述
merNo	String	5	Yes	【商户号】
gatewayNo	String	8	Yes	【网关接入号】
signInfo	String	100	Yes	【签名数据】 返回数据为大写.各语言加密方式不同,加密的每个字段都需做去空格处理 详见【附录】sha256加密方式。 明文加密结构 V1版本：merNo + gatewayNo + tradeNo + refundType + signKey V2版本：merNo + gatewayNo + tradeNo + currency+ refundAmount + signKey
tradeNo	String	30	Yes	【交易流水订单号】
refundType	String	1	Yes	【退款类型】 1 : 全额退款 2 : 部分退款
tradeAmount	String	10	Yes	【交易金额】 该笔订单交易的金额。 最多为2位小数。
refundAmount	double	10	Yes	【退款金额】 最多为2位小数。
currency	String	10	Yes	【币种】 该笔订单交易的币种。 详见【附录】币种 (ISO 4217)
refundReason	String	100	Yes	【退款原因】
remark	String	100	No	【备注】 发送数据的时候，传输的什么，就返回什么。
merTrackNo	String	50	No	【商户跟踪号】非必填，用于商户唯一标识一笔退款记录

 

1.2 返回参数

返回示例

<!--?xml version="1.0" encoding="UTF-8"?-->
<response>
 <applyrefund>
  <merno>99999</merno>
  <gatewayno>99999001</gatewayno>
  <signinfo>4B8FA15BBCA0A22F3FDB</signinfo>
  <tradeno>123456789</tradeno>
  <batchno>10001</batchno>
  <code>00</code>
  <description>退款申请成功</description>
  <refundreason>test</refundreason>
  <remark></remark>
 </applyrefund>
</response>

 

参数名	类型	长度	是否必填	描述
merNo	String			【商户号】
gatewayNo	String			【网关接入号】
signInfo	String			【签名数据】 全为小写.各语言加密方式不同,加密的每个字段都需做去空格处理 详见【附录】sha256加密方式。 明文加密结构 V1版本：merNo + gatewayNo + tradeNo + refundType + signKey V2版本：merNo + gatewayNo + tradeNo + batchNo + code + signKey
tradeNo	String			【流水订单号】
batchNo	Int			【退款编号】 用于查询退款的唯一 ID。
code	String			【退款结果】 详见【附录】退款申请代码列表
description	String			【退款说明】 详见【附录】退款申请代码列表
refundReason	String			【退款原因】
remark	String			【备注】

 

2 退款明细查询

Ø 接口地址：https://{SERVICE_URL}/servlet/QueryRefund。

 

2.1 提交参数

示例代码

<form action="SERVICE_URL" method="post">
	<input name="merNo" type="hidden" value="99999" />
	<input name="gatewayNo" type="hidden" value="99999001" />
	<input name="tradeNo" type="hidden" value="2012099999999999999999" />
	<input name="signInfo" type="hidden" value="4B8FA15BBCA0A22F3FDB" />
</form>

 

参数名	类型	长度	是否必填	描述
merNo	String	5	Yes	【商户号】
gatewayNo	String	8	Yes	【网关接入号】
batchNo	String			【退款编号】 我方退款唯一ID
signInfo	String	100	Yes	【签名数据】 返回数据为大写.各语言加密方式不同, 详见附录 sha256加密方式。 明文加密结构：merNo + gatewayNo + batchNo + signKey

 

2.2 返回参数

参数名	类型	长度	是否必填	描述
merNo	String			【商户号】
gatewayNo	String			【网关接入号】
batchNo	String			【退款编号】 我方退款唯一ID
signInfo	String			【签名数据】 全为小写.各语言加密方式不同, 详见【附录】sha256加密方式。 明文加密结构： merNo + gatewayNo + batchNo + code + signKey
currency	String			【币种】 详见【附录】交易币种（ISO 4217）
refundAmount	String			【退款金额】 申请退款的金额
code	String			【退款结果】 详见【附录】退款状态代码列表
description	String			【退款说明】 详见【附录】退款状态代码列表
refundReason	String			【退款原因】

 

2.3 返回样例

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <queryRefund>
    <merNo>99999></merNo>
    <gatewayNo>99999003</gatewayNo>
    <batchNo>10001</batchNo>
    <signInfo>c9e8d6e703085f349107276ad41252ef745baf904e036bd4f26f9c6bb7b36837</signInfo>
    <currency>USD</currency>
    <refundAmount>0.02</refundAmount>
    <code>02</code>
    <description>Pending</description>
    <refundReason>test</refundReason>
  </queryRefund>
</response>