# 软件服务商接入

# 阅读对象

在微信刷脸支付过检设备上，集成刷脸支付能力的商户或服务商，负责刷脸支付软件功能的产品、设计、研发及相关技术人员。

# 接入流程-刷脸设备

# 流程说明

刷脸能力开发阶段，即设备正式商用于门店之前，原则上商户须完成下述整体体验验收后，方可启动设备落地门店商用。

# 1. 开发前置条件

# 1.1 刷脸设备要求

服务商/商户使用的刷脸支付设备须在《过检设备名录》范围内的设备，或通过“微信支付硬件服务”公众号获取过检设备名录；自行联系设备厂商采购设备；

如若需要了解更多设备过检状态，可联系刷脸支付项目经理确认。

# 1.2 软件模式确认

确认采购的设备软件模式是否适用您的业务场景。

# 1.3 网络环境要求

微信刷脸设备，在实际使用环境中，需要满足微信刷脸支付网络环境的标准要求。因此在设备落地安装之前，需服务商与商户共同评估网络环境是否满足。

详情查看《设备网络环境要求》

# 1.4 刷脸权限开通

目前设备刷脸权限已支持默认开通，如果你的商户号无刷脸权限可参考：《刷脸权限开通》

# 2. 交互设计及开发指引

软件开发需满足整体体验要求：用户在微信刷脸支付设备上，完成一笔完整的刷脸支付交易的过程体验，包括：所见界面、刷脸过程、各环节等待时长到最终完成一笔刷脸交易；

共3部分：交互及设计规范、体验指标要求、交易上报。

# 2.1 交互及设计规范

商户/服务商需参考《微信刷脸支付-商户APP设计指引》进行软件方案设计和开发。

# 2.2 刷脸SDK接入

(1) 商户软件涉及刷脸功能的部分，参考《刷脸支付开发指引》进行开发接入；

(2) 如果还需要在刷脸设备运行小程序，请分别阅读：
a. 《硬件运行小程序产品介绍》
b. 《青蛙小程序接口》

注意： 商户/服务商需参考以下“刷脸体验指标要求”进行开发。
a. 软件开发时，调起刷脸摄像头时不被其它进程阻塞，避免导致耗时变长；
b. 软件开发时，订单支付时不被其它进程阻塞，避免导致耗时变慢。

刷脸体验指标不仅仅关注刷脸和查单的效率，而且覆盖了商户界面从启动、SDK调起、优选、识别、操作到商户发起支付、查单、结果以及运营动作的全过程。

围绕以上过程，微信刷脸支付根据每个阶段的耗时、成功率的情况，进行评判是否验收合格。

# 2.3 交易上报

SDK集成后，还需要完成APP的付款码支付交易上报，详细请查看《上报接口对接》。
注意：未做交易数据上报的，不能追加设备申请且不能参与相关刷脸活动。

# 3. 软件验收

# 3.1 交互设计方案验收

为提前发现问题，避免开发后返工，须在服务商/商户完成交互/UI后，在软件开发前；

在微信群里提供和微信刷脸相关的《设计文档》供微信支付进行验收，微信支付将反馈验收结果及优化意见，未得到微信支付确认前不进入开发阶段。

# 3.2 门店试点前验收

服务商/商户软件开发完成后，投放门店试点前；

在微信群里提供完成“刷脸支付交易”和“扫码支付交易”各3笔的“设备SN”以及“完整收银流程视频”供微信支付进行验收，微信支付将反馈验收结果及优化意见，未得到微信支付确认前不进入门店试点。

# 3.3 门店批量前验收

商户/服务商将刷脸设备投放门店试点后，批量商用前；

在微信群里提供完成“刷脸支付交易”和“扫码支付交易”各3笔的“设备SN”以及带有收银台环境信息的“完整收银流程视频”供微信支付进行验收，未得到微信支付确认前不进入门店批量铺设设备。

# 3.4 验收补充说明

(1) 不同商户APP需分别验收，如服务商同时为不同商户提供定制化APP服务，刷脸支付交互有较大差异，需提前报备进行验收；

(2) 落地后商户APP版本有重大更新，对刷脸支付交互体验与验收时不一致，应报备微信支付团队进行验收通过后再更新。

# 4. 软件版本售后

# 4.1 商户APP要求

(1) 软件服务商或商户开发团队需保障商户APP的稳定运行，为商户提供软件技术支持；

(2) 商户APP若存在可用性或者易用性方面的问题，需进行改造，针对微信SDK的版本升级，需对新版本进行适配，保障刷脸SDK稳定运行。

# 4.2 刷脸SDK升级能力要求说明

(1) 为保障微信刷脸支付及相关业务正常使用，本公司有权对包括但不限于SDK、摄像头等软硬件内容进行更新、升级、维护，并有权基于自身需要进行营运活动的投放等；

(2) 同时应采取相应的安全保障措施，保障本公司前述权利的实现，保障生产的智能硬件设备自身的系统与内核安全，防范网络攻击、系统漏洞，蠕虫木马等风险；

(3) 前述约定内容的实现，可能会增加硬件设备的流量消耗等，你应承担由此产生的相应费用。

