有域小程序介绍

基础能力

有域小程序是为商户提供私域营销的工具小程序，小程序内提供会员储值、发券活动、积分商城等营销能力；有域小程序支持「营销模式」「会员模式」两种功能模式，商户开通会员后，则自动切换为会员模式。

营销模式：商户页面以营销发券功能为主，为商户提供私域营销服务；
会员模式：商户页面以会员营销功能为主，支持会员储值、发券活动、积分商城等。

C端小程序操作手册：http://help.lcsw.cn/ni49np/lftw_xeg9c9aai35/ytyokc

独立部署

小程序支持独立版部署，帮助品牌商家部署自己主体的有域小程序

平台版：是集合所有商户的公版小程序（小程序主体是利楚），小程序用户通过搜索小程序、历史使用记录可以进入选择商户页面，再进入商户主页；
独立版：若品牌商家想拥有自己主体的有域小程序，不用其他商户共用平台版小程序，我们提供了独立版部署的服务，独立版小程序没有选择商户的列表，直接进入品牌商户的主页，会员资产数据不变。

独立部署流程

【微信】小程序独立部署操作

一、商户：注册微信小程序

商户先前往微信小程序官方网站注册小程序
微信小程序官网：https://mp.weixin.qq.com/cgi-bin/wx

二、商户：下载授权文件给技术

用途：小程序独立部署的必要文件

1、登录微信公众平台（https://mp.weixin.qq.com），选择对应小程序登录
2、左侧菜单，进入「开发」--「开发管理」

3、点击「开发设置」后，页面下滑，找到「扫普通链接二维码打开小程序」，点击添加按钮

4、点击「下载校验文件」，将下载的文件提供给利楚的技术同事“刘杰”

三、商户：设置服务器白名单

用途：小程序独立部署的必要配置

1、登录微信公众平台（https://mp.weixin.qq.com），选择对应小程序登录
2、左侧菜单，进入「开发」--「开发管理」

3、点击「开发设置」后，页面下滑，找到「服务器域名」，点击修改按钮

4、小程序管理员，微信扫码验证身份

5、验证通过后，可配置「request合法域名」，将以下内容填入，保存即可
https://api-mkt.lcsw.cn;https://api.lcsw.cn;https://apis.map.qq.com;https://inst.lcsw.cn;https://open-mkt.lcsw.cn;

四、商户：配置小程序功能插件

用途：小程序内营销发券需要该组件

1、登录微信公众平台（https://mp.weixin.qq.com），选择对应小程序登录
2、左侧菜单最底部，进入「设置」

3、点击「第三方设置」后，找到「插件管理」，点击添加插件

4、搜索「微信支付券」，查询出来后，点击选中微信支付券，再点击添加按钮

五、商户：配置订阅消息

用途：推送限时领券活动提醒消息

1、登录微信公众平台（https://mp.weixin.qq.com），选择对应小程序登录
2、左侧菜单最底部，进入「订阅消息」，选择「公共模板库」菜单
3、输入「秒杀开始提醒」搜索，找到对应的模板点击「选用」

4、设置对应的字段，建议按照示意图字段、顺序选择（若需要其他字段，需要额外开发），填写场景说明，提交后，在我的模板里复制模板ID提供给利楚的技术同事“刘杰”

六、商户：配置普通二维码链接

用途：实现有域小程序聚合码能力，微信/支付宝双端扫描同一个二维码进入小程序指定页面

1、登录微信公众平台（https://mp.weixin.qq.com），选择对应小程序登录
2、左侧菜单，进入「开发」--「开发管理」

3、点击「开发设置」后，页面下滑，找到「扫普通链接二维码打开小程序」，点击添加按钮

4、按照以下要求填写配置后，进行保存。
1）商户小程序（即商户非品牌结算商户、或未加入任何品牌）：
需要将以下5个链接、路径进行配置

举例：qr-mkt.lcsw.cn/imember/m880000000000123

