优惠券信息查询
<p><strong>接口描述：</strong> </p>
<ul>
<li>优惠券信息查询</li>
</ul>
<p><strong>接口URL：</strong> </p>
<ul>
<li><code>https://open.gdyfsk.com/yfpay/coupon/query</code></li>
</ul>
<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>900024</td>
</tr>
<tr>
<td style="text-align: left;">merchant_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">商户号</td>
<td>851811130002</td>
</tr>
<tr>
<td style="text-align: left;">shop_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">门店号</td>
<td>862010110001</td>
</tr>
<tr>
<td style="text-align: left;">ts</td>
<td style="text-align: left;">string(14)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">时间戳</td>
<td>1709617787754</td>
</tr>
<tr>
<td style="text-align: left;">coupon_code</td>
<td style="text-align: left;">string(16)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">优惠券码</td>
<td>679533922928</td>
</tr>
<tr>
<td style="text-align: left;">channel_type</td>
<td style="text-align: left;">string(5)</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">通道类型</td>
<td>10001.东福，10005.苏打优选，10006.熊猫优福，10007.品诺福利，10008.中票优品，10009.可伴，10010.平安银行，10011.悦享福利，10012.广发银行，10013.聚优，10014.支付宝本地生活</td>
</tr>
<tr>
<td style="text-align: left;">order_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">核销记录号</td>
<td>21000000101121120816432880001</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>
<ul>
<li>优惠券信息查询</li>
</ul>
<pre><code class="language-json">{
&quot;coupon_code&quot;: &quot;925372304962&quot;,
&quot;inst_no&quot;: &quot;60000001&quot;,
&quot;merchant_no&quot;: &quot;851811130002&quot;,
&quot;shop_no&quot;:&quot;862010110001&quot;,
&quot;channel_type&quot;: &quot;10001&quot;,
&quot;sign&quot;: &quot;2c77c498af9a21924232227ad6dd0d04&quot;,
&quot;ts&quot;: &quot;20211120154500&quot;,
&quot;order_no&quot;:&quot;516375643352141195430506&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>
<td>操作成功</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;">业务结果：SUCCESS ，FAIL，只有在return_code为SUCCESS时才会返回</td>
<td>SUCCESS</td>
</tr>
<tr>
<td style="text-align: left;">order_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">核销记录号</td>
<td>516375643352141195430506</td>
</tr>
<tr>
<td style="text-align: left;">coupon_code</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">优惠券号</td>
<td>679533922928</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">string(1)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">优惠券状态</td>
<td>1：未使用，2：已出售，3：已兑换，4：已过期，5：已退款，6：处理失败</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>
<ul>
<li>成功返回结果：</li>
</ul>
<pre><code class="language-json">{
&quot;return_code&quot;: &quot;SUCCESS&quot;,
&quot;return_msg&quot;: null,
&quot;result_code&quot;: &quot;SUCCESS&quot;,
&quot;order_no&quot;: &quot;516375643912141195430857&quot;,
&quot;coupon_code&quot;: &quot;925372304962&quot;,
&quot;status&quot;: &quot;3&quot;,
&quot;sign&quot;: &quot;d3c934bbf1fae3a6a3dad48170f653ce&quot;
}
</code></pre>