1.工作分工及流程

1.1业务接入流程：

1.2业务分工：

2.接入流程

2.1接入准备

1).签约准备

• 学校签约准备

      1.准备学校企业支付宝账户，由支付宝BD签约为商户签约商户代扣。（没有支付宝账户：ISV登录开放平台（https://open.alipay.com/platform/home.htm）帮助学校（商户））

      2.学校支付宝账户签约商户代扣产品、委托提现、刷脸产品，由支付宝BD同学签约。

• ISV签约准备

      1.ISV或厂商成为蚂蚁开放平台的开发者，创建小程序应用，获取开放平台小程序appid、第三方应用授权appid。

      2.挂载刷脸功能包和商户代扣接口包，需联系支付宝BD同学。

2)、开发准备

       1).用户准备

• 大于18岁的学生或教职工已注册支付宝实名认证账户
• 家长为孩子代开时，家长已注册支付宝实名认证账户

      2).数据准备

• 学校维度的数据：学校名称、支付宝账户、学校统一社会信用代码、学校唯一标识、人脸特征库下载地址、第三方应用授权、门店ID信息等
• 人员维度的数据：姓名、身份证、身份（学生、教职工、访客等）、照片、支付宝UID、代扣协议信息、学生监护人手机号等
• 注意：以上数据必须以“学校”为主体来提供，ISV与学校须有合作协议明确相关数据使用范围及隐私条款

    3).开发DEMO及相关SDK获取

• IOTSDK&封闭场景SDK&刷脸SDK

        在邻客蚁上建立项目统一提供。由行业客户端眞意统一上传。获取

• 服务端SDK下载 :点击下载

