学校接入和落地指南

更新时间：2021-12-30 16:43:40

本文档阅读对象：需要接入K12校园刷脸方案的服务商。

上游参数配置

支付宝侧配置

1. 提交资料

资料 备注
学校名称 事业单位法人证书，或者民办非企业单位登记证书中的学校名称
地区 省、市、区
学校支付宝账户 提供学校支付宝账户，或者学校食堂承包商的支付宝账户
统一社会信用代码 事业单位法人证书，或者民办非企业单位登记证书中的信息
学校类型 跟证件中的业务范围保持一致
客服电话 学校客服电话

填写附件 学校上架信息-xxx学校 ，并提交资料给到扫呗团餐运营专员【邮件发送给guozheng@lcsw.cn】，完成支付宝后台商户进件。

扫呗版小程序名称：扫呗校园通，APPID为： 2021001170655023； 公版小程序名称：校园通，APPID为：2021001193675073； 提交资料给到支付宝时，务必注意填写正确的appid。


确定商户是否需要接入指定扣款银行卡功能，如需接入，提交对应银行信息到支付宝业务人员【邮件发送给zhongzhen.wc@antgroup.com，kuanyi.cky@antgroup.com】。
开通设置扣款银行说明函-学校

2. 创建门店

  1. 服务商登录支付宝开放平台（https://openhome.alipay.com/sp/merchant/store/create），新建商户门店；

image.png

  1. 业务场景选择“K12”，门店类目选择“教育-学校-高中/初中/小学/幼儿园”，或者“美食-团餐-校园团餐-高中/初中/小学/幼儿园”，基础信息选择已铺设的中小学的支付宝账户，并且实际收单商户主体行业类目选择“专业服务-教育服务-中小学校”或“生活百货-饮食保健-校园团餐/综合团餐”。

image.png
​

注意：

  • 门店类目一定要选对，否则会影响交易返佣；
  • 支付宝侧K12相关业务具体操作流程可登录服务商后台，见：https://opendocs.alipay.com/education/01xl25

    微信侧配置

    | 一、必备资料信息 | 1，执照名称； 8，开户银行；
    2，执照注册号； 9，开户银行省份；
    3，法人姓名； 10，开户支行；
    4，法人身份证号； 11，学校具体地址；
    5，法人有效期； 12，超级管理员姓名；
    6，结算户名； 13，身份证号；
    7，结算账号； 14，手机号码、邮箱。 | | --- | --- |
二、其他资料（按餐饮主体） 签约主体的公司与学校的合作证明，包括但不仅限于承包合同、合作协议等。文件中应当包括：
1，企业与服务学校的双方主体名称及加盖的印章；
2，合作范围为餐饮校内服务，且须在合作有效期内。
二、其他资料（按学校主体） 1，公立学校食堂需提供《事业单位法人登记证书》或者事业单位在线网截图；
2，民办学校食堂需提供《民办非企业法人登记证书》和《办学许可证》，或者全国社会组织信息截图，或工商登记局截图。
三、发送邮件 填写附件学校上架信息-xxx学校.doc，并提交资料给群内对接运营人员【邮件发送给guozheng@lcsw.cn】
附件内还需提供学校照片：
1，学校门头1张；
2，学校内景1张；
3，食堂门头1张；
4，食堂内景2张。

扫呗侧配置

1. 商户进件

拿到商户进件所需资料，完成商户进件，进件流程与支付宝直连商户进件流程一致，此处不做详述。
​

注意：

  • 通道配置：K12商户支付宝侧要求必须使用官方通道，在通道参数配置时，支付宝应用appid请务必仔细检查，返佣PID及务必填写正确，授权二维码请使用到账人支付宝账户扫码授权【此操作涉及到支付宝分润计算，请务必正确操作、仔细检查】

image.png

  • 门店ID配置：进件完成后，登录扫呗后台，进入商户详情，选择“门店管理”，找到对应门店，配置门店信息【门店编号从支付宝服务商后台获取，此操作涉及到支付宝分润计算，请务必正确操作、仔细检查】

image.png

2. 配置校园参数

操作流程：登录支付平台，选择“商户管理”>>“全部商户”>>输入商户号【测试商户号为 811005441000008 】，选择“查询”，在商户列表中搜索到对应商户后，选择“查看”进入详情。在活动申请栏选择“校园参数配置”；
image.png
注意：配置校园参数意味着允许所有签约该学校的学生到商户侧进行免密支付相关消费，请谨慎操作。

3. 设备绑定

