电子校园卡组件是针对会员卡产品在高校场景应用而产出的技术解决方案。电子校园卡组件已经实现了会员卡API列表中的所有接口,合作伙伴开发者无需再从0开始开发各个接口,可直接“导入工程--修改配置文件--一步导入jar依赖”快速部署测试组件。组件中的模板创建接口是根据高校电子校园卡通用模板设置的参数,开发者仅根据高校需求做细微调整即可完成接口开发。复用组件可以帮助合作伙伴快速高质量完成业务上线。
阅读对象:合作伙伴开发人员、PD。
组件开发语言:目前仅提供java版。
复用电子校园卡组件前,需要提前做好相关各接口权限开通以及密钥配置,详见接入指南。
提供的电子校园卡组件包含两部分,一部分是demo示例,一部分是SDK。SDK和demo代码接口说明文档详见组件包中“重要说明.txt”和readme。
Demo是基于springboot开发,并使用Maven做了项目管理,请允许Demo前确保你本机已经安装了JDK1.8及以上版本,Maven3.3及以上版本。
注:SDK本身是基于JDK 1.7完成开发,如果仅仅使用SDK不需要使用Demo,确保你的开发机安装了JDK1.7及以上版本即可。
1、解压压缩包运行/prosdk_campuscard-demo_1.0-SNAPSHOT/dependencylib/目录下的installJar(其中win环境用installJar.bat,mac环境用installJar.sh),完成maven依赖安装;
2、使用Idea或Eclipse导入campuscard-demo_1.0-SNAPSHOT_source_project工程,目录结构如图:
3、修改配置文件application-test.yml。完成配置后即可运行测试。
具体应用公私钥生成方法、appid获取、应用公钥上传、支付宝公钥获取等详见视频教程:
密钥生成和上传参考:https://openclub.alipay.com/read.php?tid=2354&fid=69
上传公钥获取支付宝公钥参考:https://openclub.alipay.com/read.php?tid=2190&fid=69
4、项目运行启动:
1)运行com.alipay.prosdk.demo.campuscard.Application中的main方法。
2)启动后可以通过浏览器访问流程引导页面:
打开页面http://XXX:YYY/campusCard/manager ,如下图所示,可按顺序做接口测试(界面优化升级中,后续界面展示风格会更友好)。
打开页面http://XXX:YYY/campusCard/index ,上面有个二维码,使用支付宝钱包扫描,就可以做申领校园卡测试。
注意:领卡测试扫码后点击“确认领卡”领取成功后会回调callback地址页,callback地址需要与appid对应的应用授权回调地址保持一致。如在本地电脑测试需要做外网访问映射(可使用ngrok反向代理协助完成),否则无法正常跳转测试。
领卡成功后到支付宝卡包中查看,电子校园卡效果如图: