一卡通代扣产品背景

目前校园场景中实体卡覆盖场景广（就餐、门禁、打水、洗澡、线下缴费、打卡、其他消费等），体验上也很快捷。结合校园信息化建设的需求，针对传统实体卡向智慧校园过渡阶段，推出“实体卡代扣解决方案”，在不改变学校和商户财务资金流程和硬件设备更换的基础上，最大限度的实现实体卡消费的体验优化和移动化管理服务。

产品介绍（业务流程、成功案例）

业务流程

1、用户登录支付宝小程序，搜索学校名称，填写姓名，身份信息，学号，一卡通卡号等信息，支付宝通过认证机构认证通过后，绑卡并签约一卡通代扣。

2、发起扣款时，支付宝会判断学生支付宝账户余额，如果余额充足，则扣学生账户款。如果余额不足，重试后仍扣款失败，根据垫付标识，会代扣垫资账户的款。扣款成功实时到账。

3、委托提现到学校指定银行卡账户。

成功案例

名词解释

角色介绍

工作分工及流程

方案集成支持流程

业务接入流程

工作分工

工作流程

• 学校提供商户信息给服务商，并对接服务商系统。
• 服务商对接学校系统，开发支付宝一卡通认证绑定产品，商户代扣产品、先享后付产品等。
• 联调测试环境确定及准备测试数据。一卡通认证绑定，商户代扣、先享后付均使用生产环境联调。先签约后联调。一卡通认证绑定联调数据准备。
• 联调完成后，支付宝端预发或者线上环境验收。验收通过后，服务商试点使用。

服务商接入流程

服务商对接一卡通代扣第三方应用授权模式，接入流程：

开放平台产品对接

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

服务商登陆开放平台获取应用id（即appid）上传商户私钥，保存支付宝公钥，配置应用网关地址。如果使用同一签约账号下已有appid对接，需要联系支付宝业务同学挂接口包。

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

服务端SDK

第三步：开发以下产品

1. 第三方应用授权调用

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

• 准备：
• 学校支付宝账户签约商户代扣产品、垫资保付产品，由支付宝BD同学签约。
• 服务商应用授权appid由支付宝BD同学挂接口包。
• 学校签约协议生效后，用签约账户做第三方应用授权
• 第三方应用授权接入指南：https://docs.open.alipay.com/20160728150111277227/intro

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

2、开发一卡通认证绑定

学生/教工登陆支付宝账户，通过支付宝小程序选择学校、输入姓名、身份证、学号、一卡通卡号等信息，支付宝通过认证接口提交给认证机构，认证通过签约免密支付。

• 准备： 联调数据准备。
• 报文通信格式规范：服务商按照《支付宝通信协议规范》约定进行请求报文解析、请求报文验签、响应报文签名、响应报文组装等开发工作。通信协议规范.pdf
• 一卡通认证接口规约：服务商需按照《一卡通认证绑定文档》规约实现一卡通认证服务接口和接收绑卡代扣结果通知。一卡通认证绑定文档.pdf
• 学生/教工认证数据变更：服务商需按照《一卡通认证绑定文档》规约通过信息同步接口把信息同步给支付宝。一卡通认证绑定文档.pdf  
• 时序图：

3、商户代扣

• 商户代扣签约方式有两种，在实际对接中二选一即可。

     1).第一种方式：通过支付宝认证签约小程序支付宝小程序提供签约能力。isv接收签约通知。小程序认证签约组件调用

     2).第二种方式：isv通过支付宝小程序调用商户代扣协议签约接口。完成用户签约。商户代扣接入指南及开发文档

• 支付调用alipay.trade.pay交易接口。
• 如果扣款失败，建议重试扣款，根据实际业务，网络状况等因素综合考虑，发起重试频率，如果重试仍然失败，当天晚上10点再统一发起垫资。
• 用户端通过支付宝app发起解约申请，支付宝通知服务商解约，服务商本地查询该用户是否有欠款等情况，根据实际情况调用解约接口，此时会用户会解约完成。

时序图：

4、先享后付产品

• 准备：服务商根据实际情况决定垫资账户，由bd在签约协议属性中配置。

• 通过接口传入垫资参数新增：advance_payment_type，用以指定本次扣款是否需要垫资，需要则传入：ENJOY_PAY_V2。当满足垫付条件，则通过垫资账户扣款。
• 还款：用户主动还款和追缴。用户主动还款时，登录钱包看到未付款订单，还款后，支付宝通知服务商。支付宝push追缴信息，还款。服务商本地维护垫资记录。还款截图如下：

• 服务商业务是异步扣款的模式，对于异步扣款，面临着先服务后扣费的情况，因此会涉及到扣款不到的情况，针对特定行业的商户，商户是不承担资损的，因此服务商为主体进行垫资兜底能力。发起商户代扣业务前，需要把交易记录下来，在一定的时间内发起代扣请求。
• 服务商需要发起商户代扣业务前，需要把交易记录下来，根据实际情况在一定的时间内发起代扣请求。
• 垫付产品接入指南及开发文档：https://alipay.open.taobao.com/docs/doc.htm?articleId=109677&docType=1

硬件对接

 IOT对接，isv或者支付宝业务同学，发邮件iot_campus@service.alipay.com 申请对接需求。iot解决方案同学收到后承接IOT对接。IOT接入流程，参见《高校团餐非人脸设备接入IOT细分SOP（云端、sdk）.docx》

技术对接

商户代扣扣款接口——alipay.trade.pay (统一收单交易支付接口)，传参的基础上增加如下传参：

1.第三方应用授权调用模式交易传参

alipay.trade.pay (统一收单交易支付接口)接口中传参，app_auth_token:第三方应用授权token（授权模式必传）。

2.垫资交易接口传参

alipay.trade.pay (统一收单交易支付接口)接口中传参， 

a.入参新增：advance_payment_type，用以指定本次扣款是否需要垫资，需要则传入：ENJOY_PAY_V2

b.响应结果和异步通知，新增参数：advance_amount， 该值代表本次交易，垫资主体出资金额。

具体参见附件《商户代扣&先享后付v2集成文档.docx》

3.IOT平台接入交易接口参数

IOT平台接入需要先通过设备评估确认IOT接入方案。云端管控API接口和IOTSDK接入两种方案。根据不同方案，交易接口传参要求不同。

具体参见附件《高校团餐非人脸设备接入IOT细分SOP（云端、sdk）.docx》

4.其他传参说明。

教育一卡通传参要求，请按照下表约定传参。

上线验收

上线前需要服务商与支付宝相关负责人确认以下验收通过：

1、功能验收【@产品提供】

2、一卡通认证绑定验收【@行业测试】

  一卡通认证绑定验收

3、交易验收【@行业解决方案】

  一卡通代扣验收checklist.xlsx

—归档@续玉、声笑

售后保障

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，解决上线后疑难杂症）

附录：

1. 加验签工具：https://docs.open.alipay.com/291/106097
2. 方案角色相关同学：

FAQ