请求
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>退款接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/refund/transactions/{voucherNo}</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>method: <code>POST</code></li>
<li>Request Content-Type：<code>application/json</code></li>
<li>Response Content-Type：<code>application/json</code></li>
</ul>
<h5>退款请求参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">secretId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>由平台统一生成发放</td>
</tr>
<tr>
<td style="text-align: left;">sandbox</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(32)</td>
<td>沙盒模式，当值为 <strong>sandbox</strong> 时， 为测试模式，需要生成测试秘钥，为其他值时为生产模式</td>
</tr>
<tr>
<td style="text-align: left;">transType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>交易类型 20: 退款</td>
</tr>
<tr>
<td style="text-align: left;">tag</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(100)</td>
<td>透传参数，原样返回用于商户标记订单</td>
</tr>
<tr>
<td style="text-align: left;">nonceStr</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(50)</td>
<td>随机字符串</td>
</tr>
<tr>
<td style="text-align: left;">signature</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(255)</td>
<td>加密值，参照加密说明</td>
</tr>
<tr>
<td style="text-align: left;">outOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(50)</td>
<td>外部订单号(商户订单号，原样返回)</td>
</tr>
<tr>
<td style="text-align: left;">orderCurrency</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(10)</td>
<td>退款币种</td>
</tr>
<tr>
<td style="text-align: left;">orderAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(12)</td>
<td>退款金额</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(255)</td>
<td>退款原因</td>
</tr>
</tbody>
</table>
<h5>退款请求参数示例</h5>
<pre><code>{
&quot;secretId&quot;: &quot;pgw_8JzeoYgwIaXhKV-QATgkt6sYOYSBQRXt&quot;,
&quot;nonceStr&quot;: &quot;adfasdfasdf&quot;,
&quot;signature&quot;: &quot;0784f92b8a3ade8d897fdc2da315b03b147a74138b6a791e8630a63f72410ef3&quot;,
&quot;outOrderNo&quot;: &quot;test-refund-123&quot;,
&quot;orderCurrency&quot;: &quot;USD&quot;,
&quot;orderAmount&quot;: &quot;3.14&quot;,
&quot;transType&quot;:&quot;20&quot;,
&quot;remark&quot;: &quot;test&quot;,
&quot;tag&quot;: &quot;0000&quot;
}</code></pre>
<h5>退款返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">secretId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>由平台统一生成发放</td>
</tr>
<tr>
<td style="text-align: left;">sandbox</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(32)</td>
<td>沙盒模式，当值为 <strong>sandbox</strong> 时， 为测试模式，需要生成测试秘钥，为其他值时为生产模式</td>
</tr>
<tr>
<td style="text-align: left;">transType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>交易类型 20: 退款</td>
</tr>
<tr>
<td style="text-align: left;">tag</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(100)</td>
<td>透传参数，原样返回用于商户标记订单</td>
</tr>
<tr>
<td style="text-align: left;">nonceStr</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(50)</td>
<td>随机字符串</td>
</tr>
<tr>
<td style="text-align: left;">signature</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(255)</td>
<td>加密值，参照加密说明</td>
</tr>
<tr>
<td style="text-align: left;">outOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(50)</td>
<td>外部订单号(商户订单号，原样返回)</td>
</tr>
<tr>
<td style="text-align: left;">orderCurrency</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(10)</td>
<td>退款币种</td>
</tr>
<tr>
<td style="text-align: left;">orderAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(12)</td>
<td>退款金额</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(255)</td>
<td>退款原因</td>
</tr>
<tr>
<td style="text-align: left;">transNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(50)</td>
<td>交易订单号</td>
</tr>
<tr>
<td style="text-align: left;">transStatus</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>交易状态 00: 未支付，10：成功，20：待处理，21：待确认，30：失败，31：失败，风控拒绝，32：失败，过期取消</td>
</tr>
<tr>
<td style="text-align: left;">transCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>交易代码</td>
</tr>
<tr>
<td style="text-align: left;">transMessage</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(500)</td>
<td>交易说明</td>
</tr>
<tr>
<td style="text-align: left;">voucherNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(50)</td>
<td>退款凭证号</td>
</tr>
<tr>
<td style="text-align: left;">cardType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>卡种，00：N/A ，10：Visa，20：MasterCard，30：JCB，40：Amex，50：DinersClub，60：EnRoute，70：Discover</td>
</tr>
<tr>
<td style="text-align: left;">transVoucher</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Object</td>
<td>关联交易信息</td>
</tr>
<tr>
<td style="text-align: left;">&nbsp;&nbsp;transNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(50)</td>
<td>交易订单号</td>
</tr>
<tr>
<td style="text-align: left;">&nbsp;&nbsp;voucherNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(50)</td>
<td>交易凭证号</td>
</tr>
<tr>
<td style="text-align: left;">&nbsp;&nbsp;outOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(50)</td>
<td>外部订单号(商户订单号，原样返回)</td>
</tr>
<tr>
<td style="text-align: left;">&nbsp;&nbsp;orderCurrency</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(10)</td>
<td>交易币种</td>
</tr>
<tr>
<td style="text-align: left;">&nbsp;&nbsp;orderAmount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(12)</td>
<td>交易金额</td>
</tr>
<tr>
<td style="text-align: left;">&nbsp;&nbsp;transTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(50)</td>
<td>交易时间 格式为 yyyy-MM-ddTHH:mm:ss</td>
</tr>
</tbody>
</table>
<h5>退款返回参数示例</h5>
<pre><code>{
&quot;secretId&quot;: &quot;pgw_8JzeoYgwIaXhKV-QATgkt6sYOYSBQRXt&quot;,
&quot;paymentMethod&quot;: &quot;CR01&quot;,
&quot;outOrderNo&quot;: &quot;test-refund-123&quot;,
&quot;orderCurrency&quot;: &quot;USD&quot;,
&quot;orderAmount&quot;: &quot;3.14&quot;,
&quot;transType&quot;: &quot;20&quot;,
&quot;nonceStr&quot;: &quot;0brf7ja32hsrjyl0b67tnv2vye7o60l2&quot;,
&quot;signature&quot;: &quot;3b5099f09bddc7c24a6f237eafc9e42e481189b150a901bc8a369856a0c4b1d4&quot;,
&quot;tag&quot;: &quot;0000&quot;,
&quot;transNo&quot;: &quot;T2023052711094132954141&quot;,
&quot;transStatus&quot;: &quot;20&quot;,
&quot;transCode&quot;: &quot;C0100&quot;,
&quot;transMessage&quot;: &quot;send bank error&quot;,
&quot;voucherNo&quot;: &quot;RV2023060912003342761720&quot;,
&quot;cardType&quot;: &quot;20&quot;,
&quot;remark&quot;: &quot;test&quot;,
&quot;transVoucher&quot;: {
&quot;transNo&quot;: &quot;T2023052711094132954141&quot;,
&quot;voucherNo&quot;: &quot;V2023052711094332669679&quot;,
&quot;outOrderNo&quot;: &quot;test-001&quot;,
&quot;orderCurrency&quot;: &quot;USD&quot;,
&quot;orderAmount&quot;: &quot;12.56&quot;,
&quot;transTime&quot;: &quot;2023-05-27T11:09:41&quot;
}
}</code></pre>