设备绑定目的是将收款设备与收款商户做关联，关联完成后，设备收到的订单资金结算链路才能通畅，具体操作流程：

  1. 选择“商户管理”>>“全部商户”>>输入商户号【测试商户号为811005441000008 】，选择“查询”，在商户列表中搜索到对应商户后，选择“终端管理”；
  2. 选择添加机器，应用类型选择“刷脸终端”，机具品牌选择“商米海马”，机器型号选择“T1D10”;
  3. 设置6位退款密码，仅支持数字；
  4. 点击“提交”完成；
  5. 将是否开通由“OFF”切到“ON”；

image.png
注意：先配置门店信息，再绑定设备、关联门店，注意操作顺序，否则会影响返佣。

浦发III类户接入

如学校确定接入指定银行卡代扣，并与浦发银行合作，可参看本章节描述：

1. 运营发送申请邮件

1.1 整理资料

1.1.1填写学校或餐饮公司的银业执照基本信息（营业执照名称、信用代码、法人姓名、注册资本、经营范围、地址信息等），并上传营业执照照片
1.1.2 填写法人、实际控制人和联系人详细信息（姓名、身份证号码、住址、职业、手机号码等），并上传身份证正反面照片
1.1.3 填写浦发对接信息，对接部门：上海浦东发展银行股份有限公司杭州分行；对接联系人：夏怡；联系邮箱：xiay13@spdb.com.cn
1.1.4 填写浦发APK接入申请表（模板：API接入申请模板），图片标红部分均需正确填写并上传；上传之后发将此表作为邮件附件，再次给浦发银行对接人员，并跟进银行侧接口审批通过结果：
image.png

1.2 发送申请邮件

教育行业运营发邮件给：刘聪liucong@lcsw.cn，抄送：王少ws@lcsw.cn，郭欣怡guoxinyi@lcsw.cn，成幸chengxing@lcsw.cn
FU+运营发邮件给：刘聪liucong@lcsw.cn，抄：陈卓chenzhuo@lcsw.cn; 郑芳zhengfang@lcsw.cn，郭欣怡guoxinyi@lcsw.cn，成幸chengxing@lcsw.cn
申请配置：

  • 邮件标题：XXX学校开浦发三类户申请专属参数
  • 邮件内容模板：

XXX学校（商户名：XXX、扫呗商户号XXX），开通浦发三类户申请专属参数，麻烦处理，谢谢！
​

2. 创建APP（技术同事操作步骤）

2.1 发送邮件至浦发

2.1.1 打包申请资料照片包括（合作协议、营业执照、法人身份证、API接入申请表、浦发代扣函)
image.png
2.1.2 发送打包好的资料给浦发指定对接人邮箱 xiay13@spdb.com.cn

2.2 创建APP

2.2.1 注册并审核通过之后，登录开放平台，根据命名规则创建app，app中文名可填写学校名称+校园通字样（比如：信阳十高校园通），英文名可填写k12facepay+编号（比如：K12facepayxysg10）；
2.2.2 APP文字描述举例：① 为家长、在校师生提供校园刷脸代扣协议签订服务；② 支持查看消费账单，设置限额等描述填写如下图所示；
image.png

2.2.3 app创建完成后，可获取 X-SPDB-Client-ID ，单独保存;
image.png
2.2.4 同时进入开发者公钥，获取浦发SM2公钥信息，单独保存；
image.png
2.2.5 审核通过，系统发送邮件至邮箱，获取正式环境加密X-SPDB-Client-Secret（24小时有效期），单独保存
image.png

3. 正式环境API申请（技术同事操作步骤）

3.1 API一共21条见细节文档，拟开通API编号及名称（搜索每条API加入批量列表，批量申请）：

  • 电子账户随机密码获取
  • 电子账户在线销户(专户)
  • 三类户开立(专户)(新版)
  • 账户处理结果查询
  • 电子账户开立状态查询(新版)
  • 电子账户绑定卡账户查询(新版)
  • 电子账户专户充值(新版)
  • 电子账户充值结果查询
  • 电子账户专户提现(新版)
  • 电子账户提现状态查询
  • 电子账户新增绑定卡(专户)(新版)
  • 新增绑定卡查询(新版)
  • 电子账户解除绑定卡(专户)(新版)
  • 电子账户账户余额查询
  • 非绑定允许入金签约状态查询
  • 修改绑定卡手机号
  • 修改绑定卡手机号结果查询
  • 短信认证请求
  • 短信认证签约
  • 非绑定入金卡签约
  • 直销银行证件图片补录

