查询
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>退款查询接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/retrieve/refunds</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>
<p>Method: <code>GET</code></p>
</li>
<li>
<p>Request Content-Type：<code>application/x-www-form-urlencoded</code></p>
</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>沙盒模式，当值为 sandbox时， 为测试模式，需要生成测试秘钥，为其他值时为生产模式</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;">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>
</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;nlvl3lyyhgm02z2btjpjms50kh3wj4qq&quot;,
&quot;signature&quot;: &quot;02606b8b12710f864f7a861056b5039c94e126cf2068f7e3868991267025bac2&quot;,
&quot;tag&quot;: &quot;0000&quot;,
&quot;transNo&quot;: &quot;T2023060917135063726148&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;RV2023072411192002444423&quot;,
&quot;cardType&quot;: &quot;20&quot;,
&quot;remark&quot;: &quot;test&quot;,
&quot;transVoucher&quot;: {
&quot;transNo&quot;: &quot;T2023060917135063726148&quot;,
&quot;voucherNo&quot;: &quot;V2023060917135079779931&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-06-09T17:13:51&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>