3).硬件采购申请及开店准备(按照业务要求视情况而定）

• 奥比摄像头采购申请（如果硬件评估通过，请忽略此环节）

第一步：邮件提交如下加白名单信息到 iot_campus@service.alipay.com

（1）申请厂商（或商户）名称及PID；（2）写明所属行业：可多选，如团餐等；（3）写明设备类型：可多选，如自助收银机、自助点餐机、售货机等；

第二步：加白名单完成后，在线（http://zimtmsvcprod.alipay.com/dapply/user/index.htm）采购下单，付款由申请者与蚂里奥线下完成。如选择D2，请再列表页面选择Torndo D2。调试样品和批量样品走同样的流程。

• 开店准备

i.创建门店：

第一步：ISV登录开放平台（https://open.alipay.com/platform/home.htm），选择运营中心 -> 商家管理 -> 我的商家

第二步：ISV代学校（商户）创建门店，“业务场景”必须选“K12”。如果签约主体是学校，门店类目选择“教育-学校-高中/初中/小学/幼儿园”；如果签约主体是承包商，门店类目选择“美食-团餐-校园团餐-高中/初中/小学/幼儿园”。

ii.绑定门店：参见接入说明

第一步：调用云端API接口绑定机具和门店关系，“isv_id”传ISV的PID，该PID是签署返佣销售方案的PID。并且需要开通接口权限@董晓斌

第二步：验证机具设备的注册、绑定数据

2.2技术对接：

  请各方开发者根据自身角色分别仔细阅读相关接口文档。集成流程及步骤：

2.2.1.硬件对接：(按照业务要求视情况而定）

      1.硬件选型，摄像头对接等相关IOT对接。isv或者支付宝业务同学，发邮件iot_campus@service.alipay.com 申请对接需求。iot解决方案同学收到后承接IOT对接。IOT接入流程，具体参见《校园行业IOT接入SOP指南 1.0 beta.pdf》 

      2.机具管控集成支付集成（设备厂商开发）

第一步：ISV和厂商按照物料信息表要求，邮件发出入驻申请iot_campus@service.alipay.com，解决方案收到邮件后内部走流程，启动IOT SDK集成适配

第二步：蚂蚁生成设备类型的支付宝唯一标识Item_ID、Supplier_sn，IOT解决方案在钉钉群公告

第三步：IOT SDK团队拿到Item_ID和Supplier_sn后，发布Profile.dat文件和IOT SDK测试包.获取

第四部：厂商将Profile.dat和IOT SDK测试包预置的机具里，预置要求参见IOTSDK厂商集成指南（如机具已经集成IOTSDK，可忽略此步）

第五步：ISV或厂商调用SDK数据上报接口发送设备行为数据，数据要求参见IOTSDKISV接入指南

第六步：IOT加签方法：https://alipay.open.taobao.com/docs/doc.htm?articleId=109629&docType=1#s1 本方案参见本地刷脸+代扣模式

3.iot传参标准说明（消费、核身场景传参要求，与返佣有关，请合作伙伴认证校对）

• 与返佣相关的交易及设备状态

分类	传参需求	Key	Value	value来源及使用说明	支付设备	门禁核身	接口连接
支付收单交易	刷脸代扣	auth_code	facetoken字符串	人脸SDK生成的facetoken字符串	必需	N/A	https://docs.open.alipay.com/api_1/alipay.trade.pay/
		terminal_params	Iot sdk加签字符串	Iot sdk签名函数（signWithFaceToken()）得到的字符串	必需	N/A
		scence	空	不用处理	N/A	N/A
		iot_pay_action	local_face_pay	在收单扩展字段business_params里面传入{\"iot_pay_action\":\"local_face_pay\"}，local_face_pay - 本地刷脸支付，	必需	N/A
	刷卡代扣	auth_code	空	不用处理	必需	N/A
		terminal_params	Iot sdk加签字符串	Iot sdk签名函数（signWithDelegatedByAgreement()）得到的字符串	必需	N/A
		scence	空	不用处理	N/A	N/A
		iot_pay_action	nfc_pay	在收单扩展字段business_params里面传入{\"iot_pay_action\":\”nfc_pay\"} ，nfc_pay - 刷卡支付	必需	N/A
设备状态	单双通道	pay_channel	single	single - 单通道，设备仅支持支付宝支付	必需	N/A	https://docs.alipay.com/pre-open/api_pre/alipay.commerce.iot.mdeviceprod.device.initialize
		supplier_expansion	Y	Y – 自己采购，合作方自己采购摄像	必需	N/A
	绑定ISV	type	COMMON_ISV	在principal中传入ISV PID关系	必需	必需	https://docs.alipay.com/pre-open/api_pre/alipay.commerce.iot.mdeviceprod.device.bind
		id	绑定关系id	id来源于要绑定isv的支付宝账号PID	必需	必需
	绑定商户	type	COMMON_MERCHANT	在principal中传入商户 PID关系	必需	N/A
		id	绑定关系id	id来源于要绑定商户的支付宝账号PID	必需	N/A
	绑定门店	type	COMMON_SHOP	在principal中传入门店关系	必需	N/A
		id	绑定关系id	id来源于要绑定门店的shop id，shop id在蚂蚁开放平台创建门店分配的id	必需	N/A
	绑定学校	school_stdcode	绑定关系id	在扩展字段ext_info中的传入school_stdcode及其对应id值，绑定关系id来源于学校组织机构代码证，ext_info":"{\"school_stdcode\":\"2088200135791293\"}"	必需	必需

• IOT日志上报参数要求：

分类	传参需求	Key	Value	value来源及使用说明	支付设备	门禁核身
IOT日志	刷脸mdap日志	facemode	人脸sdk工作模式	人脸SDK根据刷脸使用的场景设置的刷脸参数，业务类型：facepay支付/entrance门禁/sign考勤/采集capture	必需	必需
		ftoken	刷脸token	人脸sdk刷脸成功后返回biztid+时间戳组合的字符串	必需	必需
		cameraSN	摄像头sn	人脸sdk读取机具设备中的摄像头sn	必需	必需
		biztid	设备唯一标识	人脸sdk读取iot sdk中的唯一表示	必需	必需
		deviceSN	设备序列号sn	人脸sdk读取设备中的sn	必需	必需
		uid	刷脸核身通过的用户uid	用户uid随人脸特征加载到机具端人脸SDK	必需	必需

2.2.2开放平台产品对接：

   服务商对接第三方应用授权模式。接入流程：

第一步：签约完成后，会创建应用。

• 小程序应用：需要调用一脸通行服务及封闭场景SDK对接。
• 第三方应用授权应用：用于商户授权给isv创捷第三方应用授权链接，同时代商户调用商户代扣产品。
• 以上两个应用均为服务商登陆开放平台创建并获取应用id（即appid），上传商户私钥，保存支付宝公钥，配置应用网关地址。

第二步：下载支付宝服务端SDK。

        点击下载

第三步：开发以下产品

1. 第三方应用授权调用

服务商开发第三方应用授权，通过授权链接或者授权二维码提供给学校，学校签约商户代扣完成后，登陆签约商户代扣的支付宝账户给服务商授权。服务商获取授权app_auth_token。

• 准备： 

1).学校签约商户代扣协议生效后，用签约账户做第三方应用授权

• 第三方应用授权接入指南：

https://docs.open.alipay.com/20160728150111277227/intro

[注意]授权app_auth_token服务商本地要保存好，在做交易的时候，此参数在第三方授权调用模式下，需要通过交易接口请求给支付宝。

 

2.一脸通行平台集成

• 非远程开户（个采）：学生/教工/家长可即刻可采集孩子人脸。使用对象学生/教工/家长。

1).流程：学生/教工/家长登陆支付宝账户访问ISV小程序，跳转到支付宝刷脸认证小程序，对学生进行身份确认，通过认证机构进行刷脸认证，认证通过，用本人支付宝账户签约免密支付，或者学生没有支付宝账户，由当前账户代学生创建支付宝账户，并与当前支付宝账户进行绑定，开通免密支付。

2).准备： 联调用户数据。（学校入驻信息、用户信息）

3). 前端小程序：

 i.当前用户uid的获取：isv开发人脸小程序。用户进入小程序后通过用户授权获取uid，并保存uid。小程序授权接入

 ii.获取学生uid：isv调用支付宝的刷脸认证小程序组件，然后跳转到isv的免密支付签约小程序。前端会透传token参数，isv需要获取token参数，通过服务端接口获取到学生的uid并保存学生信息。参见页面参数传递接口

iii.isv免密支付签约小程序，签约账户为当前登录的支付宝账户，签约完成后返回的也是当前登录的uid，并保存uid。参见个采小程序开发指南，小程序方式请求(说明：支付宝认证组件不包含商户代扣协议签约，因此ISV需要自己开发。）

4）学生身份核验及与家长账号关联逻辑说明：（ISV对接时要关注此处校验流程）

•  当前用户在访问ISV小程序的时候，获取当前登录用户的uid；支付宝小程序跳转ISV小程序时，通过客户端透传的token，查询获取到学生的uid及其他信息，可以将学生和当前用户的uid关联到一起，当前用户签约完成后，签约接口返回当前用户的uid，通过这个uid可以核验学生身份。如果当前用户为学生/教工本人则获取到的uid应该一致，如果当前用户为家长则依据当前用户的uid与学生的uid绑定，可核验学生身份。
• 每个学生的外部签约号要保持唯一。

        5). 服务端接口调用：

         i.学生认证:服务商需按照团餐刷脸付接口文档中（身份认证接口）规约实现学生认证服务接口

         ii.学生信息获取：依赖支付宝小程序跳转到ISV小程序透传的token。参加页面参数传递接口。

         iii.人脸特征文件获取：通过人脸特征文件申请接口获取参见人脸特征文件申请接口文档。人脸特征码可以从特征文件中读取。

• 远程开户（集采）：孩子刷脸认证完成后，支付宝push开通刷脸支付消息，  然后，开通刷脸支付并完成签约。使用对象：ISV工作人员。

1).流程：家长收到学校短信通知孩子采脸，ISV现场工作人员登录到远程开户小程序，选择姓名、采脸，进入支付宝刷脸认证小程序，学生进行采脸。采脸完成后，支付宝push开通刷脸支付消息给家长，点击立即开通，进入到确认信息页面，确认学生身份，确认通过，进入ISV签约小程序，开通刷脸支付。对于有支付宝账户的学生，本人账号签约免密支付。对于没有支付宝账户的学生，建立支付宝账户，与家长支付宝账户建立绑定关系，并签约免密支付，即远程开户。如果信息错误，家长授权拒绝，支付宝通知ISV授权状态。

