物业行业场景解决方案
业主卡场景解决方案
-
名词解释
1.业主卡主要是针对社区业主而发放的会员卡。基于业主卡可以为业主提供便利的生活服务，为社区运营搭建阵地，从而促进业主活跃。
2.业主卡组件是针对会员卡产品在物业社区场景下是使用而使用的技术解决方案。业主卡组件已经实现了会员卡相关接口。
-
使用对象
合作伙伴开发人员、PD
-
优势
组件分为两个部分，产品级SDK和DEMO。开发者可以直接运行组件demo，领取业主卡，了解业主卡领取流程；组件部署简单，快捷；组件模板是基于物业社区设置，开发者，通过模板参数，设置自己开发的社区服务。复用组件可以提高合作伙伴上线速度。 -
业主卡业务流程
1.业主实名认证领卡流程：
首先：通过用支付宝钱包扫码（码可以是生活号推广二维码、也可以是开卡组件二维码，商户可以根据自己的实际需求来生成）。
其次：用户需要做业主认证，认证通过后，到授权领卡。
最后：领卡完成后，在支付宝卡包内查看业主卡。
2.业主非实名认证领卡流程：
首先：通过访问线上链接、线下扫码两种方式做用户信息授权。
其次：在表单上输入姓名、手机号码等信息，点击授权。即可领取业主卡。
后续社区运营再做业主认证。
-
业主卡领卡案例
1.云筑业主卡申领流程（业主认证模式）： 
2.邦道业主卡申领流程（业主未认证模式）：
-
业主卡领卡渠道
业主卡是物业行业新推出的，因此对于领卡渠道是线上开卡链接、线下扫码方式领卡，其他行业领卡渠道非常丰富，未来领卡渠道可以丰富些。
全开放渠道包括：(1).扫码领卡 (2).消息中心领卡 (3).生活号后台发送消息领卡
受限制邀约开放渠道包括：(1).支付成功页推荐领卡 (2).卡包会员卡市场 需要BD申请。
-
业主卡接入建议
1）.组件栏位，建议从社区高频场景、丰富内容、活跃社区业主的角度来设置，商户可以按需设置。
2）.能够体现业主权益，譬如积分、优惠券等，同时商户系统能够累计商户权益最好。
3）.根据实际业务需求，业主认证建议在领卡前认证完成。可减少物业系统中脏数据。
4）.业主卡与商户生活号建立关联。譬如：生活号上提供补领业主卡的入口；同步消费者会员权益信息等。
5）.门禁或者其他功能可以通过小程序方式链接到业主卡上，高频场景用户可以发送到桌面上，方便使用。小程序作为轻量级应用，可以在流程上提供更好的体验。
-
业主卡关联产品
-
业主卡组件DEMO
-
组件领卡体验流程：
第一步启动服务用户登录
第二步：登录成功展示二维码
第三步：用户手机扫码领卡
-
模板修改流程：
-
表单配置流程：
-
组件调用接口流程
-
软件环境说明
Demo是基于springboot开发，并使用Maven做了项目管理，请运行Demo前确保你本机已经安装了JDK1.8及以上版本，Maven3.3及以上版本。
注：SDK本身是基于JDK 1.7完成开发，如果仅仅使用SDK而不需要使用Demo，确保你的开发机安装了JDK1.7及以上版本即可。
-
DEMO部署说明
DEMO部署相关说明详见DEMO中重要说明.txt文件。【链接】
i.DEMO部署前准备：
准备应用公私钥、appid获取、应用公钥上传、支付宝公钥获取、授权回调地址配置等详见引导链接：
密钥生成和上传参考：https://docs.open.alipay.com/291/105971
上传公钥获取支付宝公钥参考：https://docs.open.alipay.com/291/105972/
授权回调地址在同一页面配置。
ii.DEMO部署
第一步：确认本地已安装Eclipse或Idea、maven、jdk开发环境，并配置maven、jdk的环境变量。
第二步：执行dependencylib目录下的 installJar.sh（mac版）或者installJar.bat（win版） 依赖的Jar文件安装到本地Maven仓库。如图：
第三步：将XXXX_1.0-SNAPSHOT_source_project（Demo项目源码）导入Eclipse或Idea即可。如图：
第四步：config目录，Demo程序配置目录。启动Demo前，请使用你自己的支付宝账号appid,privateKey,alipayPublicKe等信息，修改resources目录application-owercard-prod.yml配置文件config。
第五步：bin目录 Demo程序启动、关闭脚本。
第六步：项目运行启动：
1）运行com.alipay.prosdk.demo.ownercard.Application中的main方法。
2）启动后可以通过浏览器访问流程引导页面：
*通过浏览器访问http://localhost:8999/ownercard/index 访问完成会员卡操作。
*通过浏览器访问http://localhost:8999/ownercard/template/index 访问完成会员卡模板操作。
第七步（可选）
a.授权回调授权地址配置说明。授权回调地址需要一个外网可访问的地址。如果在内网环境下，需要映射一个外网地址，然后配置到开放平台授权回调地址处，此处配置的地址与业主卡接口中的callback保持一致。可利用ngrok等工具映射外网地址。如图：
b．映射外网地址后，可以将本地地址改成映射后的地址。例如：localhost:8999 映射后可域名为：http://65f50a26.ngrok.io，则http://localhost:8999/ownercard/index可通过http://65f50a26.ngrok.io/ownercard/index来访问
-
组件代码功能介绍
### 通用功能
* 图片上传功能(上传到支付宝端)
### 会员卡模板管理
* 卡模板信息查询
* 会员卡模板创建
* 会员卡模板更新
* 会员卡开卡表单模板配置
### 开卡组件
* 获取用户会员卡领卡投放链接
* 用户会员卡信息更新
* 用户会员卡信息查询
* 用户会员卡删除
### 通知
* 同步授权成功回调处理(查询表单提交信息、开通会员卡)
* 异步通知处理(删卡、开卡等通知)
组件其他代码结构及功能介绍详见DEMO中的ReadMe.md文件。
-
业主卡组件DEMO下载
