核销接口
<p><strong>接口描述：</strong> </p>
<ul>
<li>核销接口</li>
</ul>
<p><strong>接口URL：</strong> </p>
<ul>
<li><code>https://open.51shoubei.com/openpay/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;">wf_trace_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">核销流水号</td>
<td>843d920a-2c0f-e3b4-eebc-9d2dd5887ce2</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>20200406005530</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.东福，10002.口碑，10003.抖音，10004.美团，10005.苏打优选，10006.熊猫优福，10007.品诺福利，10008.中票优品，10009.可伴，10013.惠码通</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;">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;">exc_discount_flag</td>
<td style="text-align: left;">string(1)</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">是否参与独立优惠 1-是； 0-否（不填默认 0-否）；如果已享受独立优惠则不可核销苏打/可伴券；未享受独立优惠则不影响核销</td>
<td>0</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;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;
}</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;">wf_trace_no</td>
<td style="text-align: left;">string(32)</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">核销流水号</td>
<td>843d920a-2c0f-e3b4-eebc-9d2dd5887ce2</td>
</tr>
<tr>
<td style="text-align: left;">codes</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;">settle_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>
</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;codes&quot;: &#039;679533922928&#039;,
&quot;amount&quot;: null,
&quot;settleAmount&quot;: null,
&quot;sign&quot;: &quot;2fb3390f6394c5c81312188883f9c969&quot;
}
</code></pre>