k12一脸通行方案——商户代扣接入指引

更新时间：2020/06/02 访问次数：1874

1.商户代扣集成
FAQ

1.商户代扣集成

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

3).线下刷脸支付调用商户代扣扣款接口---alipay.trade.pay传参说明：

分类	传参需求	Key	Value	value来源及使用说明	支付设备	门禁核身	接口连接
支付收单交易	通用需求	extend_params/sys_service_provider_id	传入isv签约返佣协议账户的pid		必需	N/A	统一收单交易接口—(alipay.trade.pay)
		subject	商品名	格式为：商品名称 “人物（名字脱敏处理）同学XXX食堂+早/午/晚餐+时间”eg:"张XX同学一食堂午餐2019-10-28 12:39"	必需	N/A
		agreement_params/agreement_no	协议号	通过agreement_params/agreement_no	必需	N/A
		product_code	GENERAL_WITHHOLDING	产品码，传入"GENERAL_WITHHOLDING"	必需	N/A
		alipay_store_id	支付宝门店编号，团餐场景必传	如果校园团餐场景必传。有创建门店要求，需要必传入。以门店维度下面的机具返佣有关。	必需	N/A
		advance_payment_type	支付模式类型	支付模式类型,若值为ENJOY_PAY_V2表示当前交易允许走先享后付2.0垫资。是否垫资，由ISV或者商户根据实际情况选用。若垫资则固定传参“ENJOY_PAY_V2 ”(K12场景无需接入）	必需	N/A
		terminal_id	商户机具终端编号	建议使用设备sn号，也可自定义。样例：“NJ_T_001”	必需	N/A
	刷脸代扣	auth_code	facetoken字符串	人脸SDK生成的facetoken字符串	必需	N/A
		terminal_params	Iot sdk加签字符串	Iot sdk签名函数（signWithFaceToken()）得到的字符串	必需	N/A
		scence	空	不用处理	N/A	N/A
		business_params/iot_pay_action	local_face_pay	json 格式，在收单扩展字段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
		business_params/iot_pay_action	nfc_pay	json 格式，在收单扩展字段business_params里面传入{\"iot_pay_action\":\”nfc_pay\"} ，nfc_pay - 刷卡支付	必需	N/A

注意：

1）.使用isv第三方应用授权appid发起接口请求，同时传入，商户授权token即app_auth_token。

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

{"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字符串的表示格式（需要转义）。

4).建议处理逻辑：

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

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

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

FAQ

商户代扣2.0常见问题: https://docs.alipay.com/pre-open/20170601105911096277/mzvgk0

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

开放平台

K12一脸通行方案

k12一脸通行方案——商户代扣接入指引

1.商户代扣集成

FAQ

FAQ