退款

1 退款申请

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

 

1.1 提交参数

示例代码

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

参数名

类型

长度

是否必填

描述

merNo

String

5

Yes

【商户号】

gatewayNo

String

8

Yes

【网关接入号】

signInfo

String

100

Yes

【签名数据】

返回数据为大写.各语言加密方式不同,

详见【附录】sha256加密方式

明文加密结构:merNo + gatewayNo + tradeNo + refundType + signKey

tradeNo

String

30

Yes

【交易流水订单号】

refundType

Int

1

Yes

【退款类型】

1 : 全额退款

2 : 部分退款

tradeAmount

double

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

 

参数名

类型

长度

是否必填

描述

merNo

String

【商户号】

gatewayNo

String

【网关接入号】

signInfo

String

【签名数据】

全为小写.各语言加密方式不同,

详见【附录】sha256加密方式

明文加密结构: merNo + gatewayNo + tradeNo + refundType + signKey

tradeNo

String

【流水订单号】

batchNo

Int

【退款编号】

用于查询退款的唯一 ID。

code

String

【退款结果】

详见【附录】退款申请代码列表

description

String

【退款说明】

详见【附录】退款申请代码列表

refundReason

String

【退款原因】

remark

String

【备注】

 

2 退款明细查询

2.1 提交参数

示例代码

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

参数名

类型

长度

是否必填

描述

merNo

String

5

Yes

【商户号】

gatewayNo

String

8

Yes

【网关接入号】

tradeNo

String

30

Yes

【交易流水号】

merTrackNo

String

50

No

【商户跟踪号】

signInfo

String

100

Yes

【签名数据】

返回数据为大写.各语言加密方式不同,

详见附录 sha256加密方式

明文加密结构:merNo + gatewayNo + tradeNo + refundType + signKey

 

2.2 返回参数

参数名

类型

长度

是否必填

描述

merNo

String

【商户号】

gatewayNo

String

【网关接入号】

tradeNo

String

【交易流水号】

responseCode

String

【接口调用结果】

00代表成功,否则失败

详见【附录】退款明细查询接口调用响应代码列表

responseDesc

String

【调用结果描述】

signInfo

String

【签名数据】

全为小写.各语言加密方式不同,

详见【附录】sha256加密方式

明文加密结构: merNo + gatewayNo + tradeNo + refundType + signKey

以下为循环域,可能包含一笔或多笔退款

merTrackNo

String

【商户跟踪号】

用于唯一标识每一笔退款订单,可通过退款申请接口传入

batchNo

String

【退款编号】

我方退款唯一ID

code

String

【退款结果】

详见【附录】退款状态代码列表

description

String

【退款说明】

详见【附录】退款状态代码列表

currency

String

【币种】

详见【附录】交易币种(ISO 4217)

refundAmount

String

【退款金额】

申请退款的金额

refundReason

String

【退款原因】

 

2.3 返回样例

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <queryRefund>
    <merNo>99999></merNo>     
    <gatewayNo>99999003</gatewayNo>
    <tradeNo>2014xxxxxxxxxx</tradeNo>
    <responseCode>00</responseCode>
    <responseDesc>Interface call success</responseDesc>
	<signInfo>c9e8d6e703085f349107276ad41252ef745baf904e036bd4f26f9c6bb7b36837</signInfo>
    <refundInfos>
      <refundInfo id=”1”>
        <oprTime>2015-05-19 16:57:36</oprTime>
        <code>02</code>
        <description>Pending</description>
        <currency>USD</currency>
        <refundAmount>0.02</refundAmount>
        <refundReason>test</refundReason>
        <merTrackNo>1000001</merTrackNo>
        <batchNo>10001</batchNo>
      </refundInfo>
      <refundInfo id=”2”>
      ……
      </refundInfo>
    </refundInfos>
  </queryRefund>
</response>