会员接通指南
<h3>会员接通功能一栏表</h3>
<table>
<thead>
<tr>
<th>会员功能</th>
<th>对应接口</th>
<th>软件上使用效果</th>
</tr>
</thead>
<tbody>
<tr>
<td>会员等级</td>
<td>线下软件的会员等级和线上会员等级映射</td>
<td>软件上会员等级位置可以直接设置线上会员等级id，软件的每个会员等级都可以对应一个线上的会员等级</td>
</tr>
<tr>
<td>会员查询</td>
<td>/open/member/get</td>
<td>1软件上可以查询到线上会员 2可以走软件商品会员价、会员折扣 <br>3查询到的会员根据线下映射的会员等级走不同会员价</br></td>
</tr>
<tr>
<td>会员查询</td>
<td>/open/member/get</td>
<td>扫微信付款码直接识别会员走会员价并支付，优势功能不需要问客户是不是会员</td>
</tr>
<tr>
<td>会员被扫授权码获得</td>
<td>/open/member/payAuthCode</td>
<td>使用手机号、或实体卡uid查询到会员卡并发起支付</td>
</tr>
<tr>
<td>会员修改</td>
<td>/open/member/modify</td>
<td>按软件上商品的积分规则，给线上会员直接积分，<FONT SIZE='3' COLOR='GREEN'>积分换购余额适用（即积分减少余额增加）</FONT></td>
</tr>
<tr>
<td>会员充值</td>
<td>/open/pay</td>
<td>扫微信、支付宝付款码支付完成会员的充值</td>
</tr>
<tr>
<td>会员充值</td>
<td>/open/precreate</td>
<td>现金充值</td>
</tr>
<tr>
<td>会员注册</td>
<td>/open/member/regist</td>
<td>软件上直接用手机号注册线上会员,注册时候可以写入实体卡片的卡号</td>
</tr>
<tr>
<td>记账小票</td>
<td>erp软件前台流水、交班、结账小票<br>后台对应的支付报表增加会员信息</br></td>
<td>银软件使用会员支付后记账说明</td>
</tr>
</tbody>
</table>
<h3>1会员等级映射</h3>
<h4>线下软件会员类型页面，增加一个字段存放线上会员等级id,商家使用时手动维护。</h4>
<h4>用来实现查询线上会员后，对应线下的不同会员等级，享受不同会员价、折扣。</h4>
<p>图左为线下软件截图，图右为线上会员后台（houtai.liantuofu.com）
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/2418d995a0f5ad92476d0a215ba8f628" alt="" /></p>
<h3>2[会员查询](<a href="https://www.showdoc.com.cn/liantuofu/1573818719557973">https://www.showdoc.com.cn/liantuofu/1573818719557973</a> "会员查询")（👈👈点击文字查看接口详情）</h3>
<p>接口参照：会员查询接口
/open/member/get</p>
<p>查会员可以支持 手机号、付款码、实体卡号、会员卡号查询
可通过客户输入的位数和长度做判断，实体卡号一般是用户主动绑定的 大部分为实体卡对应卡号，根据实际情况判断即可。
规则参照如下
①会员输入长度1开头11位按手机号查询，传参手机号 mobile
②会员输入长度1或2 开头的18位输入，按付款码查询会员，传参支付授权码authPayCode（此时必传shopNo）
③会员输入长度81开头的18位输入，按付款码查询会员，传参支付授权码authPayCode（此时必传shopNo）
④会员输入长度80开头的18位输入，按会员卡号查询，传参会员卡号memberCardNo
⑤其他输入情况，按实体卡查询，传参physicalCardUid 实体卡uid</p>
<p>具体的字段对应接口如下</p>
<p>mobile 手机号
memberCardNo 会员卡号
memberId 会员id（每个会员有且仅有一个id 可以区分会员使用）
authPayCode 支付付款码 （使用付款码查询会员时候，必须传门店编码shopNo）
physicalCardUid 实体卡uid</p>
<h4>软件页面可以查询到线上会员</h4>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/535865c048bbfff9ac53e792fc6d7e93" alt="" /></p>
<h4>通过手动输入或实体卡刷卡识别会员后，展示对应会员信息</h4>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/ef5e24527a3808231da9341ac32730ef" alt="" /></p>
<h4>不同会员等级享受会员价不同</h4>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/b6fbbf0fc2e6ee3a134f30a90ce49742" alt="" /></p>
<h3>3扫微信付款码直接查询会员并支付</h3>
<p>扫商品页面，扫微信付款码，识别会员走会员价，自动支付。
扫微信付款码自动识别会员功能（识别后走会员价）
参照接口
[会员查询/open/member/get](<a href="https://www.showdoc.com.cn/liantuofu/1573818719557973">https://www.showdoc.com.cn/liantuofu/1573818719557973</a> "会员查询")（👈👈点击文字查看接口详情）
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/36fe1b03d4586f5d2715a1e1127a831a" alt="" />
[被扫支付open/pay ](<a href="https://www.showdoc.com.cn/liantuofu/651360832965895">https://www.showdoc.com.cn/liantuofu/651360832965895</a> "被扫支付")(👈👈点击文字查看接口详情)</p>
<h3>4查到线上会员后，直接支付</h3>
<p>参照接口</p>
<h4>①调用接口，通过手机号或实体卡uid获取会员支付授权码</h4>
<p>特别说明实体卡uid可以存放线下的实体的卡号，从而实现线上实体卡刷卡。
[/open/member/payAuthCode 会员支付授权码](<a href="https://www.showdoc.com.cn/liantuofu/1573728071667040">https://www.showdoc.com.cn/liantuofu/1573728071667040</a> "/open/member/payAuthCode 会员支付授权码")</p>
<h4>②上一步获得的会员支付授权码后，调用被扫支付接口，发起支付</h4>
<p>[/open/pay 被扫支付](<a href="https://www.showdoc.com.cn/liantuofu/651360832965895">https://www.showdoc.com.cn/liantuofu/651360832965895</a> "/open/pay 被扫支付")</p>
<p>实体卡刷卡也按此逻辑
结账页面，可以直接用该会员卡余额支付
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/bc5f61b129bc791088f452ce413625f1" alt="" /></p>
<h3>5会员积分</h3>
<h4>①按线下软件会员积分规则，支付后自动增加线上会员积分</h4>
<h4>②可增加一个开关，设置线上会员积分是否走线下软件规则。</h4>
<h4>③调用会员修改接口完成线上会员积分，包括现金支付。</h4>
<p>查到线上会员后，调用会员修改接口，增加积分
[会员修改接口/open/member/modify](<a href="https://www.showdoc.com.cn/liantuofu/1703938225130096">https://www.showdoc.com.cn/liantuofu/1703938225130096</a> "会员修改接口/open/member/modify") （👈👈点击文字访问接口详情）
会员修改接口主要是对会员的积分、余额等会员属性增加或减少。用于线下软件操作增加减少积分、余额等会员属性修改时调用。
入参说明：
①merchantCode：门店编码（门店ew编码）
&nbsp;&nbsp;&nbsp;&nbsp;修改以下会员属性，积分、归属门店、经验、实体卡、余额、会员等级 参数<FONT SIZE='5' COLOR='GREEN'>必须传商户总部编码 即appid </FONT>
②modPoint 要修改的积分值 增加为正，减少传<FONT SIZE='3' COLOR='GREEN'>负值 </FONT>（核心才能修改）
operatorId：操作员id
&nbsp;&nbsp;&nbsp;&nbsp;可通过登录接口或员工列表接口获取
&nbsp;&nbsp;&nbsp;&nbsp;登录接口：
&nbsp;&nbsp;&nbsp;&nbsp;/open/login
&nbsp;&nbsp;&nbsp;&nbsp;员工列表：
&nbsp;&nbsp;&nbsp;&nbsp;/open/employee/list
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/5ef20ead2b435295490624fbbc496404" alt="" /></p>
<h4>积分换购余额功能</h4>
<p>余额增加同时积分减少
余额增加
传以下参数
merchantCode 传appid 才能修改积分和余额
shopNo 在哪个门店消费或充值金额
rechargeAmount 实充金额
积分减少
modPoint 修改的积分 增加为正，减少传<FONT SIZE='3' COLOR='GREEN'>负值 </FONT>（核心才能修改）
modPointType 8积分兑换</p>
<h3>6会员充值</h3>
<h4>①扫客户人微信、支付宝付款码支付 充值功能</h4>
<p>调用被扫支付接口，传充值参数
扫客人付款码充值
[/open/pay 被扫支付](<a href="https://www.showdoc.com.cn/liantuofu/651360832965895">https://www.showdoc.com.cn/liantuofu/651360832965895</a> "/open/pay 被扫支付")
orderType 传RECHARGE
memberId传对应会员的id值<br />
orderSource传4
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/df4e5eb2daafa27a904e7db377c40880" alt="" /></p>
<h4>②现金充值</h4>
<p>[主扫支付/open/precreate ](<a href="https://www.showdoc.com.cn/liantuofu/633518936832858">https://www.showdoc.com.cn/liantuofu/633518936832858</a> "主扫支付/open/precreate ")(👈👈点击文字访问接口详情)
channel 传CASH
tradeType 传NATIVE
orderType 传RECHARGE
orderSource传4
充值会员
传对应的会员id参数 memberId
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/dbda7209523574cf8de6d1322754e85e" alt="" /></p>
<h3>7会员注册</h3>
<p><strong>注册前可以先进行查询接口调用，判断是否存在此会员。</strong>
可在软件里通过手机号直接注册会员到线上后台
（手机号可以保证，客人使用这个手机号绑定的微信扫会员注册码的时候，同步线上的余额和积分到微信卡包）
参照接口
[注册会员/open/member/regist](<a href="https://www.showdoc.com.cn/liantuofu/1574047351915151">https://www.showdoc.com.cn/liantuofu/1574047351915151</a> "注册会员/open/member/regist")
merchantCode：门店编码（门店ew编码） 传门店编码默认注册该门店的会员。
physicalCardUid 注册填写的 实体卡卡号，用于刷实体卡查会员使用 实体卡一个商户ew编码下多个门店不能重复，必须唯一。</p>
<h3>8小票记账</h3>
<p>使用会员卡支付后，需要把前台对应的小票、支付流水、交班。后台的账表体现会员卡号，消费余额等信息。
如果有线上会员营销优惠，优惠金额在软件小票上，订单明细、交班统计、后台报表都要展示记账。
比如小票打印会员相关信息如图
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=f6321e9153f2f5808ab6f91d42bfb061&amp;file=file.png" alt="" /></p>