撤销接口
<p><strong>接口描述:</strong> </p>
<ul>
<li>撤销接口,仅用于付款码支付(B扫C),扫码支付未完成支付,订单状态处于支付中,轮询结束时,可以调用此接口撤销交易,如果此订单用户支付失败,会将此订单关闭;如果用户支付成功,支付系统会将此订单资金退还给用户。</li>
<li>其他正常支付的单如需实现相同功能请调用退款接口。</li>
</ul>
<p><strong>接口URL:</strong>
测试 <code>https://test.gdyfsk.com/yfpay/v3/cancelorder</code>
正式 <code>https://open.gdyfsk.com/yfpay/v3/cancelorder</code></p>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>请求头部:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">标签</th>
<th style="text-align: left;">必填</th>
<th>内容</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Content-Type</td>
<td style="text-align: left;">是</td>
<td>application/json</td>
</tr>
</tbody>
</table>
<p><strong>请求参数:</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<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;">inst_no</td>
<td style="text-align: left;">string(8)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">机构号,系统分配</td>
<td>900075</td>
</tr>
<tr>
<td style="text-align: left;">mch_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户号</td>
<td>Y52211090004</td>
</tr>
<tr>
<td style="text-align: left;">cancel_trace_no</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">撤销请求流水号 建议uuid即可 或者商户撤销单号 商户系统不重复</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">cancel_time</td>
<td style="text-align: left;">string(14)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">撤销请求时间yyyyMMddHHmmss</td>
<td>2018116165053</td>
</tr>
<tr>
<td style="text-align: left;">trade_no</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;">订单号(与支付请求流水号二选一)</td>
<td style="text-align: left;">20000002814118090716435200001</td>
</tr>
<tr>
<td style="text-align: left;">pay_trace_no</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;">支付请求流水号(与订单号二选一)</td>
<td style="text-align: left;">51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">pay_time</td>
<td style="text-align: left;">string(14)</td>
<td style="text-align: left;">支付请求时间,可与支付请求流水号联合查询</td>
<td style="text-align: left;">2018116165053</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">签名</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
</tbody>
</table>
<p><strong>请求示例:</strong></p>
<pre><code class="language-json">{
&quot;inst_no&quot;: 900075,
&quot;mch_no&quot;: &quot;Y52211090004&quot;,
&quot;cancel_trace_no&quot;: &quot;11222323331323322&quot;,
&quot;cancel_time&quot;: &quot;20780907150901&quot;,
&quot;trade_no&quot;: &quot;20000002814118090716435200001&quot;,
&quot;sign&quot;: &quot;6e461f5c95c055b3aed017b8fcb8a1a9&quot;
}</code></pre>
<p><strong>返回参数:</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<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;">return_code</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">返回参数 成功 为SUCCESS 失败为FAIL</td>
<td>SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">return_msg</td>
<td style="text-align: left;">string(128)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">返回消息提示 撤销成功,撤销失败等</td>
</tr>
<tr>
<td style="text-align: left;">result_code</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">只有在return_code为SUCCESS时有返回,PAY_SUCEESS为撤销成功,PAY_FAIL为撤销失败</td>
<td>PAY_SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">cancel_trace_no</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">撤销流水号</td>
<td>113332313422343003</td>
</tr>
<tr>
<td style="text-align: left;">cancel_time</td>
<td style="text-align: left;">string(14)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">撤销时间</td>
<td></td>
</tr>
<tr>
<td style="text-align: left;">pay_trace_no</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">支付请求流水号</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
<tr>
<td style="text-align: left;">pay_time</td>
<td style="text-align: left;">string(14)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">支付请求时间</td>
<td>2018116165053</td>
</tr>
<tr>
<td style="text-align: left;">trade_no</td>
<td style="text-align: left;">string(64)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">订单号</td>
<td>20000002814118090716435200001</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">签名字符串</td>
<td>51c7d68424e5492199cf7f4734a2b977</td>
</tr>
</tbody>
</table>