开发者
退款
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、返回参数
<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 |
|
|
【商户号】 |
|
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 |
|
|
【退款原因】 |
<?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>
联系电话
400-9999-359
官方微信