# 5. 问题反馈

开发中遇到的问题可以前往《开发者社区》进行反馈。

# 接入流程-校园一脸通设备

# 1. 权限和设备申请

# 1.1 申请总览

# 1.2 商户号申请

1.2.1 创建小程序

（1）服务商需要先创建小程序。
● 跳转到官方小程序需要一个入口承载（如果有服务商、小程序则不用申请，可直接进行联调），请点击进入《小程序注册流程》进行查阅。

1.2.2 申请服务商和特约子商户（直连商户选此步）

（1）服务商申请流程（有则不需要申请）
● 请点击进入《服务商申请流程》进行查阅。

（2）特约子商户申请流程（每个学校都对应申请）
● 请点击进入【服务商功能】-【特约商户申请】- 新增商户。

1.2.3 注册从业机构、录入渠道商（间联商户选此步）

（1）从业机构、渠道商注册详见指引，有则不需要申请。

（2）从业机构使用结算规则ID进行特约商户（每个学校都对应申请）。
从业机构根据特约商户的主体类型和经营行业确定对应的结算规则ID进行报名，并将结算规则ID传入特约商户报备API的经营类目（business）字段中。结算规则ID决定了特约商户的默认费率，详细内容请点击《行业结算ID对照表》进行查阅。
结算ID可参考如下：

（3）渠道商通知特约商户进行开户意愿确认。
商户可根据以下的方式（任选其中一种方式）进行开户意愿确认：
● 使用商家注册API完成开户意愿确认，请参照《商户开户意愿确认文档—API版本》的指引内容。
● 商户通过小程序操作进行开户意愿确认，请参照《商户开户意愿确认文档-小程序版本》的指引内容。

（4）从业机构可通过获取商户开户意愿确认状态API确认结果。

# 1.3 刷脸服务学校机构ID申请说明

（1）新增机构ID需要在服务商后台进行申请，审批通过生效后机构ID才能启用。

（2）已有的机构ID需要新增刷脸支付商户号，需到指定机构ID管理页面申请，审批通过生效后才支持刷脸支付扣费。

1.3.1 机构定义与学校子商户的关系

（1）学校、公司等都是机构，当前以机构为单位维护人脸特征库。因为学校主体需要机构ID承载，在未正式接入学校前，服务商需要申请1个测试机构ID进行联调，服务商可以在此机构ID下虚拟创建若干员工身份信息，用于联调测试。

（2）机构ID与学校商户号的关系：1个服务商下的1个学校仅建议建1个学校机构ID。学生人脸库以学校机构ID为单位维护人脸特征库，学校子商户需要调起人脸支付则在申请学校机构ID后把子商户和学校机构ID进行关联绑定。

1.3.2 机构ID申请字段说明

1.3.3 测试学校机构ID申请——邮件申请

测试机构ID通过邮件申请，注意机构ID具有唯一性，名字不可重复，所以测试机构ID的名字可以随意命名。

服务商在首次接入离线刷脸能力（K12/高校/企业团餐刷脸方案）时，需要生成机构ID进行开发及测试；为了节省测试机构ID生成成本及管控成本，微信支付支持通过邮件流程，在无学校资质的前提下，生成测试机构ID提供给服务商进行测试。

注意：测试机构ID只有测试场景值权限，即business_scene_id只允许按如下规则传入，传入其他business_scene_id会造成报错。

申请方式如下：
● 申请表模板请下载：【离线刷脸】测试机构ID申请表
邮件发送：wxpay_edu@tencent.com
邮件抄送：kingsleycwu@tencent.com;ethantjli@tencent.com;zlxiang@tencent.com;v_ynfengliu@tencent.com;
leosgwan@tencent.com;brucefu@tencent.com;v_jahaochen@tencent.com
主题格式：[申请生成测试机构ID][服务商名称][日期]
正文包括如下：
你好，申请测试机构ID用于**业务场景，请协助处理。
（将表格内容粘贴到正文里，勿以图片形式呈现，即不要截图）。
附件加上【离线刷脸】测试机构ID申请表。

1.3.4 正式学校机构ID申请——线上申请

（1）机构ID申请链接页面
登录服务商后台后复制打开链接：https://pay.weixin.qq.com/index.php/xphp/corganization/index#/?page=1。

（2）机构ID申请示意
K12机构ID申请

「刷脸签约模式」选择说明：

● 亲属代扣（仅K12学校支持申请）：亲属使用刷脸服务，本人为其扣费；适用于没有个人微信号场景，例如学生刷脸消费，家长账户扣款；
● 本人扣费（内测中）：即本人自己使用刷脸服务由本人账户扣款；适用于成年人，微信实名认证用户；
● 建议学校未成年学生使用亲属代扣模式，校园教职工等成人使用本人扣费模式以满足合规要求；
● 申请亲属代扣需先开通校园刷脸权限，详细开通流程请见《服务商模式校园刷脸代扣线上开通操作指引》内容。
● 申请本人扣费需先开通企业团餐刷脸权限，详细开通流程请见《服务商模式校园刷脸代扣线上开通操作指引》中的5.2高校或企业内容。

