支付宝地铁购票服务,提供了地铁单程票线上购买,线下取票的服务。为地铁行业解决了现场购票效率低下、现金找零麻烦的难题。
用户取票流程如下:
地铁商家只需要通过BD完成签约,提供线路、站点、票价等信息,支付宝与机具提供商完成核销对接后,服务即可上线。
在已与支付宝完成购票服务对接的城市,通过使用支付宝提供的开放接口,地铁商家或者经过地铁授权的地铁购票服务商,可以在自己的APP,或者自行开发的H5应用中为用户提供在线购票服务。
1. 购票、取票分离
地铁购票服务,可分为购票、取票两个环节。购票环节提供在线购票的服务,取票环节,用户持购票后获取的二维码,在取票机上刷码核销,完成取票(本文档提供的是购票环节所需接口)。
2. 中间账户模式
为解决用户购票但未取票这部分资金管理所带来的退款、对账混乱的问题,支付宝提供了一套中间账户资金流转的模式。在线购票时,资金先支付至支付宝指定中间账户中,线下取票后,资金会自动结算给地铁商家。
1. 地铁商家,或者地铁购票服务商可以自行定制开发APP或者H5前端页面
2. 利用支付宝行业领先的中间账户模式来解决退款和对账的问题
开发者可以使用下表中提供的4个接口,来完成线上购票的服务:
序号 | 接口名称 | 描述 | 主要参数 | 调用建议 |
---|---|---|---|---|
1 |
地铁车站数据查询 |
查询地铁取票站点。用于决定哪些站点可作为起点站。 |
入参:城市编码 出参:取票站点名称及编码 |
可每天调用一次。 |
2 |
购票发码 |
将支付到中间账户的订单信息上传,支付宝进行信息关联后,下发核销码 |
入参:订单号,购票信息 出参: 二维码值 |
用户付款至支付宝中间账户后调用。 |
3 |
购票发码退款 |
资金在中间账户时,用户主动发起退款,或兑换券过期的自动退款,可调用此接口实现 |
入参:订单号 出参:退款结果 |
可用户触发或系统触发;兑换券核销后,不能使用此接口进行退款。 |
4 |
核销码批量查询 |
可批量查询订单的核销状态,在订单列表、订单详情页面进行相应的状态展示 |
入参:支付宝订单号 出参:订单的核销状态 |
可在需要展示兑换券状态时调用 |
注:表格中所列的参数为“主要参数”,详细参数信息以接口说明为准。
提供业务流程中的几个关键页面及接口调用方式供参考:
杭州地铁APP,由地铁购票服务商开发,调用了线上购票的接口包,来完成线上购票的功能。
支付环节可调用支付宝标准支付接口。
手机网站支付:点击查看
App支付:点击查看
本产品不收取手续费。
本接口及文档资料由支付宝提供。您使用本接口,需要遵守开放平台相关协议及支付宝要求。