优惠券核销接口
<p><strong>接口描述：</strong> </p>
<ul>
<li>优惠券核销接口</li>
</ul>
<p><strong>接口URL：</strong> </p>
<ul>
<li><code>https://open.gdyfsk.com/yfpay/coupon/wf</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;">amount</td>
<td style="text-align: left;">string(16)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">抵扣金额（分）</td>
<td>0</td>
</tr>
<tr>
<td style="text-align: left;">write_off_type</td>
<td style="text-align: left;">string(1)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">核销方式 0.仅核销 1.支核一体</td>
</tr>
<tr>
<td style="text-align: left;">real_amount</td>
<td style="text-align: left;">string(16)</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">实际支付金额（分）</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;">dev_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">pos机编号</td>
<td>非必填：10011.悦享福利 如：321654987</td>
</tr>
<tr>
<td style="text-align: left;">pwd</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">卡号的密码 （部分必填）</td>
<td>必填：10011.悦享福利(优惠券码为卡类型时) 如：123456</td>
</tr>
<tr>
<td style="text-align: left;">detail</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">商品详情信息</td>
<td>非必填：（10011.悦享福利 ） 如：[{price=5.00, name=黑森林蛋糕, num=1}, {price=8.00, name=提拉米苏, num=2}]</td>
</tr>
</tbody>
</table>
<p><strong>请求示例：</strong></p>
<ul>
<li>单笔优惠券核销</li>
</ul>
<pre><code class="language-json">{
&quot;couponCode&quot;: &quot;679533922928&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;writeOff_tyep&quot;: &quot;0&quot;,
&quot;amount&quot;: &quot;1000&quot;,
&quot;sign&quot;: &quot;be7e74eef4015f9e87a3e5c480dc0c12&quot;,
&quot;ts&quot;: &quot;20211120154500&quot;,
&quot;dev_no&quot;:&quot;321654987&quot;,
&quot;pwd&quot;:&quot;123456&quot;,
&quot;detail&quot;:&quot;[{price=5.00, name=黑森林蛋糕, num=1}, {price=8.00, name=提拉米苏, num=2}]&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;">amount</td>
<td style="text-align: left;">string(16)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">抵扣金额（分）</td>
</tr>
<tr>
<td style="text-align: left;">settleAmount</td>
<td style="text-align: left;">string(16)</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">结算金额(单位：分)</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;0205&quot;,
&quot;return_msg&quot;: &quot;券码已退款&quot;,
&quot;result_code&quot;: &quot;FAIL&quot;,
&quot;order_no&quot;: null,
&quot;coupon_code&quot;: '679533922928',
&quot;amount&quot;: null,
&quot;settleAmount&quot;: null,
&quot;sign&quot;: &quot;2fb3390f6394c5c81312188883f9c969&quot;
}
</code></pre>