高校机构ID申请

「刷脸签约模式」选择说明：

● 高校暂不支持选择亲属代扣，请选择本人扣费模式；

机构ID申请资料要求：
● 学校主体：提供学校主体证件，特殊情况需要提供学校主体含盖章的证件；
● 学校外包食堂主体：提供子商户与学校的合作协议能体现学校主体的盖章；
● 学校机构logo（仅高校需要提供）：图标尺寸：128px*128px；图标文件格式：jpg格式；
logo形状：需要上传方形的图，但注意我们展示的是圆形的区域，不要超出区域。

特殊注意事项：
a. 学校含括两种称呼以上的，例如XX大学（XX院校的）学校主体证件需含学校主体的盖章；
b. 学校机构ID名称需要和学校主体证件名称及盖章的文案一致，如果XXX大学（XXX大学分校）则以学校盖章的文案为准确认这个学校机构ID的名称。

1.3.5 机构ID相关疑问说明

新增学校机构ID都建议走线上申请生成机构ID，包含K12、中职、大专和大学均要完成线上申请。

# 1.4 选用IoT设备

1.4.1 申请团餐机摄像头

教育行业摄像头申请使用说明：
● 服务商申请校园行业的摄像头只能组装在校园团餐机上；
● 摄像头对应的校园团餐机只能落地在校园食堂团餐场景；
● 一经发现摄像头团餐机落地的非校园食堂场景，微信侧有权进行追责。

（1）申请入口白名单
首次申请摄像头的服务商需开白名单，发送邮件到指定邮箱申请开通白名单，微信侧收到申请邮件后每周一和周四16:00统一处理。
申请方式：
邮件发送：wxpay_edu@tencent.com
邮件抄送：kingsleycwu@tencent.com;ethantjli@tencent.com;zlxiang@tencent.com;v_ynfengliu@tencent.com;
leosgwan@tencent.com;brucefu@tencent.com;v_jahaochen@tencent.com
主题格式：[校园刷脸设备白名单开通申请][服务商名称][日期]
正文包括如下：
你好，现有以下服务商申请开通校园刷脸设备白名单
服务商名称：
服务商商户号：

（2）刷脸服务接入备案（无则跳过此步）
当申请摄像头的商户满足以下三种情况之一的，须发送邮件到指定邮箱进行『刷脸服务接入备案』，未备案者无法完成设备申请！
● 早期已申请过扫码设备，现需申请摄像头；
● 同时申请扫码设备及刷脸设备摄像头；
● 早期已申请过刷脸设备摄像头，现需申请扫码设备。

申请方式：
● 申请表模板请下载：设备申请接入备案表模板
邮件发送：wxpay_edu@tencent.com
邮件抄送：kingsleycwu@tencent.com;ethantjli@tencent.com;zlxiang@tencent.com;v_ynfengliu@tencent.com;
leosgwan@tencent.com;brucefu@tencent.com;v_jahaochen@tencent.com
主题格式：[设备申请接入备案][服务商名称][日期]
正文包括如下：
你好，现有以下商户早期已申请扫码设备x台，现需申请摄像头x台，请审批。
（将表格内容粘贴到正文里，勿以图片形式呈现，即不要截图）。
附件加上设备申请接入备案表。

（3）白名单申请通过后，服务商前往后台申请设备
『申请路径』：登录服务商后台--服务商功能--刷脸智能设备--智能设备申请--刷脸设备申请--华捷摄像头--填写相关信息（必须以特约子商户维度申请摄像头，以服务商名义申请后台流程无法流转到审批）。

『申请规则』：服务商根据预期落地的学校需求情况申请摄像头（需提供学校名称、学校人数、设备数量） ，服务商申请的摄像头，需将摄像头发给合作对接的硬件服务商进行收货，然后服务商再从硬件服务商处拿到人脸机具整机设备进行落地。

『校园团餐摄像头申请填写要求』：

● 设备ID：sku1007
● 设备名称：华捷摄像头
● 设备品牌：华捷艾米A200竖版 （校园食堂刷脸产品匹配摄像头型号为：竖版A200+mini）
● 商户所属行业：校园
● 商户介绍：「校园食堂刷脸项目」本次摄像头申请合计10个学校，合计xx个食堂，一共有xx个档口，需要xx个摄像头，该学校总体消费支付日均消费笔数xx笔，日均消费金额xxx元。然后把每个学校明细列举，需提供学校名称、学校人数、设备数量。
● 校园食堂刷脸产品匹配摄像头型号为：竖版A200+mini，请务必在备注栏填写所需要数据线型号（70cm弯头数据线、120cm直头数据线二选一），无备注要求默认不发送数据线！

特别说明：
a. 收货地址要求：申请的摄像头需要发通过验证的硬件商进行生产后出货，服务商申请摄像头前需要确定合作的硬件商，所以地址需留硬件商地址。
b. 线上申请后请在微信群内告知申请子商户商户号及服务商主体：
服务商商户名称：智校XX有限公司
特约商户名称：哈XX中学
申请日期：XXXX年XX月XX日

