K12团餐一脸通行方案
一脸通行个采&集采FAQ
1.Q：K12一脸通行0方案人脸客户端接入时faceid参数如何获取？
A: faceid来源于与ISV服务端。在人脸特征下发后，isv在人脸特征保存的时候，生成的唯一标识，例如可以是身份证号，学号等等。
2.Q: 认证接口中请求参数中学生认证、家长代认证、教职工认证返回数据是否一致，有什么区别？
A: 学生认证、家长代认证返回的参数是一致的；教职工返回参数除监护人信息不返回，其他参数一致的.
3.Q: 身份认证数据接口中school_stdcode如何传值？
A: 此参数传学校外标，建议使用学校社会信用编码。
4.Q：身份认证数据接口auth_type的类型只有两种，为什么没有家长？
A：对isv的数据枢纽接口没有家长代开，家长代开是业务封装。isv只提供学生数据认证查询接口即可；
5.Q：身份认证接口中school_stdcode长度16位不是10位？
A：school_stdcode长度目前没有限制。
6.Q：身份认证数据接口中业务返回参数中code返回SUCCESS吗？
A：ISV查询到学生信息并根据入参check正确，返回code是SUCCESS（大写）。
7.Q：身份认证数据接口中业务返回参数guardians字段格式，包含哪些字段？
A：guardians监护人电话列表字段，是jsonList，下面包括guaradian_relation和guardian_mobile两个字段。
8.Q：身份认证数据接口ISV返回数据格式？
A：样例：
{
"sign": "TW+r1Pxe4VPpzRrnO4QKL97t1EXOnVRSNBtJ5O0bZExaKMQ1PknmIogr2M/V3YleFN/8g8lBXh4Ay7YjPR+lLD/AsrbeywHQfwLrlPqNxm3JAsYla2Q57d85L6pJx0Y8vLFKzLVZY/n1ioQ45pYNGQ89gA9+LVDmOMcIZBpTas3+4r9hquvkBVkqSEbTGadaPbNWdO4ib5DLvXEEVo88/bEVijt48h5wH56zWKVIndXAkJGgfcBANDmEEBV4s2pkcGyMor3a1J7NDamOfE2Q0FL2uEhgiIk8NznhcEhHAzh44ARw5j4vbaw7tZxWSW1s+JA0D7GCi2XRPYwOIpjj8w==",
"response": {
"msg": "SUCCESS",
"biz_content": {
"phase": "1",
"cert_type": "1",
"cert_no": "330329199xxxxx",
"image_url": "https://pics1.baidu.com/xxxx6c9177f3e67093096df9df59ad838f9dc55a5.png?token=1c7316cf887a50bb47cb0433bb96eb41&s=28D25A874142315D4A783CAA0300E000",
"image_date": "2019-08-13 17:10:00",
"guardians": [
{
"guaradian_relation": "51",
"guardian_mobile": "13588xxxxx"
}
],
"enroll_no": "610824197812044680",
"phase_len": "6",
"school_stdcode": "91330106MA27WC0T1Y",
"name": "任xx",
"enroll_status": "01",
"enroll_date": "2018",
"grade_name": "2018级"
},
"code": "SUCCESS"
}
}
9.Q：支付宝对认证网关返回参数支付宝验签说明
A：支付宝将response中的参数为验签参数串，参数顺序与请求时的参数顺序一致，不需要对参数进行排序。，json字符串格式，使用map 构造的方法即可。例如：上面标题中返回数据的支付宝验签参数串如下：切记不需要排序。
{ "msg": "SUCCESS", "biz_content":{ "phase": "1", "cert_type": "1", "cert_no": "330329199xxxxx", "image_url": "https://pics1.baidu.com/feed/a686c9177f3e67093096df9df59ad838f9dc55a5.png?token=1c7316cf887a50bb47cb0433bb96eb41&s=28D25A874142315D4A783CAA0300E000", "image_date": "2019-08-13 17:10:00", "guardians":[{ "guaradian_relation": "51", "guardian_mobile": "13588xxxxx"}], "enroll_no": "610824197812044680", "phase_len": "6", "school_stdcode": "91330106MA27WC0T1Y", "name": "任xx", "enroll_status": "01", "enroll_date": "2018", "grade_name": "2018级"}, "code": "SUCCESS"}
10.Q：认证网关验签失败排查方法？
A：(1).确定商户签名类型与验签类型（应用上的默认签名类型）是否一致；
(2).确认商户的字符集是否与unifygw配置的一致；
(3).商户签名密钥与验签公钥是否为匹配一对；
(4).商户加签方式是否符合标准；
(5).验签工具自助排查：SDK 验签工具，验签isv要使用rsaCheckV1方法，params中sign和signtype都要加上，rsaCheckV1可以自动过滤掉signtype。验签时不带上signtype的。
11.Q：用户的一个身份证号注册多个支付宝账户（可以注册5个支付宝），已经签约了其中一个支付宝账户与孩子账户绑定，本人其他的支付宝账户是否可以签约？
A：可以签约。因为个采是在小程序中，用户必须先登录支付宝账户，用户使用不同的支付宝账户登录，需要重新认证，签约，会给ISV发送认证通知；认证通过后，采脸、签约是与当前登录的支付宝账户绑定的。ISV把签约关系保存下来，在扣款的时候，ISV需要做判断逻辑，可以优先使用新绑定的协议号扣款，或者是其他协议号，由ISV自行设计逻辑规则。
12.Q：认证的时候，小程序前端报“学生信息不匹配”？
A：是因为认证接口在支付宝网关验签失败。建议ISV按照网关返回样例，进行传参。加签时注意不要排序，参数数据按照json格式，去掉sign即可。
13.Q：对于没有开通过k12账号的学生，一个家长支付宝账号可以开通不同的学生，但是如果学生之前有开通过的话，传入的手机号只能是之前开通的时候对应的家长的手机号？
A：是的 ，支付宝后台是判断家长与学生两个UID的关系，如果家长支付宝绑定手机号变过了，就需要传入换绑之后的 手机号
14.Q：集采的时候，报“未找到满足条件的家长支付宝账户”是什么原因？
A：因为家长的手机号码绑定了多个姓名一致的支付宝账户。这种情况建议ISV引导用户使用只绑定正在使用的支付宝账户，其他非本人支付宝账户绑定该手机号，需要把该手机号解绑，或者引导家长用使用个采小程序。
15.Q：目前已经接入k12一脸通行1.0方案与k12一脸通行2.0方案采集的人脸库是否可以共用？
A：已经接入k12一脸通行1.0方案与2.0方案并且已经采集人脸库的，已采集的人脸库是不能共用的，但是，可以通过接口将1.0迁移到2.0人脸特征。
16.Q：认证完成后，大概多久可以再次认证？
A：认证完成后，有5分钟的缓存配置，5分钟之后，可以重新认证。重新认证可以出发认证通知。
17.Q：孩子已开通支付宝账户，请孩子登录支付宝自行开通”报错提示，该怎么处理？
A：如果孩子有账户 有自己登陆的能力，可以自己登陆去开通。如果不记得账户，那就本人打95188要求注销。
18.Q：集采时，alipay.commerce.educate.scene.token.create接口的调用是否有限制。
A：有限制，alipay.commerce.educate.scene.token.create 这个接口有调用时间限制，每天6点到22点。
19.Q: 消费场景下为孩子开通后，如何去解绑信息，让另外的账户为这个孩子开通呢？
A: 目前方案，需要让孩子本人打电话给95188 说明是中小学场景里由家长代为开通账户的需要注销。后续会通过系统升级关闭服务。Q：在一脸通行方案中ISV如何获取到用户的uid？
20.A：第一步是通过前端支付宝小程序跳转到ISV小程序的时候，透传token参数，ISV获取token参数。第二步通过alipay.commerce.educate.sign.token.query接口传入token，获取用户uid，此uid为学生的uid。以便在签约的时候，记录签约的学生。
21.Q：alipay.commerce.educate.scene.token.create(教育场景token生成处理器) 接口生成的token作用？
A：用于远程开户时，通过isv小程序采集列表跳转到扫脸认证组件，isv调用支付宝api接口生成token。isv小程序跳转到支付宝扫脸认证小程序时传给支付宝，作为用户身份校对。
22.Q：文档中页面查询token的接口alipay.commerce.educate.sign.token.query（token查询接口）中的token与alipay.commerce.educate.scene.token.create(教育场景token生成处理器) 接口的token是否为同一个值，作用是什么？
A：支付宝账户注册完成跳转回isv采集列表小程序，支付宝提供token查询api接口，用于确认当前用户身份。
23.Q：从刷脸认证组件跳转到isv小程序时，是否需要传递token？
A： 需要，ISV服务端获取到token之后，通过页面查询token的接口alipay.commerce.educate.sign.token.query（token查询接口）获取学生信息。
24.Q：家长拒绝通知使用场景？
A：远程开户的‘家长拒绝’接口（支付宝通知ISV），在学生信息发生错误时调用。
25.Q：家长拒绝授权消息可能存在积压或者消息到达先后顺序不同,即家长先点击同意授权(下发人脸特征)开通后，又点击拒绝授权开通，isv应如何判断？
A：isv应以同意授权为准,忽略拒绝授权。
26.Q：isv如何将家长与孩子的信息建立关联关系，相互绑定？
A：认证接口没有直接返回家长的uid。支付宝认证完成后跳转到ISV签约页面时，ISV可以根据页面token查询接口查询到当前被操作孩子的uid、身份证号，而家长签署免密支付获得家长的uid。即通过cert_type, cert_no, user_id字段实现关联绑定。
27.Q:之前开发过一脸通行方案1.0，现在接入一脸通行2.0的时候，需要重新采脸吗？
A: 需要重新采脸。因为封闭场景人脸服务并未配置。1.0方案采集的人脸与2.0方案采集的人脸版本不同，不能通用。
28.Q:一个家长最多能绑定几个孩子？
A:一个家长最多可以绑定3个孩子。
29.Q:个采时，报"开通校园一脸通行失败，请稍后再试"?
A:一般是过公安网失败，需要在检查以下各项:1）.学生姓名是否跟户口本姓名一致;2）.学生是否改过名或使用过曾用名;3）.学籍信息是否与学生信息一致
30.Q:家长A给学生走过开通流程（如录脸、签订代扣协议），现想让另一个家长B来绑定，会报"该学生已由其他家长代为开通支付宝，请联系其他家长操作"
A:如果家长A要求换绑成另一个家长B，需1.家长A做解绑操作，操作入口在支付宝端内：我的-设置-支付设置,2.提供家长A的UID和学生UID给到支付宝，先做业务关系删除流程。3.家长A走开通流程，重新绑定学生
31.Q:集采报：未找到满足条件的家长支付宝账号?
A:确认是否家长手机号绑定了多个不同姓名的支付宝账号，需要求家长手机号绑定的支付宝账号姓名与家长姓名一致。也可考虑让家长走个采解决。
32.Q:学生账号已注销，但开通一脸通行还是提示“你的孩子已有支付宝账号，请孩子登录支付宝自行开通”？
A:如果孩子有账户 有自己登陆的能力，可以自己登陆去开通。如果不记得账户或无法登陆，可以本人打95188要求注销。
33.Q: 集采失败报错
A:检查
1.可能为传入身份证格式校验有误
2.学籍信息是否正确
3.集采时间段限制在06:00-22:00，非该时间段内集采会失败
4.家长手机号是否已注册支付宝或与支付宝账户信息一致（如姓名、手机号），可至支付宝：我的->设置->安全设置->手机号查看。
34.Q: 代扣报xxxx信用社扣款，报未知异常或支付失败
A:可能xxxx信用社异常，服务不可用。如果出现被扣款，一般会在1个工作日内自动冲正并退款。
35.Q: 学校签约报错，影响所有学校师生开通失败
A:请联系对应的BD处理
36.Q: 线上报错出现类似：错误量报警 [ alipay.commerce.educate.scene.token.create, SYSTEM_ERROR]
A:查明是哪所学校报错，并找对应的BD确认配置是否正确
37.Q: 学生账号已注销，但开通一脸通行还是提示『你的孩子已有支付宝账号，请孩子登录支付宝自行开通』
A:请学生本人致电95188，咨询已经存在的账户。如果确认支付宝账户信息不是本人注册填写，可以向客服申请注销账户。
38.Q: 开通失败，报『无效签名』
A:确认验签、加签是否异常
39.Q： 集采的支付宝push家长消息的过期时间是多久？
A：7天过期
40.Q：个采小程序从支付宝小程序跳转到ISV小程序的透传的token有效期多久？
A： token有效期是5分钟，如果过期需要重新获取一个吧。
小程序签约FAQ
41.Q:小程序唤起免密签约组件调用方法？
A：https://docs.open.alipay.com/10605 见2.2.2小程序代扣签约接口。
42.Q: 支付宝小程序应用id是多少？
A：支付宝一脸通行小程序应用id固定：77700194
43.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¬ify_url=https://xcx.honordo.com/alipost/AliNotify&sign_type=RSA2×tamp=2019-08-06 14:54:38&version=1.0&sign=bdt1UKxP9Zt6LnGTpRTWyo87fF4X3dFVUwdxFNCQdGEW1pbM16QLKGHhmvWeXhqz2VbyRIkP5k4FreIb3HlnWyE8lG+I+zKs9pTQHPnxHZ00yd7EDuOR4rowtycL0JK1exlA7RN8f6fp2gkARNbUrV+3K4jmSCKKlnjaj7DqFEkoijR/1hCk+0Bc0zi4baa9sPmWGxQS1mUE9Q9CQ+xY35QbDyPthCREcbxMNOuZyF0GpFaL4CAUxUv8PzQoqVdqQaWrI87YIGWSYDKtISvZhTUmD/NFITlcQmio4sxt6dpLKcwCVJINGbwCvNIoIjJeHL9hpGW0L4CCUfugFewXLA==
44.Q:小程序代扣签约请求会报6001的错误?
A: 检查参数中是否有return_url，需要把请求数据中去掉return_url。
45.Q：代扣接口报[ACQ.TRADE_HAS_CLOSE]支付失败，本笔交易已关闭。[TRADE_HAS_CLOSE]？
A：交易超过可支付时间，一般默认15天内可支付，不指定超时时间即是默认时间。交易关闭不能继续支付，需要重新生成代扣订单。
46.Q:[ACQ.BUYER_BANKCARD_BALANCE_NOT_ENOUGH]支付失败，顾客银行卡余额不足，建议顾客使用其他方式付款。
A：需要用户支付宝账户充值，获取其他方式支付。
47.Q： [ACQ.NO_PAYMENT_INSTRUMENTS_AVAILABLE]支付失败，没用可用的支付工具，建议添加付款方式。[NO_PAYMENT_INSTRUMENTS_AVAILABLE]
A：添加支付工具，绑定银行卡或者余额充值等
48.Q：[ACQ.BEYOND_PAY_RESTRICTION]支付失败，商户收款额度超限，建议联系支付宝小二提高限额。
A: 用户支付宝账户年度消费额度超限。
49.Q: [ACQ.AGREEMENT_NOT_EXIST]支付失败，用户协议不存在，建议确认代扣业务传入的协议号对应的协议是否已解约。
A: 与用户确认签约是否已解约，或者调用协议查询接口查询用户的签约签约情况。
50.Q: 代扣失败排查
A:找售后保障
1.上线后出现技术问题，请走售后保障流程：
在线IM（保证处理时效，工作日9:00-18:00）：https://cschannel.alipay.com/newPortal.htm?scene=mt_zczx打开链接输入pid，系统识别大商户，自动分配值班技术同学支持。
技术邮箱（保证处理时效，工作日9:00-18:00，解决上线后疑难杂症）：techservices@alipay.com。
宕机等故障反馈值班手机：183-6885-2842 （工作日18:00-次日9:00，节假日全天）。
- IOT售后保障流程：
邮箱：iot_campus@service.alipay.com （保证处理时效，工作日9:00-18:00，解决上线后疑难杂症）
- 移动端维保平台：
支付宝app搜索“蚂蚁维保中心”，
封闭场景人脸FAQ
51.Q：封闭场景人脸客户端接入需ISV实现理解并实现请求逻辑阐述？
A：（1）.需ISV实现请求逻辑接口（onHttpConnection）
（2）.全量、增量、实时都会回调，代码逻辑一致，不需要判断类型。
（3）.onHttpConnection方法的作用；实现请求到ISV的server端获取三个字段(filestatue/filedate/downloadUrl)，SDK根据字段会进行下载更新
（4）.实现函数代码：
@Override
public void onHttpConnection(final HashMap<String, Object> paramsMap, final FaceFeatureApi.HttpResponseCallBack responseCallBack) {
//TODO ISV需要实现
// 实现http请求获取人脸库，把得到结果的三个字段(filestatue/filedate/downloadUrl)通过responseCallBack回传sdk
responseCallBack.onHttpResponse(paramsMap,filestatue,filedate,downloadUrl);
}
52.Q：人脸客户端实时（loadRealtimeFaceFeature）接口讲解？
A：loadRealtimeFaceFeature接口的两个作用。a.加载实时人脸数据b.将当天0点到请求时间新增的人脸数据下载并更新至本地并加载。
53.Q：本地没有人脸数据错误日志：[FaceFeatureApi]:errorType:INDUSTRY,code:-1000,msg:Waiting face feature to load
A: 此种情况是在isv收银app调用zolozVerify接口进行扫脸识别的时候，机具本地并未有任何的人脸数据情况下产生的。
常出现的情况有:a.未调用loadAllFaceFeature接口。b.未在loadAllFaceFeature接口的FaceFeatureApi.FaceVerifyCallBack的onSuccess成功回调中去调用zolozVerify
54.Q：本地未有人脸数据错误日志分析规则
A: 错误日志打印有很多情况，通过其中的参数进行分析区分type：错误类型，行业（INDUSTRY）、人脸（ZOLOZ）,code：错误码,msg：错误信息
错误日志样例：（ 本地未有人脸数据错误日志）
[FaceFeatureApi]:errorType:INDUSTRY,code:-1000,msg:Waiting face feature to load
55.Q：封闭场景刷脸日志分类？
A: 封闭场景刷脸日志分两种： 行业（INDUSTRY）、人脸（ZOLOZ）
56.Q：人脸比对识别日志通过IOT SDK回传，是不是成功或者失败都会回传uid？
A：1.0方案中的1.0版本（原子化能力）：人脸sdk1.2.6的最新版本和1.2.8版本中，成功和失败都会回传iot 日志，只有成功时才包含uid。2.0方案中的smile apk：只有成功时回传iot日志，成功时包含uid。失败不包含uid。
57.Q：封闭场景人脸demo中的参数赋值说明
A：bizCode目前固定传SCHOOL_PAYMENT（校园消费），deviceNum 是设备sn号。Merchant_id 学校社会信用代码
58.Q：人脸客户端的错误代码有哪些。
A：人脸客户端错误代码可以参考demo，目前都写到sdk代码注释说明中，客户端错误码，如截图：
59.Q：封闭式教育场景-本地人脸比对成功同步接口部分参数说明
A：1） biz_id 业务流水唯一ID，由调用方生成,保证业务线唯一性，ISV自定义。
2） organize_id 学校机构编码传 school_stdcode学校社会信用代码证编号。
60.Q：人脸特征日志报告上传接口中一些参数来源说明
A：1).scene_code 场景码参数填写示例值。 2) device_num 商户机具编码填写设备sn号。3) z_face_info 商户透传人脸客户端信息。这个是转投参数,日志埋点。z_face_info应该是转投客户端的logBlob。4) inst_id 机构ID传与school_stdcode参数相同的学校的社会信用代码证编号。
61.Q：封闭场景的日志上报接口（alipay.commerce.educate.localface.compare.sync），必传参数有哪些?
A：必传参数有isv_name、aes_cypher、biz_code、alg_ver、auth_img、organize_id、fuid、biz_id
62.Q：人脸特征文件申请接口，返回文件链接为空？
A：先提供请求数据，然后提供学校编码，与业务确认是否配置封闭场景人脸服务。一般没有配置会获取文件的时候，dawnloadUrl为空。联系业务进行配置，配置完成后，需要重新采脸，采脸后10分钟之后再获取人脸特征文件。
63.Q：Isvname字段中文是否可以？
A: 需要全英文,在联调前业务同学会通过支付宝后台配置。
64.Q: institution_id字段，如何填写？
A: institution_id来区分不同的学校，填写学校社会信用代码。与身份认证接口中的school_code参数一致。
65.Q:为什么人脸特征申请文件接口返回文件为空？
A: 1.之前采脸时没有在教育业务后台配置封闭场景人脸服务。
2.Isvname字段传成中文，接口正常返回，但下载的文件内容没有内容。
66.Q:人脸特征文件下载地址是否有有效期？有效期多长时间?
A: 有时效性，文件地址的有效期为1天，所以每次请求都会生成一个新的文件。
67.Q:联调人脸特征文件申请接口时，报"ISV没有业务权限"？
A:需要与支付宝业务同学确认支付宝后台配置信息，签约认证、小程序服务、小程序入口、刷脸支付、封闭场景人脸服务等。
68.Q：如果没有成功生成文件，支付宝服务端会重试吗？重试机制如何？
A: 会重试，重试一段时间后 还是生成不成功，重试频率为7 次 3个小时，后面就不会在重试生成。
69.Q:在一些核身场景，isv需要知道采脸人的身份，由于人脸特征码不直接给到isv，采脸后如何对应到用户身份。
A: 通过客户端SDK，会给isv输出ftoken，uid参数，isv可以通过uid，来关联用户身份。（前面通过一脸通行小程序完成签约的时候，isv是可以获取用户uid）
70.Q: 通过人脸特征文件申请接口获取到的下载url，isv可以自行检查是否有内容，但文件没有内容？
A: 需要检查请求格式，人脸采集时间。如果有内容：url样例：https://mdgw.alipay.com/wsdk/file?fileid=A*RMpnSZBbPrAAAAAAAAAAAAAAAQAAAA&t=cg3tvYkUxpp9BjXCI-ZNNgAAAABkMLxdTn9f&bz=industry_biometric
截图：
71.Q:下载的人脸特征文件内容格式。
faceId|用户id|是否高危(1:高危、0:非高危)|辅助验证因子|特征码1#特征类型(2D\3D)|特征码2#特征类型(2D\3D)
72.Q: 学生刷脸出现识别不了的情况
A:请提供识别日志，找行业技术支持确认。
73.Q：人脸特征文件申请接口中的，版本号怎么传？
A: 按照接口中文档中“jasmine_v1.2- 9903ebccf5- 9903ebccf5 ”。