核销兑换卷详情
<h5>接口使用描述</h5>
<pre><code>核销兑换卷详情</code></pre>
<h5>接口地址</h5>
<pre><code>接口地址：http(s)://api.liantuofu.com/open/coupon/giftQuery</code></pre>
<p><br/></p>
<h4>请求参数<img src='https://www.showdoc.cc/server/api/common/visitfile/sign/bfc24f8d7eb93fae8e66d4ab2b4bc461?showdoc=.jpg' align='right' style=' width:300px;height:100 px'/></h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>appId</td>
<td>合作方标识</td>
<td>string</td>
<td>Y</td>
<td>EW_N2949193174</td>
<td>合作商户编码，用于以后所有接口发起请求时验签使用</td>
</tr>
<tr>
<td>2</td>
<td>sign</td>
<td>签名。具体参见“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=673453270295568">签名规则</a>”</td>
<td>string</td>
<td>Y</td>
<td>1b70687c8a4c72f50c749baf95a482c0</td>
<td>MD5加密验签值。具体参见“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=673453270295568">签名规则</a>”</td>
</tr>
<tr>
<td>3</td>
<td>random</td>
<td>随机数</td>
<td>string</td>
<td>Y</td>
<td>123</td>
<td>用来增加加密验签的复杂度，长度不限制，只限制传递数字，不支持中文，字母，特殊符号。</td>
</tr>
<tr>
<td>4</td>
<td>merchantCode</td>
<td>商户编号</td>
<td>string</td>
<td>N</td>
<td></td>
<td>商户编号</td>
</tr>
<tr>
<td>5</td>
<td>couponNo</td>
<td>优惠券号</td>
<td>string</td>
<td>Y</td>
<td>13800000000</td>
<td>优惠券号</td>
</tr>
<tr>
<td>6</td>
<td>operatorId</td>
<td>操作员id</td>
<td>string</td>
<td>N</td>
<td>111</td>
<td>操作员id</td>
</tr>
</tbody>
</table>
<h4>响应参数</h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>code</td>
<td>结果</td>
<td>string</td>
<td>Y</td>
<td>SUCCESS</td>
<td>结果码 SUCCESS：成功 FAILED：失败</td>
</tr>
<tr>
<td>2</td>
<td>msg</td>
<td>结果描述</td>
<td>string</td>
<td>Y</td>
<td>登陆成功</td>
<td>无论是成功或者失败，message都会针对于当前的结果返回响应的结果描述</td>
</tr>
<tr>
<td>3</td>
<td>couponName</td>
<td>优惠券名称</td>
<td>string</td>
<td>Y</td>
<td>乳酸菌兑换券</td>
<td>优惠券名称（查询成功时返回）</td>
</tr>
<tr>
<td>4</td>
<td>phone</td>
<td>会员电话</td>
<td>string</td>
<td>Y</td>
<td>15263670688</td>
<td>会员电话（查询成功，且持有者是会员时返回）</td>
</tr>
<tr>
<td>5</td>
<td>memberName</td>
<td>会员名称</td>
<td>string</td>
<td>Y</td>
<td>凌燕</td>
<td>会员名称（查询成功，且持有者是会员时返回）</td>
</tr>
<tr>
<td>6</td>
<td>couponNo</td>
<td>优惠券编号</td>
<td>string</td>
<td>Y</td>
<td>903710213244044413</td>
<td>优惠券编号（查询成功时返回）</td>
</tr>
<tr>
<td>7</td>
<td>termOfValidity</td>
<td>有效期</td>
<td>string</td>
<td>Y</td>
<td>2018-09-14--2018-10-13</td>
<td>有效期（查询成功时返回）</td>
</tr>
<tr>
<td>8</td>
<td>status</td>
<td>优惠券状态</td>
<td>number</td>
<td>Y</td>
<td>2</td>
<td>0未生效 1可使用 2已使用 3已失效 4已过期</td>
</tr>
</tbody>
</table>
<p><br/><br/></p>
<h5>请求示例:</h5>
<pre><code>random=liantuo123&merchantCode=SC_I5640724439&appId=EW_N5946005323&sign=2740d128c82e16d33a95a059ca39545e&couponNo=1515151515&operatorId=1</code></pre>
<h5>响应示例（成功）：</h5>
<pre><code class="language-json">{
"couponName":"乳酸菌兑换券",
"phone":"15263670688",
"memberName":"凌燕",
"couponNo":"903710213244044413",
"termOfValidity":"2018-09-14--2018-10-13",
"status":1,
"code":"SUCCESS",
"msg":"查询成功"
}</code></pre>
<h5>响应示例（失败）：</h5>
<pre><code class="language-json">{
"code":"FAILED",
"msg":"查询失败",
}</code></pre>