（4）摄像头发货后需要考核服务商铺设落地活跃率
服务商申请摄像头，微信发货6个月后考核人脸机具落地交易率是否≥ 80%，且已落地的机具自然月台日均交易笔数是否≥70。每个月监控与考核用户对应申请月份的活跃率，未达标者，暂停其摄像头的申请，并可能影响其后续返佣的获取。

落地交易率计算活跃示例：

自然月台日均交易笔数计算示例：

1.4.2 自行采购摄像头-非团餐机
对于非团餐机，如牛奶机、门禁机、视频公话机等设备类型。微信支付不赠送摄像头，需要因学校场景室内外光线差异大、身高差异大，针对分别推荐不同摄像头型号如下：

牛奶机
摄像头选型建议：针对自助售货机一般处于室外光照较强场景，且校园学生身高差距较大。允许在校园自助机使用的摄像头型号为RMSL201、RMSL205、华捷A100EX、华捷A200EX，以上四款摄像头具有较好的户外适应性和垂直高度更高的视场角，可参考《摄像头文档》。

针对已集成结构情况，若已集成华捷A200型号，硬件结构调整困难，可以继续申请华捷A200EX，提升识别效果；若已集成华捷A100型号，不存在硬件结构调整，建议申请RK系列摄像头，获得更好的识别效果。

门禁机
目前微信刷脸支付支持使用并已通过验收的2D摄像头可查看如下表中微信刷脸已验收的2D摄像头表格， 内含各摄像头厂商型号规格及联系方式。

视频公话机
为保证微信刷脸支付用户体验，微信刷脸支付针对摄像头的引入进行了严格的测试和认证，目前微信刷脸支付支持使用的摄像头列表如下：

1.4.3 过检设备名录
软件服务商使用的刷脸支付设备须在《人脸开放平台过检设备名录-K12校园行业类》范围内的设备，或通过“微信支付硬件服务”公众号获取过检设备名录；自行联系设备厂商采购设备；如若需要了解更多设备过检状态，可联系刷脸支付项目经理确认。

学校场景需要配套符合场景的设备。形态为团餐机，推荐选用在产品库内且经过第三方检测和国家认证的设备。

# 2. 交互设计及开发指引

软件开发需满足整体体验要求：用户在微信刷脸支付设备上，完成一笔完整的刷脸支付交易的过程体验，包括：所见界面、刷脸过程、各环节等待时长到最终完成一笔刷脸交易；

共3部分：交互及设计规范、体验指标要求、交易上报。

# 2.1 交互及设计规范

商户/服务商需参考《微信刷脸支付-商户APP设计指引》进行软件方案设计和开发。

# 2.2 刷脸SDK接入

商户软件涉及刷脸功能的部分，参考《K12开发文档》进行开发接入。

# 3. 平台能力接入

# 3.1 采集和签约小程序接入

服务商采集小程序申请与绑定常见问题
（1）服务商申请进行小程序创建后，怎么去采集人脸信息？
答：服务商创建好小程序后，服务商侧，采集人脸是跳转到微信官方采集人脸小程序，签约是调起签约组件即可。

（2）服务商创建小程序、申请创建小程序的流程和注意事项？
答：请参考《小程序注册流程》。

注意：
a. 小程序内容不能涉及发布失败，提示涉及采集用户生物特征（人脸照片或视频）及其他敏感信息，平台暂不支持？
答：服务商小程序调取官方采集人脸小程序，所以小程序是不能做这些内容的，建议在申请时候说清楚业务情况。
b. 小程序如果要做订餐业务需要怎么样的资质？
答：上线订餐需要有相关的餐饮许可证等证件。
c. 小程序的采集业务是必须先在公众号绑定学生，然后才能在小程序进行人脸采集。这个小程序发布被驳回了？为什么？
答：小程序的申请发布不能涉及诱导性分享，小程序涉及强制诱导性分享，因此不能通过。

（3）服务商创建的小程序和商户号是同主体，存在多个APP id该如何进行绑定？
答：服务商只能绑定一个app id，默认绑定申请生成商户号对应的公众号app id。如果需要替换为新申请的APPid，需要先解绑之前默认绑定的app id。

（4）学校商户号收款需要调起服务商签约采集的小程序app id，需要在服务商后台进行绑定后才能调起支付成功。
答：服务商为特约商户配置App ID（即sub_appid）操作指引请参考：https://kf.qq.com/faq/190715yaYnYv1907153mmIbA.html。

# 3.2 离线SDK接入

平台提供一个支持离线识别的SDK，该SDK只能在指定类型设备上使用，需要合作伙伴自行开发完整APP并集成SDK，且需要开发对应的手机端小程序产品以保证完整的用户体验。离线SDK模式覆盖支付能力及门禁能力，并兼容指定型号2D摄像头使用门禁能力。

该模式适合半封闭或全封闭型场景如学校等，需要合作伙伴有较强的开发能力。

3.2.1 离线SDK申请
请先获取测试版本SDK，进行功能调通，全流程调通后请录制视频与截图发送邮件给微信支付刷脸团队进行审核。

测试版SDK获取地址：
微信支付刷脸门禁联调对接
微信支付K12团餐联调对接
微信支付K12视频公话机联调对接