2).准备： 联调数据准备（学校入驻信息、用户信息）。

3).前端小程序：小程序互相跳转实现代码参见远程开户接入指南 

4).服务端：

• ISV小程序进入到支付宝小程序对每个学生生成一个远程开户token，用于核验学生身份。参见教育场景token生成处理器(版本1.0)文档

• 从支付宝小程序进入到ISV签约小程序的时候，依据token查询学生或教职工的信息，确认学生/教工身份。调用alipay.commerce.educate.sign.token.query接口。参见团餐刷脸付接口文档（页面参数传递接口）
• 学生认证及人脸特征文件获取：服务商需按照（身份认证接口）规约实现学生认证服务接口和人脸特征文件通过人脸特征文件申请接口获取参见接口文档。参

【注意】当学生信息有误的时候，会出现报错页面，家长远程开户拒绝授权。通过远程开户的‘家长授权拒绝’接口通知ISV。（支付宝通知ISV）参见团餐刷脸付接口文档，对应的交互流程如下‘学生信息错误上报’。见截图。

• 关闭业务服务

        开通一脸通行服务后，学生存在转学、毕业、家长换绑等其他需要解绑情况下，可以对进行一脸通行服务关闭。服务端调用K12业务关闭接口（alipay.commerce.educate.scene.kids.close）。