image.png
3.2 浦发审核通过，会发送邮件至邮箱通知。

4. 获取私钥信息（技术同事操作步骤）

​进入我的APP，查看 Secret，将邮箱内的正式环境加密 X-SPDB-Client-Secret 信息复制，回填解密，获取解密后的最终私钥信息，单独保存；
image.png

5. 公钥设置

5.1 登陆浦发银行API开放平台→按图示，在用户信息下→点击进入「我的APP」
image.png
​

5.2 找到申请的学校→点击「开发者公钥」→点击选择「合作方SM2公钥」→在开发者公钥框内填入公钥：
04ea91a5dfb39e06ade88fed96b23827076cef2431a0d20f23680528af160006782c55ee19f6d2bcf60e517813634779f96ea4a300a5a3fe0d59e24e3e9c9143e7
保存→填入验证码→确定
image.pngimage.pngimage.png

5.3 点击「同步生产秘钥」→点击「确定」→输入验证码→输入短信验证码→确定，完成
image.pngimage.pngimage.png

6. 后台参数配置（技术同事操作步骤）

全部配置完成后，运营同学会收到内含 X-SPDB-Client-ID、私钥、公钥、机构号等参数信息 的回复邮件。

7. 后台参数配置

7.1 运营同学得到参数后，进入校园管理-学校列表-新增学校；
​

7.2 登录校园中心后台，学校管理→搜索学校→修改→校园消费参数配置：

  • 指定银行卡：打开；
  • 银行名称：浦发银行；
  • 三类户银行方应用ID：填入浦发开放平台获取到的X-SPDB-Client-ID;
  • 三类户银行方私钥：解密后的私钥，从邮件中复制并填入；
  • 三类户银行方公钥：填入浦发开放平台获取到的浦发SM2公钥；
  • 三类户银行分配机构号：​
  • 推荐人工号：​

image.png

8. 浦发三类户激活

8.1 录入一个测试人员信息，完成签约测试开通浦发电子账户成功
8.2 进入校园中心后台-财务管理-银行电子账户页面，获取第一张开通成功的浦发电子账户
image.png
8.3 获取第一张开通成功的浦发电子三类卡卡号和持卡人姓名，通过钉钉浦发对接群，发给浦发对接人员，进行浦发卡参数配置激活；
8.4 浦发对接人回复配置激活完毕，至此，浦发三类卡申请开通流程完毕。
​

平安III类户接入

1. 官方进件

1.1 微信/支付宝 官方后台进件，0费率申请审核通过，扫呗后台官方通道0费率配置完成。

注：需要开通平安III类户的学校，在支付宝官方进件的主体必须是学校，不可是任何名义的第三方代理、委托餐饮服务、技术服务等机构。否则平安总行不会审核通过。
​

1.2 教育行业运营发邮件给：刘聪liucong@lcsw.cn，抄送：王少ws@lcsw.cn，郭欣怡guoxinyi@lcsw.cn，成幸chengxing@lcsw.cn
FU+运营发邮件给：刘聪liucong@lcsw.cn，抄：陈卓chenzhuo@lcsw.cn; 郑芳zhengfang@lcsw.cn，郭欣怡guoxinyi@lcsw.cn，成幸chengxing@lcsw.cn；肖诗楠 xiaoshinan@lcsw.cn
申请配置：

  • 邮件标题：XXX学校开平安三类户申请专属APPID
  • 邮件内容模板：

XXX学校（商户名：XXX、扫呗商户号XXX），微信K12/支付宝K12 开通平安三类户申请专属APPID，学校所在省市是XXXXX，麻烦处理，谢谢！

2. 技术同事操作步骤

2.1 使用利楚平安开放平台账户登录平安开放平台 https://auth.orangebank.com.cn/#/p/login，进入管理中心；
image.png

2.2 选择企业应用中心，创建应用；
image.png
​

2.3 填写应用名称，上传应用图标，填写应用简介；

  • 应用名称：建议以学校名称命名；
  • 应用图标：统一上传利楚LOGO（像素要求320x320）；
  • 应用简介：k12智慧校园管理工具；

LOGO如下图所示：
image.png
界面操作截图：
image.png
2.4 配置开发环境；
image.png
授权回调地址：http://test.lcsw.cn:8050/lcsw_api_wx2/bankelectronic/pingan/auth
其他参数请查阅内部文档。

2.5 添加产品：渠道专用三类户，并提交审核；
image.png
image.png
image.png
2.6 生成的APPID，私钥和公钥会以邮件形式回复到申请人邮箱。
​

