在线咨询
电话 联系电话
400-9999-359
QQ QQ客服
微信 官方微信

退款

1 退款申请

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

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

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

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

 

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 提交参数

示例代码

<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" />

参数名

类型

长度

是否必填

描述

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>