• 消息通知服务

        一脸通行方案中，在多个情况下，家长或者孩子账户余额或状态发生变化的时候，学校，家长都希望能够及时通知到家长，因此，可以接入消息通知接口，服务端调用场景 （如消费/核身）消息上报接口（alipay.commerce.kids.msg.scene.send）

3．小程序开发

学生刷脸认证，亲子账户绑定由支付宝提供刷脸认证小程序组件实现，用户签约由isv签约小程序。前端与isv之间通过小程序跳转。

1).小程序开发：详见小程序开发文档 。

4.封闭场景刷脸集成

 第一步：设备开机后，人脸SDK获取已经下载好的人脸特征文件或者处罚ISV服务端通过人脸特征文件申请接口获取到人脸特征文件url。

 第二步：人脸SDK会获取服务端人脸特征文件url，实现人脸特征下载到机具本地。（其中全量、增量SDK逻辑已经设计好了，实时获取人脸特征文件逻辑由ISV根据实际业务情况设计调用逻辑）

第三步：学生选餐后，选择刷脸支付，机具刷脸，并对比人脸特征。

第四步：人脸对比通过，调用支付接口——alipay.trade.pay接口

请参见封闭场景行业刷脸接入指引，

【注意】在交易完成后，需要通过人脸特征日志报告上传接口与封闭式教育场景-本地人脸比对成功同步接口，将当天的刷脸信息同步给支付宝。

刷脸算法集成目前由刷脸产品统一协调。可以联系王庭或者拂弦协调联调支持同学。

5.支付集成：（支付ISV开发）

1).代扣接口开发：详见代扣开发指南(参见商户代扣2.0集成方案）；

2).相关接口：1.第三方应用授权；

3).建议处理逻辑：

• 由于机具可能断网，所以收银APP必须要存储消费订单，然后再将消费订单及时同步到校园系统，网络正常的情况下要立即将订单发送到服务端进行扣款，禁止在存储在机具上后再批量发起。
• 扣款失败，在校园系统中为用户设立余额账户，记录用户的欠费信息，同时建立黑名单机制，根据欠费次数、欠费总金额来建立黑名单：
• 补扣次数建议不超过3次。补扣时间不在3天之内，不能超过15天。对于待支付的订单，支付宝系统内交易订单默认15天关闭，就会无法支付。
• 对于扣款次数，扣款金额，建议客户端，服务端保持一致。客户端做好限制规则。

1. 对于触发规则的用户，则放入黑名单，同时黑名单需要存储在机具端和服务器端，两边的黑名单需要保持一致
2. 对于欠费的用户，校园系统需要建立追讨机制，每天向欠费用户追讨一次，根据欠费订单进行扣款
3. 如果欠费用户的欠费订单都已经结清，则将该用户从黑名单中移除

       如果学校不采用欠费机制，则建议在用户开通刷脸服务时，向用户支付宝账户扣款20~50元存入余额账户作为服务保证金，每次刷脸后都检查用户的余额账户

4.线下刷脸支付调用商户代扣扣款接口---alipay.trade.pay

       ***接口传参说明：