二维码地址	对应路径
https://qr-mkt.lcsw.cn/imember/m + 商户号	pages/pMain/index
https://qr-mkt.lcsw.cn/iqrcode/m + 商户号	pages/pQrCoupon/index
https://qr-mkt.lcsw.cn/iblock1/m + 商户号	pages/pMain/block1
https://qr-mkt.lcsw.cn/iblock2/m + 商户号	pages/pMain/block2
https://qr-mkt.lcsw.cn/iblock3/m + 商户号	pages/pMain/block3

2）品牌小程序（即商户是品牌的结算商户）：
需要将以下5个链接、路径进行配置

举例：qr-mkt.lcsw.cn/iblock3/b99

二维码地址	对应路径
https://qr-mkt.lcsw.cn/imember/b + 品牌id	pages/pMain/index
https://qr-mkt.lcsw.cn/iqrcode/b + 品牌id	pages/pQrCoupon/index
https://qr-mkt.lcsw.cn/iblock1/b + 品牌id	pages/pMain/block1
https://qr-mkt.lcsw.cn/iblock2/b + 品牌id	pages/pMain/block2
https://qr-mkt.lcsw.cn/iblock3/b + 品牌id	pages/pMain/block3

七、商户：申请“获取用户位置”接口

用途：小程序内查找门店、积分商城自提点需要展示与用户的距离

1、登录微信公众平台（https://mp.weixin.qq.com），选择对应小程序登录
2、左侧菜单，进入「开发」--「开发管理」

3、点击「接口设置」后，找到「地理位置」--「获取当前的地理位置、速度」，点击去开通按钮

4、参照示例提交申请后，等待审核通过
示例：
申请原因：需要提供商品自提点的导航工作，方便用户在商城购买实物商品后，就近选择离自己最近的自提点。
辅助图片：附上积分商城自提点搜索相关截图
申请getLocation截图.zip

八、商户：扫码授权小程序

前八步完成后，BD提供授权二维码，小程序管理员使用微信扫码同意授权

1、运营：提供授权码

运营账号登录营销平台（mkt.lcsw.cn）--服务中心--小程序管理--小程序列表，输入商户号查询（BD需要验证商户与小程序主体的一致性，避免操作错误导致A商户的小程序授权给了B商户）

点击「授权微信」，获取授权码（微信二维码有效期5分钟）

微信小程序授权码示例：

2、商户：扫码授权

小程序管理员使用微信扫码同意授权

九、技术：提交小程序审核发布

1、技术：开发版预览

技术点击「管理小程序发布」按钮，进入管理页，选择开发版本（即小程序模板），点击展开获取体验二维码，体验者使用微信即可扫码体验独立版小程序的效果（需要先将手机号添加到微信小程序体验者）

2、技术：提交微信审核

体验者体验无误后，技术即可提交微信审核，进入审核中状态

3、技术：发布小程序

小程序审核通过后，即可操作发布，发布后，通过微信搜索小程序、小程序码、会员推广码，即可进入独立版小程序（独立版发布后，扫码默认进入的是独立版，建议手动关闭平台版）

十、商户：小程序申请调起付款码

用途：小程序内跳转到用户微信付款码页面

1、小程序发布上线后发起申请
2、需求邮件在每周三下午4点前发送，在周五或下周一前同步审核结果。
3、邮件发送模板
1）发送人：商户业务方负责人或产品经理
2）收件人：v_ctwei@tencent.com；抄送人：vvwen@tencent.com，可添加开发人员，业务方相关人员
3）邮件标题：【小程序调用刷卡权限申请】-XXXX有限公司（即小程序主体的企业全称）
4）填写附件表格后上传附件：小程序调用付款码权限申请表.xlsx
5）邮件正文：

申请的权限：小程序调起付款码
商户号：XXXX（即小程序主体企业在微信支付的商户号）
小程序的Appid：
小程序原始ID：
小程序名称：
小程序主体全称：XXXX有限公司（即小程序主体的企业全称）
业务方产品联系人：姓名+手机号+邮箱
业务方开发联系人：姓名+手机号+邮箱
接口用途：用户刷会员码后，引导用户使用微信支付进行付款
页面交互图：

