W9-积分冻结
<p><strong>简要描述:</strong></p>
<ul>
<li>会员积分冻结接口,用于冻结会员积分</li>
</ul>
<p><strong>请求URL:</strong></p>
<ul>
<li>正式环境地址 <code>/openapi/v2/member/freezePoint</code></li>
<li>正式环境地址,冻结积分调用,使用测试账号</li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST</li>
<li>HTTP接口</li>
</ul>
<p><strong>请求头 Header: </strong></p>
<table>
<thead>
<tr>
<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;">X-Business-Token</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">见应用场景介绍</td>
<td>string</td>
</tr>
</tbody>
</table>
<p>应用场景: 会员积分冻结业务ID, 冻结会员积分时,用于请求幂等校验,请求头(request header)里需要传:X-Business-Token, 不同请求对应X-BusinessToken值确保唯一;若同一请求,请求多次,确保X-Business-Token值是一样.</p>
<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>类型</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">memberId</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">会员ID(必传)</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">description</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">备注,包括事件类型、事件等信息(必传长度限制255)</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">channelType</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">渠道类型,固定值:WECHAT</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">memberType</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">会员类型: aupres</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">shopCode</td>
<td style="text-align: left;">N</td>
<td style="text-align: left;">店铺编号</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">pointBizType</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">积分业务类型,如:POINT</td>
<td>string</td>
</tr>
<tr>
<td style="text-align: left;">idempotentMode</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">幂等方式,默认:1</td>
<td>Integer</td>
</tr>
<tr>
<td style="text-align: left;">point</td>
<td style="text-align: left;">Y</td>
<td style="text-align: left;">冻结积分值</td>
<td>Double</td>
</tr>
</tbody>
</table>
<p><strong>请求示例:</strong></p>
<pre><code>{
&quot;memberId&quot;: &quot;1c8c34ff77dd4c5a9573644b9d6eecd9&quot;,
&quot;description&quot;: &quot;微信渠道积分冻结&quot;,
&quot;channelType&quot;: &quot;WECHAT&quot;,
&quot;memberType&quot;: &quot;GMYB&quot;,
&quot;shopCode&quot;: &quot;GMYB&quot;,
&quot;pointBizType&quot;: &quot;POINT&quot;,
&quot;idempotentMode&quot;: 1,
&quot;point&quot;: 5.0
}</code></pre>
<p><strong> 响应码: </strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">HTTP Code</th>
<th style="text-align: left;">Description</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">200</td>
<td style="text-align: left;">OK</td>
<td>冻结成功</td>
</tr>
<tr>
<td style="text-align: left;">201</td>
<td style="text-align: left;">Created</td>
<td>冻结成功</td>
</tr>
<tr>
<td style="text-align: left;">204</td>
<td style="text-align: left;">冻结会员积分成功</td>
<td>冻结成功</td>
</tr>
<tr>
<td style="text-align: left;">401</td>
<td style="text-align: left;">Unauthorized</td>
<td>冻结失败</td>
</tr>
<tr>
<td style="text-align: left;">403</td>
<td style="text-align: left;">Forbidden</td>
<td>冻结失败</td>
</tr>
<tr>
<td style="text-align: left;">404</td>
<td style="text-align: left;">Not Found</td>
<td>冻结失败</td>
</tr>
</tbody>
</table>