• 使用isv第三方应用授权appid发起接口请求，同时传入，商户授权token，app_auth_token。
• extend_params/sys_service_provider_id参数中传入isv签约返佣协议账户的pid。
• auth_code： 扫脸成功后获取ftoken；
• subject:商品名称，格式为：商品名称 “XXX同学XXX食堂就餐+时间”eg:"张三一食堂就餐2019-10-28 12:39"
• terminal_params：机具签名（IOTSDK交易加签结果，参照样例）；
• agreement_no：协议号，通过agreement_params/agreement_no；
• product_code：产品码，传入"GENERAL_WITHHOLDING"；
• store_id：商户门店编号（如果有创建门店要求，需要必传入。以门店维度下面的机具返佣有关。)；
• total_amount： 订单金额，交易加签时涉及到金额加签，需要传入此金额。加签金额的格式、金额一定要保持一致。
• business_params; json 格式：key 为：iot_pay_action。对应value 定义如下： iot_pay_action: online_face_pay - 在线刷脸支付、local_face_pay - 本地刷脸支付、nfc_pay - 刷卡支付、bar_pay - 扫码支付

*terminal_params参数，取值为IOTSDK生成的业务签名值。IOT加签方法：https://alipay.open.taobao.com/docs/doc.htm?articleId=109629&docType=1#s1。签名样例：

1

{"terminalType":"IOT","signature":"ERKDmm3fhGCvZZP0ob5gHUiTuTaFbB5gjjYBYxdOVwezN+sSJdV+uJy4kegYC6RQDzOLx/vbLYPoZTzxPXsVAFZgCg==","apdidToken":"iBfdgYKtgBObNOOybNHkaItG2EQkY3bovzvKDqtyWKVQ9tfvZAEAAA==","hardToken":"0601469C6568AEB7BA92FCC21DF8C766CC8A78A5BF874FC509A2D262B8B5FB9E35FF","time":"1533061133","bizCode":"11000100020002200020","bizTid":"01010020015XmMUS5BmWl39qqatmTLukjswaEaSYJADU2EQ2kb3AjcY","signedKeys":"authCode,totalAmount,apdidToken,hardToken,time,bizCode,bizTid"}

        注意：由于交易报文协议为JSON格式，在构造terminal_params属性时，必须以字符串形式，因此，务必注意子json字符串的表示格式（需要转义）。

• alipay.trade.pay (统一收单交易支付接口)接口中增加IOT扩展参数，里面传入：

       *2.0 接口，从接口参数上传入该参数：business_params; json 格式：key 为：iot_pay_action

       *1.0 接口，在接口参数上传入该参数：business_info； json 格式：key 为：iot_pay_action

       * 对应value 定义如下： iot_pay_action: online_face_pay - 在线刷脸支付、local_face_pay - 本地刷脸支付、nfc_pay - 刷卡支付、bar_pay - 扫码支付

4.线上验收

线上验收包括IOT验收、小程序验收、交易验收、合作伙伴将测试验收同学的支付宝账号提供给支付宝业务同学，或者行业解决方案同学，会针对测试同学的支付宝账户推送验收任务。合作伙伴同学提交验收数据后，会进行验收审核，审核通过后，验收完成。

