API方式接入

如果您拥有自己的WEB或APP应用系统,希望增加火车票出票业务。本站的火车票代购电子客票业务可以通过API接入,自主从购票用户收取票款和服务费。

接入协议:采用HTTPS协议,参数采用POST传递,返回采用JSON格式。

余票查询
输入参数:发站、到站、日期。
说明:余票列表,展示给用户选择。

提交订单
输入参数:选择的车次、席别、价格、余票,乘车人姓名、身份证、手机号,注册用户的手机号。
说明:存储订单,产生订单ID、预收款金额,按照预估金额冻结资金,余额不足失败。

支付结果
输入参数:订单ID、预收款金额。
说明:只有收款成功后调用。预收款金额仅是未出票之前的预估值,结算扣款以实际出票价格产生的金额为准。

查询订单列表
输入参数:注册用户的手机号。
说明:用户半年内订单列表。

查询订单详细
输入参数:订单ID。
说明:包含乘车人、出票信息的订单详细。

出票通知
输入参数:订单ID、成功or失败标志、预收款金额、实际金额。
说明:出票成功时提供实际出票金额,差额需要退回给用户。当出现姓名与系统默认不一致、行程冲突、限制高消费等情况时,出票失败,需要把钱退回给购票用户。