优惠券卡信息查询
<p><strong>接口描述：</strong> </p>
<ul>
<li>优惠券卡信息查询</li>
</ul>
<p><strong>接口URL：</strong> </p>
<ul>
<li><code>https://open.gdyfsk.com/yfpay/coupon/cardQuery</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>10011.悦享福利，10012.广发银行，10013.聚优</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;">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:冻结，1:正常</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>
<tr>
<td style="text-align: left;">balance</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">余额（单位：分）</td>
<td>9899</td>
</tr>
<tr>
<td style="text-align: left;">card_num</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">卡号/优惠券码</td>
<td>9990121417057291</td>
</tr>
<tr>
<td style="text-align: left;">expiry_date</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">有效期</td>
<td>20231231</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">卡券类型（1：蛋糕卡，4：蛋糕小券）</td>
<td>1</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;: &quot;SUCCESS&quot;,
&quot;result_code&quot;: &quot;SUCCESS&quot;,
&quot;coupon_code&quot;: &quot;9990121417057291&quot;,
&quot;status&quot;: &quot;1&quot;,
&quot;sign&quot;: &quot;69c127ef124486c07fff51bc0f59b915&quot;,
&quot;balance&quot;: &quot;9899&quot;,
&quot;card_num&quot;: &quot;9990121417057291&quot;,
&quot;expiry_date&quot;: &quot;20231231&quot;,
&quot;type&quot;: &quot;1&quot;
}
</code></pre>