【支付宝】小程序独立部署操作

一、商户：注册支付宝小程序

商户先前往支付宝小程序官方网站注册小程序
支付宝小程序官网：https://mini.open.alipay.com/channel/miniIndex.htm

二、商户：下载授权文件给技术

用途：小程序独立部署的必要文件

1、登录支付宝开放平台（http://open.alipay.com/），，进入控制台页面，选择对应小程序进入管理页面

2、左侧菜单，进入「开发」--「开发设置」，找到H5域名配置项，点击添加，在弹窗中点击「下载校验文件」，将下载的文件提供给利楚的技术同事“刘杰”

三、商户：设置并导出公私钥文件给技术

用途：小程序用户授权手机号后，需要用来解密包含手机号的加密信息

1、下载支付宝开放平台助手（用于生成密钥），下载地址：https://opendocs.alipay.com/common/02kipk

附：支付宝官方操作文档：https://opendocs.alipay.com/common/02mriz

2、安装打开助手工具，进入菜单「密钥工具」--「生成密钥」
3、点击「生成密钥」，则会生成「应用私钥」、「应用公钥」，点击「打开密钥文件路径」，则可以打开存放的文件夹

4、复制「应用公钥」后，在小程序管理台「开发设置」--「开发信息」，找到接口加签方式，点击设置，管理员验证短信后可进行配置

5、按照以下示意图，将复制的「应用公钥」，填写保存设置，则会员得到「支付宝公钥」

6、将复制「支付宝公钥」为TXT文件
7、将「应用私钥」TXT文件、「支付宝公钥」TXT文件、小程序APPID，一起发给利楚的技术同事“刘杰”

四、商户：设置H5域名配置

用途：小程序独立部署的必要配置

1、左侧菜单，进入「开发」--「开发设置」，找到H5域名配置项，点击添加

2、在弹窗中点击输入：https://wxpay.lcsw.cn，再点击蓝色文案“点击这里”进行文件校验
3、验证成功后，点击「确定」

五、商户：配置关联普通二维码

用途：实现有域小程序聚合码能力，微信/支付宝双端扫描同一个二维码进入小程序指定页面

1、左侧菜单，进入「审核&发布」--「小程序码」，选择「关联普通二维码」，点击添加

2、按照以下要求填写配置后，进行保存。
1）商户小程序（即商户非品牌结算商户、或未加入任何品牌）：
需要将以下5个链接、路径进行配置

举例：qr-mkt.lcsw.cn/imember/m880000000000123

二维码地址	对应路径
https://qr-mkt.lcsw.cn/imember/m + 商户号	pages/pMain/index
https://qr-mkt.lcsw.cn/iqrcode/m + 商户号	pages/pQrCoupon/index
https://qr-mkt.lcsw.cn/iblock1/m + 商户号	pages/pMain/block1
https://qr-mkt.lcsw.cn/iblock2/m + 商户号	pages/pMain/block2
https://qr-mkt.lcsw.cn/iblock3/m + 商户号	pages/pMain/block3

2）品牌小程序（即商户是品牌的结算商户）：
需要将以下5个链接、路径进行配置

举例：qr-mkt.lcsw.cn/iblock3/b99

二维码地址	对应路径
https://qr-mkt.lcsw.cn/imember/b + 品牌id	pages/pMain/index
https://qr-mkt.lcsw.cn/iqrcode/b + 品牌id	pages/pQrCoupon/index
https://qr-mkt.lcsw.cn/iblock1/b + 品牌id	pages/pMain/block1
https://qr-mkt.lcsw.cn/iblock2/b + 品牌id	pages/pMain/block2
https://qr-mkt.lcsw.cn/iblock3/b + 品牌id	pages/pMain/block3

六、商户：添加领券/消息插件

用途：小程序内营销发券需要该组件

1、左侧菜单，进入「开发」--「插件服务」，点击「添加插件」

2、输入「领券组件插件」后搜索，点击进入详情，未获取则点击「立即获取」

3、输入「消息订阅插件」后搜索，点击进入详情，未获取则点击「立即获取」