IOT验收(IOT解决方案接口人验收）

小程序验收（行业产品PD、质量、BD同学验收）  

交易验收（行业解决方案、技术支持小二）

目前云验收试用阶段。

备注：交易验证，会提供最新的验收checklist，注意该文档不断更新补充中，且会更新标题的版本号K12一脸通行checklist。可供合作伙伴测试用例参考。

目前基本采用云验收方式。ISV需要提供验收同学的支付宝账户给到业务同学，由业务同学统一发起验收申请。验收任务创建好之后，ISV验收同学可登陆到支付宝中搜索“云验收”小程序，看到验收任务。由支付宝产生验收反馈报告。

5.售后保障

1.上线后出现技术问题，请走售后保障流程：

1. 在线IM（保证处理时效，工作日9:00-18:00）：https://cschannel.alipay.com/newPortal.htm?scene=mt_zczx打开链接输入pid，系统识别大商户，自动分配值班技术同学支持。
2. 技术邮箱（保证处理时效，工作日9:00-18:00，解决上线后疑难杂症）：techservices@alipay.com。
3. 宕机等故障反馈值班手机：183-6885-2842 （工作日18:00-次日9:00，节假日全天）。

2. IOT售后保障流程：

邮箱：iot_campus@service.alipay.com （保证处理时效，工作日9:00-18:00，解决上线后疑难杂症）

3. 移动端维保平台：

支付宝app搜索“蚂蚁维保中心”，

6.FAQ:

刷脸支付：

扫脸FAQ：查看

一脸通行平台FAQ:

1）.Q：alipay.commerce.educate.scene.token.create(教育场景token生成处理器) 接口生成的token作用？

      A：用于远程开户时，通过isv小程序采集列表跳转到扫脸认证组件，isv调用支付宝api接口生成token。isv小程序跳转到支付宝扫脸认证小程序时传给支付宝，作为用户身份校对。

2）.Q：文档中页面查询token的接口alipay.commerce.educate.sign.token.query（token查询接口）中的token与alipay.commerce.educate.scene.token.create(教育场景token生成处理器) 接口的token是否为同一个值，作用是什么？

      A：支付宝账户注册完成跳转回isv采集列表小程序，支付宝提供token查询api接口，用于确认当前用户身份。

3）.Q：从刷脸认证组件跳转到isv小程序时，是否需要传递token？

      A： 需要，ISV服务端获取到token之后，通过页面查询token的接口alipay.commerce.educate.sign.token.query（token查询接口）获取学生信息。

4）. Q：家长拒绝通知使用场景？

      A：远程开户的‘家长拒绝’接口（支付宝通知ISV），在学生信息发生错误时调用。

5）.Q：家长拒绝授权消息可能存在积压或者消息到达先后顺序不同,即家长先点击同意授权(下发人脸特征)开通后，又点击拒绝授权开通，isv应如何判断？

      A：isv应以同意授权为准,忽略拒绝授权。

6）.Q：isv如何将家长与孩子的信息建立关联关系，相互绑定？

      A：认证接口没有直接返回家长的uid。支付宝认证完成后跳转到ISV签约页面时，ISV可以根据页面token查询接口查询到当前被操作孩子的uid、身份证号，而家长签署免密支付获得家长的uid。即通过cert_type, cert_no, user_id字段实现关联绑定。

7）.Q:小程序唤起免密签约组件调用方法？

      A：https://docs.open.alipay.com/10605 见2.2.2小程序代扣签约接口。

8).Q: 支付宝小程序应用id是多少？

     A：支付宝一脸通行小程序应用id固定：77700194

9).Q: 代扣签约小程序方法中的signStr参数获取方法。

    A：1.小程序代扣签约请求方法参考链接; https://docs.alipay.com/pre-open/20170601105911096277/cmgtz2 请仔细阅读获取方法。

         2.包含参数参考样例（仅限参数名，其他按照下面链接来做）：app_auth_token=201908BB1d4896d9c4b34670b1443562d5687A44&app_id=2019032363642252&biz_content={"third_party_type":"PARTNER","external_agreement_no":"1554130928","sign_scene":"INDUSTRY|CARRENTAL","product_code":"GENERAL_WITHHOLDING","access_params":{"channel":"ALIPAYAPP"},"external_logon_id":"5","personal_product_code":"GENERAL_WITHHOLDING_P"}&charset=utf-8&format=json&method=alipay.user.agreement.page.sign&notify_url=https://xcx.honordo.com/alipost/AliNotify&sign_type=RSA2&timestamp=2019-08-06 14:54:38&version=1.0&sign=bdt1UKxP9Zt6LnGTpRTWyo87fF4X3dFVUwdxFNCQdGEW1pbM16QLKGHhmvWeXhqz2VbyRIkP5k4FreIb3HlnWyE8lG+I+zKs9pTQHPnxHZ00yd7EDuOR4rowtycL0JK1exlA7RN8f6fp2gkARNbUrV+3K4jmSCKKlnjaj7DqFEkoijR/1hCk+0Bc0zi4baa9sPmWGxQS1mUE9Q9CQ+xY35QbDyPthCREcbxMNOuZyF0GpFaL4CAUxUv8PzQoqVdqQaWrI87YIGWSYDKtISvZhTUmD/NFITlcQmio4sxt6dpLKcwCVJINGbwCvNIoIjJeHL9hpGW0L4CCUfugFewXLA==

