会员查询(线上会员价)
<h2>接口使用描述</h2>
<h4>方法一:通过手机号,会员卡号等六选一必填 来查询会员</h4>
<h4>方法二:可以用微信、会员授权码直接查询到会员</h4>
<h4>应用场景:1收银软件上直接查询到线上电子会员,走软件商品的会员价</h4>
<h4>2通过扫微信、会员付款码直接识别线上电子会员,走会员价同时发起支付。</h4>
<h4>线下软件查会员界面,刷卡或手动输入会员卡号,按照下面规则判断传参</h4>
<pre><code>①会员输入长度1开头11位按手机号查询,传参手机号 mobile
②会员输入长度1或2 开头的 18位,输入,按付款码查询会员,传参支付授权码authPayCode(此时必传shopNo)
③会员输入长度81开头的18位输入,按付款码查询会员,传参支付授权码authPayCode(此时必传shopNo)
④会员输入长度80开头的18位输入,按会员卡号查询,传参会员卡号memberCardNo
⑤其他输入情况,按实体卡查询,传参physicalCardUid 实体卡uid</code></pre>
<h5>接口地址</h5>
<pre><code>接口地址:https://api.liantuofu.com/open/member/get</code></pre>
<p><br/></p>
<h4>请求参数<img src='<a href="https://www.showdoc.cc/server/api/common/visitfile/sign/bfc24f8d7eb93fae8e66d4ab2b4bc461?showdoc=.jpg">https://www.showdoc.cc/server/api/common/visitfile/sign/bfc24f8d7eb93fae8e66d4ab2b4bc461?showdoc=.jpg</a>' 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>mobile</td>
<td>手机号</td>
<td>string</td>
<td>N</td>
<td>13800000000</td>
<td>(手机号,会员卡号,微信openId,支付宝userId,微信unionId,memberId 六选一必填)</td>
</tr>
<tr>
<td>5</td>
<td>memberCardNo</td>
<td>会员卡号</td>
<td>string</td>
<td>N</td>
<td></td>
<td>会员卡号</td>
</tr>
<tr>
<td>6</td>
<td>openId</td>
<td>微信openId</td>
<td>string</td>
<td>N</td>
<td></td>
<td>微信openId</td>
</tr>
<tr>
<td>7</td>
<td>userId</td>
<td>支付宝userId</td>
<td>string</td>
<td>N</td>
<td></td>
<td>支付宝userId</td>
</tr>
<tr>
<td>8</td>
<td>unionId</td>
<td>微信unionId</td>
<td>string</td>
<td>N</td>
<td></td>
<td>微信unionId</td>
</tr>
<tr>
<td>9</td>
<td>memberId</td>
<td>会员id</td>
<td>string</td>
<td>N</td>
<td></td>
<td>会员id</td>
</tr>
<tr>
<td>10</td>
<td>authPayCode</td>
<td>支付授权码</td>
<td>string</td>
<td>N</td>
<td><font size="3" color="red">微信、会员付款码查询会员方式 <br>扫微信付款码直接识别会员功能</BR></font></td>
<td>支付授权码</td>
</tr>
<tr>
<td>11</td>
<td>shopNo</td>
<td>门店编码</td>
<td>string</td>
<td>N</td>
<td><font size="3" color="red">商盟版本会员查询必传</font></td>
<td>如果填入支付授权码则为必填</td>
</tr>
<tr>
<td>12</td>
<td>physicalCardUid</td>
<td>实体卡uid</td>
<td>string</td>
<td>N</td>
<td></td>
<td>实体卡uid</td>
</tr>
<tr>
<td>13</td>
<td>plateNumber</td>
<td>车牌号</td>
<td>string</td>
<td>N</td>
<td></td>
<td>车牌号</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>subCode</td>
<td>错误代码</td>
<td>string</td>
<td>N</td>
<td>LOGIN_ERROR</td>
<td>如果code为FAILED,subcode会返回详细的错误code,以便错误信息描述的更加精确</td>
</tr>
<tr>
<td>4</td>
<td>subMsg</td>
<td>错误描述</td>
<td>string</td>
<td>N</td>
<td>EW_N2320993253</td>
<td>如果code为FAILED,subMsg会返回详细的错误描述,以便错误信息描述的更加精确</td>
</tr>
<tr>
<td>5</td>
<td>sign</td>
<td>签名</td>
<td>string</td>
<td>Y</td>
<td>1b70687c8a4c72f50c749baf95a482c0</td>
<td>请求时传递的sign</td>
</tr>
<tr>
<td>6</td>
<td>random</td>
<td>随机数</td>
<td>string</td>
<td>Y</td>
<td>123</td>
<td>请求时传递的随机数</td>
</tr>
<tr>
<td>7</td>
<td>member</td>
<td>会员信息</td>
<td>object</td>
<td>Y</td>
<td>{}</td>
<td>会员信息</td>
</tr>
</tbody>
</table>
<h4>member</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>merchantCode</td>
<td>会员所属门店编码</td>
<td>string</td>
<td>Y</td>
<td>EW_N4130797151</td>
<td>门店编码</td>
</tr>
<tr>
<td>2</td>
<td>merchatName</td>
<td>会员所属门店名称</td>
<td>string</td>
<td>Y</td>
<td>测试门店01</td>
<td>会员所属门店名称</td>
</tr>
<tr>
<td>3</td>
<td>superMerchantCode</td>
<td>会员所属核心编码</td>
<td>string</td>
<td>Y</td>
<td>EW_N5946005323</td>
<td>核心编码</td>
</tr>
<tr>
<td>4</td>
<td>memberId</td>
<td>会员id</td>
<td>string</td>
<td>N</td>
<td>1064635</td>
<td>会员id</td>
</tr>
<tr>
<td>5</td>
<td>memberCardNo</td>
<td>会员卡号</td>
<td>string</td>
<td>N</td>
<td>800959102106463555</td>
<td>会员卡号</td>
</tr>
<tr>
<td>6</td>
<td>headImgUrl</td>
<td>头像</td>
<td>string</td>
<td>N</td>
<td><a href="http://thirdwx.qlogo.cn/mmopen/vi_32/fWO1XEswdvQ/132">http://thirdwx.qlogo.cn/mmopen/vi_32/fWO1XEswdvQ/132</a></td>
<td>头像</td>
</tr>
<tr>
<td>7</td>
<td>nickName</td>
<td>昵称</td>
<td>string</td>
<td>N</td>
<td>xxx</td>
<td>昵称</td>
</tr>
<tr>
<td>8</td>
<td>memberName</td>
<td>会员名称</td>
<td>string</td>
<td>Y</td>
<td>会xxx</td>
<td>会员名称</td>
</tr>
<tr>
<td>9</td>
<td>mobile</td>
<td>手机号</td>
<td>string</td>
<td>Y</td>
<td>13800000000</td>
<td>手机号</td>
</tr>
<tr>
<td>10</td>
<td>birthday</td>
<td>会员生日</td>
<td>string</td>
<td>Y</td>
<td>0520</td>
<td>会员生日</td>
</tr>
<tr>
<td>11</td>
<td>levelName</td>
<td>等级名称</td>
<td>string</td>
<td>Y</td>
<td>普通会员</td>
<td>等级名称</td>
</tr>
<tr>
<td>12</td>
<td>exp</td>
<td>经验</td>
<td>string</td>
<td>Y</td>
<td>0</td>
<td>经验</td>
</tr>
<tr>
<td>13</td>
<td>email</td>
<td>邮箱地址</td>
<td>string</td>
<td>N</td>
<td></td>
<td>邮箱地址</td>
</tr>
<tr>
<td>14</td>
<td>totalBalance</td>
<td>余额总额</td>
<td>string</td>
<td>Y</td>
<td>0.0</td>
<td>余额总额</td>
</tr>
<tr>
<td>15</td>
<td>caBalance</td>
<td>实际余额</td>
<td>string</td>
<td>Y</td>
<td>0.0</td>
<td>实际余额</td>
</tr>
<tr>
<td>16</td>
<td>giftBalance</td>
<td>赠送余额</td>
<td>string</td>
<td>Y</td>
<td>0.0</td>
<td>赠送余额</td>
</tr>
<tr>
<td>17</td>
<td>point</td>
<td>积分</td>
<td>string</td>
<td>Y</td>
<td>10</td>
<td>积分</td>
</tr>
<tr>
<td>18</td>
<td>couponCount</td>
<td>卡券数量</td>
<td>string</td>
<td>Y</td>
<td>0</td>
<td>卡券数量</td>
</tr>
<tr>
<td>19</td>
<td>openCardDate</td>
<td>开卡时间</td>
<td>string</td>
<td>Y</td>
<td>2018-11-06 15:39:00</td>
<td>开卡时间</td>
</tr>
<tr>
<td>20</td>
<td>sex</td>
<td>性别 1男 2女</td>
<td>int</td>
<td>N</td>
<td>2</td>
<td>性别 1男 2女</td>
</tr>
<tr>
<td>21</td>
<td>physicalCardUid</td>
<td>实体卡uid</td>
<td>string</td>
<td>N</td>
<td>10000000000</td>
<td>实体卡uid</td>
</tr>
<tr>
<td>22</td>
<td>accumulationConsume</td>
<td>累计消费金额</td>
<td>double</td>
<td>N</td>
<td>1000</td>
<td>累计消费金额</td>
</tr>
<tr>
<td>23</td>
<td>consumTimes</td>
<td>累计消费次数</td>
<td>int</td>
<td>N</td>
<td>100</td>
<td>累计消费次数</td>
</tr>
<tr>
<td>24</td>
<td>accumulationRecharge</td>
<td>累计充值金额</td>
<td>double</td>
<td>N</td>
<td>10000</td>
<td>累计充值金额</td>
</tr>
<tr>
<td>25</td>
<td>accumulationGiveRecharge</td>
<td>累计充值赠送金额</td>
<td>double</td>
<td>N</td>
<td>1000</td>
<td>累计充值赠送金额</td>
</tr>
<tr>
<td>26</td>
<td>rechargeTimes</td>
<td>累计充值次数</td>
<td>double</td>
<td>N</td>
<td>100</td>
<td>累计充值次数</td>
</tr>
<tr>
<td>27</td>
<td>lastConsumDate</td>
<td>最后一次消费时间</td>
<td>string</td>
<td>N</td>
<td></td>
<td>最后一次消费时间</td>
</tr>
<tr>
<td>28</td>
<td>lastConsumAmount</td>
<td>最后一次消费金额</td>
<td>double</td>
<td>N</td>
<td>100</td>
<td>最后一次消费时间</td>
</tr>
<tr>
<td>29</td>
<td>lastConsumShopName</td>
<td>最后一次消费门店</td>
<td>string</td>
<td>N</td>
<td>测试门店</td>
<td>最后一次消费时间</td>
</tr>
<tr>
<td>30</td>
<td>lastBuyGoodsNum</td>
<td>最后一次购买商品数</td>
<td>int</td>
<td>N</td>
<td>2</td>
<td>最后一次消费时间</td>
</tr>
<tr>
<td>31</td>
<td>levelId</td>
<td>等级ID</td>
<td>string</td>
<td>Y</td>
<td>1411</td>
<td>会员等级ID</td>
</tr>
</tbody>
</table>
<p><br/><br/></p>
<h5>请求示例:</h5>
<pre><code>appId=EW_N5946005323&amp;openId=oHucvv64jHMx6hXbPRIdI2FXI_i4&amp;random=123&amp;sign=52503c163b9286eedbc0b6e08a3d1273</code></pre>
<h5>响应示例(成功):</h5>
<pre><code class="language-json">{
&quot;member&quot;:{
&quot;physicalCardUid&quot;:&quot;123dsdf&quot;,
&quot;merchantCode&quot;:&quot;SC_I2528987310&quot;,
&quot;superMerchantCode&quot;:&quot;SC_I5640724439&quot;,
&quot;memberId&quot;:69393,
&quot;memberCardNo&quot;:&quot;800787604076939300&quot;,
&quot;headImgUrl&quot;:&quot;&quot;,
&quot;nickName&quot;:&quot;&quot;,
&quot;memberName&quot;:&quot;wwww&quot;,
&quot;mobile&quot;:&quot;15433234568&quot;,
&quot;levelName&quot;:&quot;100等级&quot;,
&quot;exp&quot;:101,
&quot;email&quot;:&quot;&quot;,
&quot;totalBalance&quot;:0,
&quot;caBalance&quot;:0,
&quot;giftBalance&quot;:0,
&quot;point&quot;:101,
&quot;couponCount&quot;:0,
&quot;openCardDate&quot;:&quot;2018-11-26 15:47:30&quot;
},
&quot;code&quot;:&quot;SUCCESS&quot;,
&quot;msg&quot;:&quot;查询成功&quot;
}</code></pre>
<h5>响应示例(失败):</h5>
<pre><code class="language-json">{
&quot;code&quot;:&quot;FAILED&quot;,
&quot;msg&quot;:&quot;无效的APPID&quot;,
&quot;subCode&quot;:&quot;APPID_ERROR&quot;,
&quot;subMsg&quot;:&quot;APPID 参数错误&quot;
}</code></pre>
<h5>错误码</h5>
<table>
<thead>
<tr>
<th>错误码</th>
<th>错误描述</th>
<th>建议处理</th>
</tr>
</thead>
<tbody>
<tr>
<td>APPID_ERROR</td>
<td>APPID 参数错误</td>
<td>核实自己的appid是否正确</td>
</tr>
</tbody>
</table>
<h2>线下软件上查询线上电子会员的说明</h2>
<h4>1.线下软件可以在软件的会员查询页,直接输入会员卡号、手机号、刷实体卡调用接口查询到线上线上电子会员会员</h4>
<h4>展示余额、积分、优惠券、消费次数等信息到页面。查到会员后,同时可以增加按钮直接扣款和充值功能。</h4>
<h4>2.通过微信付款码扫商品页面快捷支付可以直接识别该微信注册的会员,同时付款。参照扫微信付款码查询会员功能</h4>
<h4>3.可以在线下软件会员等级(会员类型)增加一个字段存放线上电子会员会员等级id,用于查到线上电子会员会员后,对应匹配到线下软件会员类等级,走对应的会有价,会员折扣。</h4>
<h4>如下图(左图为某线下软件的会员等级设置,增加了线上电子会员等级id存放位置,右图为线上电子会员后台的会员等级id截图)</h4>
<h4>客户在使用这个软件时 可以自定义填写线上电子会员等级id对应什么会员等级,走不同的会员价。</h4>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/b259812a3657cabeeb0152cc38ad7ab2" alt="" /></p>
<h2>扫微信付款码/会员付款码识别会员并支付说明</h2>
<h4>1通过微信付款码/会员付款码扫商品页面快捷支付可以直接通过会员查询接口识别该微信注册的会员,查询后,走会员价和会员折扣。</h4>
<h4>2查询结束后,通过微信付款码/会员付款码在发起支付。</h4>
<h4>3.实现效果扫微信付款码/会员付款码直接识别会员和支付</h4>