（1）使用《开发检测工具》完成设备检测附上截图，下载并填写《软件预检测用例》。
● Tab 硬件规格
● Tab 1.安全
● Tab 2.系统功能(支付)
● Tab 3.系统功能(系统设置)

（2）MP4格式的真机演示视频，视频应包含完整购物流程，并控制视频大小不超过20MB。

（3）设备安装&操作指引.PDF格式可参考《桑达3308手册》。

（4）下载并填写《摄像头测试Checklist》。

整理好以上文件，通过微信支付商户平台 ->产品中心->我的工具箱->设备服务商 选择对应的设备型号(若无对应设备型号请先添加设备型号），点击「查看」按钮，选择「软件检测」，可以提交该设备型号的样机检测文件。
详情提交信息可参考设备型号添加。

（5）功能调通页面及视频包括：
● 小程序流程及交互(视频录制及截图)
● 终端页面流程及交互(视频录制及截图)
● 测试扣费凭证(视频录制及截图)

申请方式：
邮件发送：v_ronghanxu@tencent.com
邮件抄送：frostpeng@tencent.com;ethantjli@tencent.com;kingsleycwu@tencent.com;chunhohuang@tencent.com;
gatlin@tencent.com;taraye@tencent.com;curveyuan@tencent.com;carolinexu@tencent.com;v_xlanzhang@tencent.com;
v_zhiqangli@tencent.com;v_tintnzhao@tencent.com;v_yinxiding@tencent.com; v_yawexiao@tencent.com;v_quandu@tencent.com
主题格式：[微信人脸开放平台正式版离线识别SDK申请][服务商名称][设备型号]
正文包括如下：
你好，xxxx公司申请正式版离线SDK
1. 附件材料说明
2. 业务铺设学校数量、预计落地设备数量
3. 微信分配的设备型号前缀
附件包含小程序采集签约流程、终端完整支付流程、终端异常流程与家长微信支付消息/服务商公众号（小程序）支付消息页面。

3.2.2 获取正式的终端SDK
审核通过后，凭审核通过结果邮件联系微信刷验支付团队，发放正式的终端SDK。

# 3.3 垫资能力接入

3.3.1 垫资限制及注意事项
（1）行业限制
目前仅K12学校支持接入垫资能力，高校及企业暂不支持。

（2）场景限制
目前仅食堂团餐场景支持垫资。

（3）垫资额度及次数限制
● 用户垫资次数及额度限制：
a. 每个用户可垫资次数上限：3次
b. *达到3次上限后，需先还款才可以继续使用垫资
c. 每个用户单笔垫资额度上限：100元
● 总体垫资额度上限：
微信支付根据服务商下接入本产品的商户交易笔数及增幅计算总垫资额度，仅支持正常交易情况下的垫资需求，若超出垫资总额度，平台将无法为服务商下的商户订单进行垫资。
● 其他垫资说明：
用户侧不感知某笔订单是否被垫资，也即无论该笔订单垫资成功或失败，用户不会收到任何带“垫资”字样的信息，仅在垫资成功后会收到欠款通知。

（4）注意事项
a. 服务商需要做相应风险控制策略以保障垫资能力正常使用：
● 用户在垫资次数达上限后禁止进行刷脸支付，防止出现离线模式下交易完成但无法垫资造成坏账的情况；
● 不可对外展示用户垫资的限制规则，并制定额外风控策略，防止出现恶意欠款产生异常大量垫资的情况。

b. 平台垫资的暂时性
● 垫资目的为保障商户的利益与体验，支持业务迅速推广上线。垫资资金前期将由微信支付平台出资，后期规划开发相应产品能力支持服务商出资进行垫资。

3.3.2 申请接入流程
（1）与运营经理沟通接入垫资需求的背景

（2）申请方式
● 申请表模板请下载：垫资接入需求申请表
邮件发送：wxpay_edu@tencent.com
邮件抄送：kingsleycwu@tencent.com;ethantjli@tencent.com;zlxiang@tencent.com;v_ynfengliu@tencent.com;
leosgwan@tencent.com;brucefu@tencent.com;v_jahaochen@tencent.com
主题格式：[垫资接入需求申请表][服务商名称][日期]
正文包括如下：
你好，我司申请接入垫资功能，以XXXXXX（说明接入垫资的原因），请审批。
附件加上垫资接入需求申请表
特别说明：
● 服务商开通刷脸代扣权限后再提交垫资申请；
● 提交后需要发邮件向运营同步申请表已提交完成。

（3）运营经理审核申请表并进行垫资配置，配置完成以邮件回复方式同步服务商。

（4）测试：服务商准备一个已开通校园刷脸服务的微信号做功能测试，详情请查阅测试用例。

（5）每周配置1次。

# 3.4 指定银行卡能力

3.4.1 行业痛点
银行有开卡/活卡诉求，但一直缺少低成本、大量获取用户的渠道。在校园新生入校、家长办卡是一个投入少、产出高的场景，银行为此愿意出资购买设备，承担服务商的学校落地成本。

3.4.2 产品价值

3.4.3 产品介绍

开卡&签约业务流程：

业务界面示意：

开卡&签约完整流程：

流程说明：
（1）开卡：
● 线下办卡：用户已在线下办理了银行卡，只需在「k12小程序」进行绑卡和签约。
● 线上办卡：用户先在「商户小程序」完成开卡，然后跳转到「k12小程序」绑卡和签约。

（2）绑卡：
● 一键绑卡：系统判断指定卡是否添加到微信支付账号，如果已添加，则直接进入签约页面；如果未添加，需要短信验证快速绑卡。
● 降级普通签约：在绑卡短信验证时，如果银行判断手机号预留不一致、导致无法签约，服务商可调用降级接口，允许用户不绑卡、使用普通方式签约。

（3）签约：
● 指定卡签约：有限定卡和优先卡两种模式。
限定卡模式：用户只能用指定的银行卡号进行绑卡和签约。
优先卡模式：用户如果指定卡号绑卡失败，部分情况下允许降级为普通签约。
目前只有工行的“用户输入的手机号与银行预留手机号不符合”可以降级，如果其他错误码也想要降级，服务商可以提出申请、平台进行配置。
● 普通签约：签约页面的支付方式可选择任意卡或零钱支付。

（4）扣款：
● 指定卡签约：扣款时只能从该卡扣款，无法从其他卡或零钱扣款。
● 普通签约：扣款时系统自动轮询使用银行卡或零钱。

（5）平台垫资：指定卡签约无垫资，普通签约有垫资。

3.4.4 接入指引
离线刷脸商户接入可查阅“开发指引”的“K12开发文档”中《4.后台接口》内容。

3.4.5 常见问题
（1）用户身份与微信账号实名不一致？
请先确定「开卡人信息」与「微信账号实名」一致，才能完成签约。若不一致请更换使用开卡人的微信号或修改此微信号的实名认证。

（2）用户绑卡短信验证，返回预留手机号不一致？
在短信验证时，有的银行会校验用户一类卡的预留手机号，如果不一致或者查询不到，就会禁止绑卡。
● 服务商在接入银行时，与银行沟通放开手机号验证，避免后续用户遇到这个问题。
● 如果银行不同意放开，当用户绑卡遇到该问题，用户可以输入不同手机号尝试绑卡，或者联系银行更换预留的手机号。
● 服务商可以调用接口，允许无法绑卡的用户放弃绑卡，降级为非指定卡完成签约。

（3）用户绑卡时，返回查询卡号失败？
● 用户指定卡签约，服务商调用预签约接口时建议传入银行卡类型。
● 银行的新增卡号字段需同步给微信支付侧接口人，财付通添加，未添加的卡号字段，将导致绑卡失败。

（4）银行返回的绑卡失败文案，用户难理解？
● 服务商接入银行时，需获得银行错误码列表并同步给微信支付侧接口人，共同完善用户指引。

（5）在一个时间段内大量订单代扣失败？
● 请提前与银行沟通、确定银行系统维护时段，避免这些时段发起代扣。
● 请确定银行网络抖动的时间，和银行核实情况，待银行系统恢复。

（6）指定卡签约有卡类型限制？
● 指定卡签约，微信支付侧不限制卡类型，借记卡、信用卡均可签约。
详细内容可查阅指定卡问题和措施。

# 3.5 签约状态变更回调

服务商为学校开发基于师生的用户管理体系时，需要维护用户的采集和签约状态，并同步至刷脸设备。服务商只能获取用户签约信息，不能获取用户解约信息，导致服务商无法维护用户状态，需要服务商进行申请配置回调通知，刷脸用户在完成签约或解约后，微信会通知商户用户签约状态变更。服务商需要接收处理，并返回应答。

申请流程如下，填写表格发送给对应邮箱，微信侧会在2-3个工作日配置完成。
● 申请表模板请下载：【校园刷脸】申请用户解约通知申请表
邮件发送：wxpay_edu@tencent.com
邮件抄送：kingsleycwu@tencent.com;ethantjli@tencent.com;zlxiang@tencent.com;v_ynfengliu@tencent.com;
主题格式：[申请用户解约通知][服务商名称][日期]
正文包括如下：
你好，我司申请XXXX（将表格内容粘贴到正文里，勿以图片形式呈现，即不要截图）。
附件加上【校园刷脸】申请用户解约通知申请表。

离线刷脸签约状态变更回调开发文档：

接口规则
● 认证方式：HTTPS协议，SHA256 with RSA进行签名。
● 返回和提交数据的签名，商户号，时间戳，随机串等在HTTP头中传递。
● 提交和返回结果采用JSON格式。
● 字符集默认使用UTF-8，请勿使用其它字符集。
● 交互的返回和回调数据都需要校验签名。
【离线刷脸回调通知-用户签约状态变更通知 API】

应用场景
刷脸用户在完成签约或解约后，微信会通知商户用户签约状态变更。商户需要接收处理，并返回应答。出于安全的考虑，我们对数据进行加密，商户需要先对通知数据进行解密，才能得到用户签约状态信息。

对后台通知交互时，如果微信收到应答不是成功或超时，微信认为通知失败，微信会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但微信不保证通知最终能成功。

注意：同样的通知可能会多次发送给商户系统，商户系统必须能够正确处理重复的通知。

推荐方式：当商户系统收到通知进行处理时，先检查对应业务数据的状态，并判断该通知是否已经处理。如果未处理，则再进行处理；如果已处理，则直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。

签约状态变更通知业务序列图
签约: 服务商可以通过签约小程序引导用户完成签约，此时微信离线刷脸业务系统将会发送签约变更状态给到服务商提供的回调地址。

解约: 解约入口有两个，一个是微信用户通过微信客户端发起解约，一个是商户通过调用后台API接口进行解约。解约后，微信K12业务系统将发送签约变更状态给到服务商提供的回调地址。

以下是签约通知状态变更业务中，微信离线刷脸业务系统和商户后台系统交互的序列图：

接口说明
环境：正式环境
请求方式：post
请求地址：该链接由商户提供，微信审核通过后上线。URL必须为https协议，如果链接无法访问，商户将无法接收到微信通知。通知url必须为直接可访问的url，不能携带参数。示例：
notify_url：“https://api.yourcompany.com/notify/process.action”

请求参数

用户签约变更通知是以POST方法访问商户设置的通知url，通知的数据以JSON格式通过请求主体（BODY）传输，通知的数据包括加密的支付结果详情。
resource对象列表：

下面详细描述对通知数据进行解密的流程：
a. 用商户平台上设置的APIv3密钥【微信商户平台—>账户设置—>API安全—>设置APIv3密钥】，记为key。
b. 针对resource.algorithm中描述的算法（目前为AEAD_AES_256_GCM），取得对应的参数nonce和associated_data。
c. 使用key、nonce和associated_data，对数据密文resource.ciphertext进行解密，得到JSON形式的资源对象。
注意：AEAD_AES_256_GCM算法的接口细节，请参考rfc5116。微信支付使用的密钥key长度为32个字节，随机串nonce长度12个字节，associated_data长度小于16个字节并可能为空。
解密后的resource对象列表：

{
	"user_id": "FUxxxfjeiofewfefw",
	"out_user_id": "fefwe33333333",
	"organization_id": "OPfefewwefwe",
	"mch_id": "1233456",
	"notify_create_time": "2020-05-20T10:23:14+08:00",
	"appid": "fefefewfefew",
	"openid": "fjeofejwofewfew"
}

通知签名
加密不能保证通知请求来自微信。微信会对发送给商户的通知进行签名，并将签名值放在通知的HTTP头Wechatpay-Signature。商户应当验证签名，以确认请求来自微信，而不是其他的第三方。签名验证的算法请参考《微信支付APIv3签名方案》。

通知应答
商户后台在正确处理回调之后，需要返回200或者204的HTTP状态码。其他的状态码，微信支付均认为通知失败，并按照前述的策略定期发起通知。注意，当商户后台应答失败时，微信支付将记录下应答的报文，建议商户按照如下格式返回。

应答示例

{
	"code": "ERROR_NAME",
	"message": "ERROR_DESCRIPTION",
}

# 4. 落地实践指导

# 4.1 现场安装部署

4.1.1 设备安装
微信刷脸支付团餐设备安装落地指南如下：

（1）安装高度
● 食堂场景安装高度： 摄像头距离地面高度，建议1500 mm ，能覆盖1.38～1.84米身高；
● 桌面收银安装高度： 摄像头距离地面高度，建议1500 mm ，匹配支架，旋转角度建议控制在20度之内；
● 注意事项： 应避免设备置于菜品水蒸气正上方。

食堂场景

（2）易用性检测

（3）功能检测

（4）常见异常解决方案-软件部分

（5）常见异常解决方案-硬件部分

（6）设备使用建议

4.1.2 网络部署建议

（1）网络连通

网络环境需符合《微信刷脸支付网络环境要求》，为了保障设备的实时通信，建议优先使用有线网。

● 有线连接
推荐使用有线网，网线采用符合国家/行业标准的超五类双绞线（CAT5e）、水晶头，布线前需使用网络测线仪测试通过，确保线序正确。
网线最大长度不超过100米，最好在80米以内，从交换机到刷脸设备中间的网线不得有接口、不能折死弯，不能被挤压。
走线时需将网线和其他的强电布线分开，避免电磁干扰。建议将所有线缆使用PVC管或者线槽保护，保证美观和安全。

● 移动网络4G连接
如果能够确保实际场地中移动或联通的4G信号较好（信号再满格）且稳定，可采用4G通信的方式。
4G物联网卡需符合国家物联网管理规定，做实名认证。

● Wi-Fi连接
如果因为场地限制不得不用Wi-Fi，可以先根据实地勘测，优先选择5G频段，如果场地中建筑的遮挡物较多，2.4G网络会可能更优。
Wi-Fi路由器尽量采用天花板吊装方式，如场地空间较大，可采用符合支持漫游协议的mesh路由。注意金属板、承重墙、玻璃对信号的阻挡或反射影响。
注意：当安装10台以上设备时，不建议采用Wi-Fi连接。

（2）带宽要求
● 网络类型
关于接入网络的出口，尽可能保证是独享带宽或者通过QoS做带宽保障，因为有些校园网或者共享网络是有域名过滤的，所以需要确保刷脸机与服务商后台和微信后台这个网络的连通性是好的。

● 有线网络部署
如下场景，需确保安装后，单台设备平均带宽有2Mbps以上的上下行带宽。同一局域网下，不能串联三个以上的交换机，如果不得不采用多台串联，需采用Trunk模式，但是要注意避免产生环路。
当安装4台以下设备时，可使用稳定、能够有20Mbps带宽以上的共用网络，采用简单网络拓扑的路由器直接连接即可。
当安装5台～30台设备时，可使用稳定，能够有100Mbps带宽以上的共有网络（需使用speedtest网络测试工具进行验证），并采用企业级路由器+管理交换机（1~4个）进行网络搭建。
当安装31台以上的设备时，推荐使用100Mbps以上的专线网络（需使用speedtest网络测试工具进行验证），并采用光猫+企业级路由器+企业级千兆管理交换机，组网时需针对每层楼划分VLAN，有条件的情况下尽可能每台刷脸设备划分独立VLAN。

● IP分配
当使用有线网或者Wi-Fi配置时，IP地址分配，注意给设备分配单独的网段，采用DHCP分配时，注意DHCP地址池需要足够大，避免出现IP地址无法分配的情况。

（3）供电要求
● 不断电要求
必须至少保证断电3小时以上的供电，建议采用UPS电源。
建议将路由器、交换机、刷脸机采用UPS电源连接（即不间断电源），当遇到断电时，能够将蓄电池的电能通过逆变器切换转换的方式继续供电，保障业务连续性。

● 强电接线
每个窗口的刷脸机采用独立插座，刷脸机所在的空气开关（漏电保护开关）下，不接其他电气设备，防止跳闸。
强电线路不与网线在同一线槽。

（4）网络检测方案
● 服务商APP开发改造
服务商在开发刷脸APP时，需要包括网络检测功能（暗码方式进入），当发起网络检测时，需和后台通信（尽可能模拟交易数据，最低限度是ping较大长度数据包，确保测试准确率），统计丢包情况、网络速度，并反馈到APP实时显示出来。

● 网络测试要求
a. 当网络和刷脸机安装完成后，所有设备同时在APP上开启网络测速功能（并发5分钟），每台设备的速度不低于200 K Byte/s，所有设备的丢包率不大于1%。
b. 当网络和刷脸机安装完成后，在刷脸机上安装微信提供网络可用性检测APP，完成所有网络检测，测试结果为pass。

● 刷脸实测要求
当确保网络测速结果符合要求之后，每台设备进行10次刷脸，从点击刷脸到识别出学生账号的时间，需在3秒之内。

# 4.2 签约及扣款指导

问题：用户因为扣款失败/微信号丢失等、导致支付欠款，触发服务商的账户冻结逻辑，学生无法刷脸就餐或消费。
措施：终端、微信消息展示冻结原因和措施指引；一线人员提供数据工具、提升家长引导服务能力。

4.2.1 学生刷脸界面：展示无法消费原因

问题: 学生刷脸后界面提示无法消费，学生不知道原因、无法告诉家长处理？
方案：根据微信侧回传的扣款失败原因，在终端界面上展示对应文案。

4.2.2 家长公号消息：支付失败和措施
问题: 服务商公号消息内容不清晰，家长看不懂、还要再咨询人工客服？
方案：根据不同刷脸扣款失败的原因，及时向家长推送通知，引导家长及时解决问题，避免影响亲属或子女正常使用刷脸扣费服务。

方案介绍
(1) 因余额不足导致扣费失败的通知
当刷脸消费产生但余额不足时，通过微信支付官方账号及时告知用户余额不足的情况，引导用户充值。
● 指定卡将明确展示该指定卡的尾号与银行信息，方便用户了解是哪张卡出现余额不足问题。

（2）因支付方式异常导致扣费失败的通知
支付方式异常包括无可用支付方式、银行卡异常、签约异常与微信支付被冻结几种不同情况。
● 无可用支付方式
可能是用户解绑了指定卡或微信账户未添加银行卡导致，将通过微信支付官方账户引导用户重新绑卡。

a. 目前暂不支持通过点击「立即绑卡」进入绑卡页面，请返回微信-【我】-【支付】-【钱包】-【银行卡】进行银行卡的添加绑定。

● 银行卡异常
因银行卡状态异常导致，将通过服务通知引导用户联系银行客服解决。

● 签约异常
因签约人解除签约导致扣费失败，将引导用户进行重新签约。

● 微信支付被冻结
因签约人微信支付账户被冻结导致扣费失败，将引导用户根据官方指引解除支付限制。

4.2.3 一线人员数据工具：实时查看学生代扣异常和措施建议
问题: 收到家长or学生咨询后，驻校人员无法及时获知原因，回复和处理效率低？
方案：使用官方提供的「落地小助手」，一线人员可以随时查看学生欠款原因和建议。