3. 运营操作部分

3.1 测试交易

3.1.1 收到回复的含有APPID、私钥和公钥等参数邮件
image.png
3.1.2 在该学校商户下，「终端管理」绑定一台小财神设备，进行支付交易测试。
注：测试设备可以是台卡或扫码、刷脸设备；
3.1.3 要求 支付宝/微信 测试账户绑定一张平安银行I类卡用于扣款。
3.1.4 建议发起一笔交易金额大于 20元 且 订单号开头为“406” 的测试交易，并在口袋银行APP截图交易，完成以后请实施操作退款。（如后续支付宝/微信更改相应逻辑，该流程也根据实际情况做出相应调整）。
注：务必测出一笔开头是 “406” 的流水订单，测出即可，无需再测。
3.1.5 交易前注意确认该商户的支付宝支付中“支付宝JS支付/支付宝付款码”设置为官方通道；
​

3.2 申请审核及参数配置

3.2.1 发送邮件给平安银行BD进行上线学校III类户开通白名单配置，邮件模板：
收件人：
① 学校所在区域湖北省，收件邮箱为：289245899@qq.com
② 学校所在区域河南省，收件邮箱为：420914215@qq.com
③ 学校所在区域江西省，收件邮箱为：tupeng8001@163.com
（除此三地之外的区域，如需申请平安三类户，需提前两周提醒负责BD，与当地分行取得联系签署合作协议，才能申请）
​

教育行业运营发邮件给：刘聪liucong@lcsw.cn，抄送：王少ws@lcsw.cn，郭欣怡guoxinyi@lcsw.cn，成幸chengxing@lcsw.cn
FU+运营发邮件给：刘聪liucong@lcsw.cn，抄：陈卓chenzhuo@lcsw.cn; 肖诗楠 xiaoshinan@lcsw.cn，郑芳zhengfang@lcsw.cn，郭欣怡guoxinyi@lcsw.cn，成幸chengxing@lcsw.cn
邮件标题：XXX学校（校园通产品）商户白名单配置申请-XXXX年XX月XX日
正文内容：
XXX学校申请平安银行III类户开通白名单，烦请审批。
附件说明：1. 申请表格【截图复制到邮件正文中】；2. 合作真实性证明材料；3. 实地照片；4，测试交易截图
image.pngimage.png
申请表模板下载：XXX学校（校园通产品）商户白名单配置申请-XXXX年XX月XX日-支付宝/微信
注意：平安III类户能力申请，全程需要提交2次审核，建议至少提前5个工作日提交申请，请运营同事与代理合作伙伴提前做好时间协调。

4. 后台参数配置

4.1 登录校园中心后台，学校管理→搜索学校→修改→校园消费参数配置
4.2 选择指定银行卡，平安银行，按要求填写参数内容（3.1.1 邮件内参数）
image.png
​

5. 平安III类户上线

平安银行对接人完成最后的配置流程后，告知可开卡上线，此时学校三类户能力可开始启动。
注：申请过程中，运营人员不可擅自找平安对接人加急进度。

工行III类户接入

  1. 提供代扣函至支付宝官方申请配置指定工商卡代扣
  2. 后台申请配置工商银行电子三类卡开卡参数
    注：具体参数配置向运营申请

image.png

  1. 参数配置完成后，可至扫呗校园通小程序开卡签约即可
    支付宝搜索“扫呗校园通”小程序 - 点击“我的账户” - 添加“电子账户”继续完成开通。

    交行III类户接入

    1. 前置工作

    1.1 支付宝的学校，提供代扣函至支付宝官方申请配置指定交行卡代扣
    1.2 运营人员把学校全称告知 刘聪，刘聪会在交行群内询问是否可以申请三类户，得到确认答复后再走申请流程（建议市场人员如果要用交行三类户去洽谈学校之前，先再群里核实一下是否可以开当地的交行三类户）
    ​

    2. 申请交行三类户邮件

  2. 银行分配网点机构号是用于将学校归属到当地的交行分行，需要发送邮件给相关人员（目前只支持江西地区的K12学校）

