地铁线上购票产品介绍

支付宝地铁购票服务,提供了地铁单程票线上购买,线下取票的服务。为地铁行业解决了现场购票效率低下、现金找零麻烦的难题。

 

用户取票流程如下:

地铁商家只需要通过BD完成签约,提供线路、站点、票价等信息,支付宝与机具提供商完成核销对接后,服务即可上线。

在已与支付宝完成购票服务对接的城市,通过使用支付宝提供的开放接口,地铁商家或者经过地铁授权的地铁购票服务商,可以在自己的APP,或者自行开发的H5应用中为用户提供在线购票服务。

产品特色

1. 购票、取票分离

地铁购票服务,可分为购票、取票两个环节。购票环节提供在线购票的服务,取票环节,用户持购票后获取的二维码,在取票机上刷码核销,完成取票(本文档提供的是购票环节所需接口)。

2. 中间账户模式

为解决用户购票但未取票这部分资金管理所带来的退款、对账混乱的问题,支付宝提供了一套中间账户资金流转的模式。在线购票时,资金先支付至支付宝指定中间账户中,线下取票后,资金会自动结算给地铁商家。 

解决问题

1. 地铁商家,或者地铁购票服务商可以自行定制开发APP或者H5前端页面

2. 利用支付宝行业领先的中间账户模式来解决退款和对账的问题

使用说明

开发者可以使用下表中提供的4个接口,来完成线上购票的服务:

序号 接口名称 描述 主要参数 调用建议

1

地铁车站数据查询

查询地铁取票站点。用于决定哪些站点可作为起点站。

入参:城市编码

出参:取票站点名称及编码

可每天调用一次。

2

购票发码

将支付到中间账户的订单信息上传,支付宝进行信息关联后,下发核销码

入参:订单号,购票信息

出参: 二维码值

用户付款至支付宝中间账户后调用。

3

购票发码退款

资金在中间账户时,用户主动发起退款,或兑换券过期的自动退款,可调用此接口实现

入参:订单号

出参:退款结果

可用户触发或系统触发;兑换券核销后,不能使用此接口进行退款。

4

核销码批量查询

可批量查询订单的核销状态,在订单列表、订单详情页面进行相应的状态展示

入参:支付宝订单号

出参:订单的核销状态

可在需要展示兑换券状态时调用

注:表格中所列的参数为“主要参数”,详细参数信息以接口说明为准。

提供业务流程中的几个关键页面及接口调用方式供参考:

 

应用案例

杭州地铁APP,由地铁购票服务商开发,调用了线上购票的接口包,来完成线上购票的功能。

准入条件

  1. 本服务仅限在接入了支付宝地铁购票、核销整体方案的城市使用(试点城市:深圳、杭州等)
  2. 地铁购票服务商需要获取地铁官方的地铁站点、线路、票价等数据,并获取地铁公司的授权许可。
  3. 服务接入需要支付宝的BD协助签约后才可实施。 

产品关联推荐

支付环节可调用支付宝标准支付接口。 

手机网站支付:点击查看

App支付:点击查看

计费模式

本产品不收取手续费。

 

本接口及文档资料由支付宝提供。您使用本接口,需要遵守开放平台相关协议及支付宝要求。

onlineServer