10).Q:小程序代扣签约请求会报6001的错误?

      A: 检查参数中是否有return_url，需要把请求数据中去掉return_url。

11).Q:之前开发过一脸通行方案1.0，现在接入一脸通行2.0的时候，需要重新采脸吗？

      A: 需要重新采脸。因为封闭场景人脸服务并未配置。1.0方案采集的人脸与2.0方案采集的人脸版本不同，不能通用。

12）Q:一个家长最多能绑定几个孩子？

     A:一个家长最多可以绑定3个孩子。

13) Q:个采时，报"开通校园一脸通行失败，请稍后再试"?

     A:检查以下各项:1.学生姓名是否跟户口本姓名一致;2.学生是否改过名或使用过曾用名;3.学籍信息是否与学生信息一致

14) Q:家长A给学生走过开通流程（如录脸、签订代扣协议），现想让另一个家长B来绑定，会报"该学生已由其他家长代为开通支付宝，请联系其他家长操作"

     A:如果家长A要求换绑成另一个家长B，需1.家长A做解绑操作，操作入口在支付宝端内：我的-设置-支付设置,2.提供家长A的UID和学生UID给到支付宝，先做业务关系删除流程。3.家长A走开通流程，重新绑定学生

15).Q:集采异常,创建token接口报错？

      A:集采时间段限制在06:00-22:00，非该时间段内集采会失败

16).Q:集采报：未找到满足条件的家长支付宝账号?

      A:确认是否家长手机号绑定了多个不同姓名的支付宝账号，需要求家长手机号绑定的支付宝账号姓名与家长姓名一致。也可考虑让家长走个采解决。

17).Q:学生账号已注销，但开通一脸通行还是提示“你的孩子已有支付宝账号，请孩子登录支付宝自行开通”？

      A:如果孩子有账户 有自己登陆的能力，可以自己登陆去开通。如果不记得账户或无法登陆，可以本人打95188要求注销。 

封闭场景SDK FAQ:

1).Q：Isvname字段中文是否可以？

    A: 需要全英文,在联调前业务同学会通过支付宝后台配置。

2).Q: institution_id字段，如何填写？

    A: institution_id来区分不同的学校，填写学校社会信用代码。与身份认证接口中的school_code参数一致。

3).Q:为什么人脸特征申请文件接口返回文件为空？

    A: 1.之前采脸时没有在教育业务后台配置封闭场景人脸服务。

        2.Isvname字段传成中文，接口正常返回，但下载的文件内容没有内容。

4).Q:人脸特征文件下载地址是否有有效期？有效期多长时间?

    A: 有时效性，文件地址的有效期为1天，所以每次请求都会生成一个新的文件。

5).Q:联调人脸特征文件申请接口时，报"ISV没有业务权限"？

    A:需要与支付宝业务同学确认支付宝后台配置信息，签约认证、小程序服务、小程序入口、刷脸支付、封闭场景人脸服务等。

6).Q：如果没有成功生成文件，支付宝服务端会重试吗？重试机制如何？

    A: 会重试，重试一段时间后 还是生成不成功，重试频率为7 次 3个小时，后面就不会在重试生成。

7).Q:在一些核身场景，isv需要知道采脸人的身份，由于人脸特征码不直接给到isv，采脸后如何对应到用户身份。

    A: 通过客户端SDK，会给isv输出ftoken，uid参数，isv可以通过uid，来关联用户身份。（前面通过一脸通行小程序完成签约的时候，isv是可以获取用户uid）

8).Q: 通过人脸特征文件申请接口获取到的下载url，isv可以自行检查是否有内容，但文件没有内容？

    A: 需要检查请求格式，人脸采集时间。如果有内容：url样例：https://mdgw.alipay.com/wsdk/file?fileid=A*RMpnSZBbPrAAAAAAAAAAAAAAAQAAAA&t=cg3tvYkUxpp9BjXCI-ZNNgAAAABkMLxdTn9f&bz=industry_biometric

截图：

9).Q:下载的人脸特征文件内容格式。

faceId|用户id|是否高危(1:高危、0:非高危)|辅助验证因子|特征码1#特征类型(2D\3D)|特征码2#特征类型(2D\3D)

 

 

FAQ

关于此文档暂时还没有FAQ