我的书签
添加书签
移除书签出行-公交刷码乘车
用户开通公交刷码服务后，在支持该服务的城市的公交车上，可以直接刷二维码进行付款乘坐公交。对于开通电子公交卡的城市，可以通过该服务向用户下发电子公交卡。领取电子公交卡一般需要绑定手机、开通服务等流程。
DEMO体验：
注意：如果在扫描后显示“服务不可用”的提示信息，请点击“切换状态”按钮来刷新乘车码。
交互Demo代码包下载
资金方案
轮询代扣+补缴欠款模式（本文介绍）
代扣不成功时，服务不可用，服务端每隔一段时间轮询发起代扣，直到代扣成功，用户使用时可以自行补缴欠款后继续使用。 如果用户服务不可用，想马上使用，可立即缴清欠款后继续使用。
押金+代扣+补缴欠款模式
押金不支付乘车费，代扣失败则产生欠款，欠款付清后可继续生码乘车。交押金和签约代扣可同一接口完成。
溢缴款充值模式+自动充值
如：充值20元以上才可开通可乘车，乘车扣余额，余额少于20元后不可乘车，可签约代扣并开通自动充值。
芝麻分免押+代扣+缴欠款模式
以芝麻分信用免押代替押金，对用户首次开卡使用体验好。
业务流程
以下流程仅供参考，实际项目可按实际情况调整。
流程简述
新用户流程：注册 -> 开通服务 -> 开通代扣 -> 乘车刷码
正常乘车流程：打开小程序 -> 刷码乘车 -> 延时代扣 -> 代扣成功 -> 或代扣失败则产生欠款 -> 暂停服务 -> 缴清欠款 -> 恢复服务 -> 刷码乘车
退卡流程：打开小程序 -> 主菜单 -> 申请退卡 -> 3天后无欠款直接解约代扣 -> 有欠款提醒缴清后解约
注册
用户打开小程序后，小程序可授权识别到支付宝的用户 id，检查用户状态，未注册会跳转注册页面。
注册可以用传统手机号码+验证码的方式注册，在后台创建手机号+支付宝UID+商户唯一ID（可以是卡号）的关联关系，后续每次打开小程序会根据手机缓存情况和返回的用户信息情况跳转对应页面。
开通服务
- 开通服务主要是用户在小程序中做签约支付宝代扣，签约代扣后，用户乘车会通过代扣支付。
- 由于刷码乘车都是机具离线验码后结算模式，因此以缴纳押金的方式保障用户乘车后付款。
- 支付宝提供有签约代扣接口以供用户完成代扣签约流程，签约后乘车时使用签约号发起代扣。
- 开通服务后，给用户发放一张虚拟公交卡，用户即可生码乘车。
放入卡包
开通服务后，将虚拟公交卡放入支付宝卡包，方便用户快捷使用。用户打开卡包后可以看到新添加的虚拟公交卡。
点击下方的菜单，即可进入小程序刷码乘车。
账号信息
用户可以在“账户”页签查看账户信息，如下图所示：
生码展示
生码方式小程序段可在线生码也可以离线生码，当然首推离线生码，方便地铁中无信号时还可以无障碍乘车。
在线生码小程序自动和定时请求服务端，服务端根据用户信息及状态情况判断生码条件并根据秘钥生成二维码内容，然后再内容回给小程序端生码展示。
离线生码
- 生码需要的用户密钥和机具终端密钥都缓存在小程序的安全存储区内，小程序实现生码的签名和加密算法。
- 小程序只需要首次打开或每天第一次请求用户信息和密钥信息后，就可以后面每次无需请求网络并生码和自动刷新。
- 当用户存在欠费时，不给用户返回密钥信息。
刷码乘车
刷码乘车用户开通服务成功后，在手机上将生成一个二维码，在支持的公交线路上，用户只要在上车时打开手机将二维码靠近公交或地铁闸机的摄像头，码识别验证成功后会提示用户验码成功。 完成乘车验票流程，极大提升了用户的乘车体验。
代扣成功扫码成功后，机具会每分钟异步队列上传给服务端，服务端验证二维码的合法性并对该用户发起支付宝扣款，代扣成功后，该笔交易完成，此笔交易在手机小程序中可查。
代扣失败当用户余额不足时，代扣失败，则记录下欠款金额，以一定的规则触发更新用户的可刷码状态，当用户在小程序中缴清欠款后，方可再次生码。
欠款处理
欠款计算当用户账户余额和绑定的银行卡不足时，代扣会失败，服务端记录下交易的欠款记录，在每天日切结算时，算出用户的欠款金额。
欠款缴清用户打开小程序发现有欠款，则不能生码乘车，引导用户去缴清欠款。用户缴清欠款后，可重新获取新的秘钥在小程序中生码乘车。
退卡流程
申请用户不想使用时，可以发起退卡申请，一般在3日内处理（由于公交机具可能出现故障没有及时将刷码信息上传，或用户代扣失败，欠款金额是每日结算时才算出来等原有，为避免资金损失而设定3日处理）。
等待出账定时任务查出超过3日的退卡申请，根据计算出的欠款情况决定是否直接退卡。
退卡如果用户没有欠款，则直接退卡退押，并解约代扣；如果用户有欠款，则短信提醒用户缴清欠款后退卡解约。
辅助流程
开通线路
引导用户在已开通的线路上使用乘车码乘车。
乘车记录
乘车记录展示用户的刷码乘车使用情况，展示所乘车次和支付情况。
帮助信息
帮助用户了解乘车码如何使用，如何付款，存在纠纷时如何联系客服等。