邮件模板：
邮件标题：XXX学校（校园通产品）交行分行网点机构号申请-XXXX年XX月XX日
收件人：​
教育行业运营发邮件给：刘聪liucong@lcsw.cn，54449693@qq.com, 抄送：wang_sihui@bankcomm.com, 王少ws@lcsw.cn，林喆lz@lcsw.cn，郭欣怡guoxinyi@lcsw.cn，成幸chengxing@lcsw.cn，
FU+运营发邮件给：刘聪liucong@lcsw.cn, 54449693@qq.com, 抄送：wang_sihui@bankcomm.com, 陈卓chenzhuo@lcsw.cn; 郑芳zhengfang@lcsw.cn，林喆lz@lcsw.cn，郭欣怡guoxinyi@lcsw.cn，成幸chengxing@lcsw.cn
正文内容：
XXX学校申请交行分行网点机构号，烦请处理。
​

  1. 交行官方会回复分配“三方银行分配机构号”的邮件；
  2. 扫呗侧申请配置交通银行电子三类卡开卡参数，用收到邮件的机构号，和其他具体参数（APPID和公钥）配置：

注：具体参数配置向扫呗运营申请
image.png

  1. 参数配置完成后，可至 扫呗校园通/校园通 小程序开卡签约即可
    支付宝搜索“扫呗校园通”小程序 - 点击“我的账户” - 添加“电子账户”继续完成开通。

更新推送

设备端需保证3个程序是最新版本：系统固件、smile APK、校园通APK。更新推送目前指定扫呗终端运营组同事处理，如需单独推送，可联系对应负责人员。

终端校园通收银APK更新

详情参阅：推送流程
注：
1. 设备SN拿到后推扫呗校园通要同步推smile APK，版本为4.6.0.754【暂时，后续可能有更新】，包名为com.alipay.zoloz.smile；
2. 后续出货设备系统版本最低为2.0.1.202003029181_RS，此版本中带4.4.0.82版本的smile APK；

小程序更新

  1. 确认扫呗研发侧已完成代码提交；
  2. 登录支付宝服务商平台，找到对应小程序，点击提交审核，填写相关资料；

支付宝IOT小程序提交审核操作SOP
备注：K12业务推广不推荐给合作商小程序做实施。

钉钉接入

1. 登录后台

1.1 学校钉钉管理员账号扫码登录「钉钉管理后台」点击登录，或直接钉钉扫码：
image.png

1.2 确认学校后点击登陆
image.png

2. 创建应用


2.1 进入“钉钉开放平台”后，点击顶部“应用开发”>>“企业内部开发”；
image.png

2.2 点击“创建应用”>>“H5微应用”，按要求填写应用名称、信息（比如：XX学校校园通 等），填写完毕点“确认创建”；
image.png

2.3 点击“开发管理”>>“修改”；
image.png

2.4 在“应用首页地址”内填写“扫呗校园通”或“校园通”地址（*请注意区分）；
image.png

扫呗校园通：https://ds.alipay.com/?scheme=alipays://platformapi/startapp?appId=2021001170655023&page=pages/index/index 校园通：https://ds.alipay.com/?scheme=alipays://platformapi/startapp?appId=2021001193675073&page=pages/index/index

​

2.5 点击“版本管理与发布”，在“可使用范围”下点击“添加”。弹出“选择人员”弹窗，可勾选添加需要此功能的人员。完成后点“确认”保存。
image.png

2.6 回到“版本管理与发布”，点击“应用发布”下的“确认发布”。
image.png

3. 效果验收

打开校园钉钉，点击底部进入企业应用中心，下滑至“未分组应用”板块，即可看到“扫呗校园通”或者“校园通”已在列，直接点击即可跳转。
image.png

企微直进扫呗校园通

进入企业微信点击“工作台” - 拉到最下面的模块 - 点击“微信小程序”模块 - 搜索“扫呗校园通”直接进入小程序
image.png

​

关于微信垫资

1. 功能说明

以下是微信官方关于校园刷脸垫资介绍：校园刷脸支付平台垫资-介绍与接入流程
​

2. 关闭垫资功能步骤

如需关闭垫资功能，请提前与微信官方相关人员沟通后，发邮件申请关闭。以下是邮件模板：
​

邮件标题：【k12刷脸学校关闭垫资功能申请】XXXXX公司 + 日期
发送至：v_ynfengliu@tencent.com
抄送：shuangyihou@tencent.com; kingsleycwu@tencent.com; ethantjli@tencent.com; zlxiang@tencent.com; sueswchen@tencent.com; leosgwan@tencent.com; v_jahaochen@tencent.com; wxpay_edu@tencent.com;
（建议发邮件之前再次跟微信官方人员确认发送地址是否正确）
邮件内容：
​

Dear:
现有以下学校申请解除垫资功能，请处理。
学校关闭垫资功能申请表
（请下载链接内表格模板，按要求填写信息后将表格粘贴在邮件正文）

© 利楚商服 2020 All rights reserved.