星灿接收服务发放信息
<p>[TOC]</p>
<h5>简要描述</h5>
<p>合作方调用该接口进行服务商品的实时发放,如果校验通过,实时返回成功,星灿会给客户对应的手机号码发送一条短信,引导查看和使用服务。</p>
<h5>请求URL</h5>
<p>测试环境 <a href="https://iosapipre.cnsuning.com/servicegoodsgrant?MerchantNo=申请分配&sign=xxx">https://iosapipre.cnsuning.com/servicegoodsgrant?MerchantNo=申请分配&sign=xxx</a>
生产环境 <a href="https://iosapi.suning.com/servicegoodsgrant?MerchantNo=申请分配&sign=xxx">https://iosapi.suning.com/servicegoodsgrant?MerchantNo=申请分配&sign=xxx</a></p>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>参数</h5>
<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;">MerchantNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>接入商户号,由星灿分配</td>
</tr>
<tr>
<td style="text-align: left;">MerchantOrderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户侧唯一订单号;如果同一个订单号重复请求,则会幂等返回上一次的结果</td>
</tr>
<tr>
<td style="text-align: left;">ServiceGoodsCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>服务商品编码,联调时由星灿提供</td>
</tr>
<tr>
<td style="text-align: left;">MerchantSalesPrice</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>在合作方前台服务销售的价格,以分为单位;如果是商户集采赠送顾客,该值可传0</td>
</tr>
<tr>
<td style="text-align: left;">MerchantSettlementPrice</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>合作方商户给星灿的服务结算价,以分为单位;如果是免费服务,该值可传0</td>
</tr>
<tr>
<td style="text-align: left;">MerchantMemberNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户侧会员号</td>
</tr>
<tr>
<td style="text-align: left;">MemberMobile</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户手机号</td>
</tr>
<tr>
<td style="text-align: left;">MemberName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>客户姓名;针对需要实名发放的服务,姓名、身份证号必传</td>
</tr>
<tr>
<td style="text-align: left;">MemberCardNo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>客户身份证号</td>
</tr>
<tr>
<td style="text-align: left;">MemberAddress</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>客户服务地址,针对需要上门进行的服务,如有客户家庭地址信息,可传</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code> {
&quot;MerchantNo&quot;: &quot;50000000&quot;,
&quot;OrderNo&quot;: &quot;2023051648444549&quot;,
&quot;GoodsCode&quot;: &quot;FW1201&quot;,
&quot;SalesPrice&quot;: &quot;500&quot;,
&quot;SettlementPrice&quot;: &quot;100&quot;,
&quot;MerchantMemberNo&quot;: &quot;RY00311889&quot;,
&quot;MemberMobile&quot;: &quot;167651557577&quot; ,
&quot;MemberName&quot;: &quot;王小二&quot; ,
&quot;MemberCardNo&quot;: &quot;210302199010101010&quot; ,
&quot;MemberAddress&quot;: &quot;江苏省南京市苏宁大道1号苏宁总部&quot; ,
}
</code></pre>
<h5>返回参数说明</h5>
<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;">Code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>500失败;200成功;服务发放成功后,会提供服务详情地址</td>
</tr>
<tr>
<td style="text-align: left;">Message</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>失败原因</td>
</tr>
<tr>
<td style="text-align: left;">LinkUrl</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>服务详情H5 url</td>
</tr>
<tr>
<td style="text-align: left;">AppId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>小程序appid</td>
</tr>
<tr>
<td style="text-align: left;">AppletUrl</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>服务详情小程序path路径</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code> {
&quot;Code&quot;: &quot;200&quot;,
&quot;message&quot;: &quot;&quot;,
&quot;LinkUrl&quot;: &quot;https://issm.snisc.cn/secret/myBenefit.htm&quot;,
&quot;AppId&quot;: &quot;wx80ed3c0c3fc7aafb&quot;,
&quot;AppletUrl&quot;: &quot;pages/product/bx/myInst/myInst&quot;,
}
</code></pre>
<h5>备注</h5>
<ul>
<li>安全机制见[公共说明](<a href="https://www.showdoc.com.cn/snisc/9805767650650643">https://www.showdoc.com.cn/snisc/9805767650650643</a> "公共说明")</li>
</ul>