商盟版本-会员接通指南
<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/merchantCardMemberList</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>按软件上商品的积分规则，给线上会员直接积分</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>
</tbody>
</table>
<p>商盟测试参数
appid：EW_N2856535208
key：2bea862877f3973ac884d62845c23fb1
门店编码：EW_N0703171963</p>
<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](<a href="https://www.showdoc.com.cn/liantuofu/1573818719557973">https://www.showdoc.com.cn/liantuofu/1573818719557973</a> "会员查询")（👈👈点击文字查看接口详情）---通过接口获取对应的会员id（ memberid）、等级id（levelId）用于映射线下会员类型，实现不同会员不同会员价。
入参说明</p>
<p><FONT SIZE='3' COLOR='GREEN'>shopNo：门店ew编码，商盟版会员必传，用于查询对应门店的门店卡相关情况。非商盟版本不是必传参数。</FONT></p>
<p>返回参数说明</p>
<p>会员id（ memberid）会员唯一标识、</p>
<p>等级id（levelId）用于映射线下会员类型，实现不同会员不同会员价。</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>扫商品页面，扫微信付款码，识别会员走会员价，自动支付。
扫微信付款码自动识别会员功能（识别后走会员价）
一个微信付款码完成2个动作，查会员和发起支付。
参照接口
①查询会员--查到会员，并将商品按会员价优惠
[会员查询/open/member/get](<a href="https://www.showdoc.com.cn/liantuofu/1573818719557973">https://www.showdoc.com.cn/liantuofu/1573818719557973</a> "会员查询")（👈👈点击文字查看接口详情）---通过接口获取对应的会员id（ memberid）、等级id（levelId）用于映射线下会员类型，实现不同会员不同会员价。
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/36fe1b03d4586f5d2715a1e1127a831a" alt="" />
参数说明
shopNo：门店ew编码，用付款码查询会员必传
②支付接口-付款码发起支付，用会员价的商品金额发起支付
[被扫支付open/pay ](<a href="https://www.showdoc.com.cn/liantuofu/651360832965895">https://www.showdoc.com.cn/liantuofu/651360832965895</a> "被扫支付")(👈👈点击文字查看接口详情)</p>
<h3>4查到线上会员后，直接支付</h3>
<p>软件操作输入或刷实体卡查询到会员后，可以直接通过erp软件会员卡或储值卡按钮，直接发起会员扣款消费。
参照接口</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 会员支付授权码")
<FONT SIZE='3' COLOR='GREEN'>shopNo：门店ew编码，商盟版会员必传.非商盟版本不是必传参数。</FONT></FONT>
返回参数说明
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 被扫支付")
入参说明
authCode：支付授权码，用查询到的会员支付授权码，可以直接扣款会员余额</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") （👈👈点击文字访问接口详情）
<FONT SIZE='3' COLOR='GREEN'>shopNo：门店ew编码，商盟版会员必传，非商盟版本不是必传参数。</FONT>
会员修改接口主要是对会员的积分、余额等会员属性增加或减少。用于线下软件操作增加减少积分、余额等会员属性修改时调用。
修改以下会员属性，积分、归属门店、经验、实体卡、余额、会员等级 参数<FONT SIZE='3' COLOR='GREEN'>merchantCode必须传商户总部编码 即appid </FONT>
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/5ef20ead2b435295490624fbbc496404" alt="" /></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值
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
充值会员
传对应的会员id参数 memberId
orderSource传4
<img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/dbda7209523574cf8de6d1322754e85e" alt="" /></p>
<h3>7会员注册</h3>
<p><strong>注册前可以先进行查询接口调用，判断是否存在此会员。</strong></p>
<p>可在软件里通过手机号直接注册会员到网页后台</p>
<p>软件注册页面填写，获取手机号、实体卡号、会员姓名等（没有可以用手机号代替）会员信息。 参考如下图
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=5cc10279e94c6341af1be4ab066d344b&amp;file=file.png" alt="" /></p>
<p>（填写手机号可以保证，客人使用这个手机号绑定的微信扫会员注册码的时候，同步线上的余额和积分到微信卡包）
参照接口
[注册会员/open/member/regist](<a href="https://www.showdoc.com.cn/liantuofu/1574047351915151">https://www.showdoc.com.cn/liantuofu/1574047351915151</a> "注册会员/open/member/regist")</p>
<p>商盟版本必须传门店编码，注册门店卡
merchantCode：门店编码（门店ew编码） 注册对应门店的门店卡。
physicalCardUid 注册填写的 实体卡卡号，用于刷实体卡查会员使用，一个商盟下所有门店的实体卡要保持唯一，不能重复。
其他字段非必要，不要传。</p>