在线接口文档中心

API说明: API调用说明订单状态推送通知说明

开放产品: 国内机票; 火车票; 线下火车票; 酒店; 门票; 电影票; 保险; 汽车票

线下火车票

免账号预订，无需注册和登录12306账号。支持24小时出票，支持定制需求购票，支持特殊人群（如外籍等）购票

接口地址： http://接口域名/trainOffline/createOrder

返回格式： json

请求方法： post

接口说明：

线下票免(12306)账号购票下单接口。

重要说明：

遇到卧铺传下铺价格、儿童票传成人票的价格，，，平台先按照最高票价预收，如果最终实际出票金额低于预收金额，平台将自动退差。

下单成功后请及时支付,新订单30分钟未支付订单将自动取消。

请商户严格按照该预订流程对接，不然会存在：无效订单占比过高(即：只下单不支付的单子)，接口账户被系统自动封禁的风险。

下单流程图.png

请求参数：

参数名称	类型	必填	说明
appKey	string	是	您申请的APPKEY
customerOrderNo	string	是	采购商的订单号
contactName	string	是	订单联系人姓名
contactMobile	string	是	订单联系人手机号
callBackUrl	string	是	出票结果回调地址（出票成功/失败时，将通过此地址回调给采购商，回调详见:订单状态推送通知说明）
refundTicketCallbackUrl	string	是	退票结果回调地址（退票成功/失败时，将通过此地址回调给采购商，回调详见:订单状态推送通知说明）
refundMoneyCallbackUrl	string	是	退款回调地址（退款时，将通过此地址回调给采购商，回调详见:订单状态推送通知说明）
trainSegments	TrainSegment[]	是	行程信息，支持联程（单程时该数组长度就是1，联程是就是2）
trainCode	string	是	车次号
fromStation	string	是	出发站
toStation	string	是	到达站
fromDateTime	string	是	出发日期及时间，精确到分钟，格式：yyyy-MM-dd HH:mm，如：2025-01-15 06:02
toDateTime	string	是	到达日期及时间，精确到分钟，格式：yyyy-MM-dd HH:mm，如：2025-01-15 06:02
isAcceptStanding	bool	是	是否接受无座，默认不接收
passengers	Passenger[]	是	乘客信息
name	string	是	乘客姓名
cardType	int	是	证件类型( 身份证 = 1,护照 = 2, 港澳居民来往内地通行证 = 3 , 台湾居民来往大陆通行证 = 4 ,外国人永久居留身份证 = 8 ,港澳台居民居住证 = 9 )
cardNo	string	是	证件号码
mobile	string	是	手机号
ticketType	int	是	火车票票种( 成人票 = 1,儿童票 = 2, 学生票 = 3, 残军票 = 4)
seatType	int	是	席别类型（商务座 = 1,特等座 = 2,一等座 = 3,二等座 = 4,高级软卧 = 5,软卧 = 6,动卧 = 7 ,硬卧 = 8,软座 = 9,硬座 = 10,一等卧 = 11,二等卧 = 12,高级动卧 = 13, 一等软座 = 14 , 二等软座 = 15, 特等软座 = 16, 包厢硬卧 = 17, 一人软包 = 18, 多功能座 = 19, 无座 =98,其他 = 99）
preTicketPrice	decimal	是	预收票价( 卧铺时传最高的下铺票价，儿童/学生/参军票时传成人票价 )
birthday	string	是	出生日期（格式：yyyy-MM-dd , 当cardType = 2,3,4,8时必填）
cardValidEndDate	string	是	证件有效期截止日期（格式：yyyy-MM-dd , 选填）
sex	int	是	性别（男 = 1 , 女 = 2 , 当cardType = 2,3,4,8时必填）
countryCode	string	是	国家/地区代码（当cardType = 2,8时必填。可向平台索取所有国家/地区代码静态数据）

返回参数：

参数名称	类型	说明
success	bool	下单结果（非出票结果），true：下单成功，false下单失败
msg	string	下单失败时，失败原因
data	object	业务参数（success为true时才有值，false时为null）
orderNo	string	订单号
totalPreTicketPriceAmount	decimal	订单中所有乘客的预收票价(下单请求参数中preTicketPrice字段)之和(余额支付时，将按照此金额收取。如果最终实际总出票价大于此值将会被拒单出票失败，小于此值时，出票成功后将自动退还多收取的票差)

JSON请求示例 :

单程下单请求示例：
{
  "appKey": "您申请的APPKEY",
  "customerOrderNo": "2025011022150473",
  "contactName": "张三",
  "contactMobile": "13912345678",
  "callBackUrl": "https://xxxxxx/outTicketResultCallback",
  "refundTicketCallbackUrl": "https://xxxxxx/refundTicketResultCallback",
  "refundMoneyCallbackUrl": "https://xxxxxx/refundMoneyCallback",
  "trainSegments": [
    {
      "trainCode": "K1158",
      "fromStation": "合肥",
      "toStation": "蚌埠",
      "fromDateTime": "2025-01-15 06:02",
      "toDateTime": "2025-01-15 08:15",
      "isAcceptStanding": false,
      "isAcceptOtherSeat": false,
      "passengers": [
        {
          "name": "张三",
          "cardType": "1",
          "cardNo": "340123197209183099",
          "mobile": "13912345678",
          "ticketType": 1,
          "seatType": 8,
          "preTicketPrice": 77.5
        },
        {
          "name": "李四",
          "cardType": "1",
          "cardNo": "441721198812150039",
          "mobile": "13912345678",
          "ticketType": 1,
          "seatType": 8,
          "preTicketPrice": 77.5
        },
        {
          "name": "王二",
          "cardType": "1",
          "cardNo": "620821200112042422",
          "mobile": "13912345670",
          "ticketType": 1,
          "seatType": 8,
          "preTicketPrice": 77.5
        }
      ]
    }
  ]
}



联程下单请求示例：
{
  "appKey": "您申请的APPKEY",
  "customerOrderNo": "2025011022150485",
  "contactName": "张三",
  "contactMobile": "13912345678",
  "callBackUrl": "https://xxxxxx/outTicketResultCallback",
  "refundTicketCallbackUrl": "https://xxxxxx/refundTicketResultCallback",
  "refundMoneyCallbackUrl": "https://xxxxxx/refundMoneyCallback",
  "trainSegments": [
    {
      "trainCode": "K1158",
      "fromStation": "合肥",
      "toStation": "蚌埠",
      "fromDateTime": "2025-01-15 06:02",
      "toDateTime": "2025-01-15 08:15",
      "isAcceptStanding": false,
      "isAcceptOtherSeat": false,
      "passengers": [
        {
          "name": "张三",
          "cardType": "1",
          "cardNo": "340123197209183099",
          "mobile": "13912345678",
          "ticketType": 1,
          "seatType": 8,
          "preTicketPrice": 77.5
        },
        {
          "name": "李四",
          "cardType": "1",
          "cardNo": "441721198812150039",
          "mobile": "13912345678",
          "ticketType": 1,
          "seatType": 8,
          "preTicketPrice": 77.5
        },
        {
          "name": "王二",
          "cardType": "1",
          "cardNo": "620821200112042422",
          "mobile": "13912345670",
          "ticketType": 1,
          "seatType": 8,
          "preTicketPrice": 77.5
        }
      ]
    },
    {
      "trainCode": "K1276",
      "fromStation": "蚌埠",
      "toStation": "呼和浩特",
      "fromDateTime": "2025-01-15 16:45",
      "toDateTime": "2025-01-16 19:08",
      "isAcceptStanding": false,
      "isAcceptOtherSeat": false,
      "passengers": [
        {
          "name": "张三",
          "cardType": "1",
          "cardNo": "340123197209183099",
          "mobile": "13912345678",
          "ticketType": 1,
          "seatType": 8,
          "preTicketPrice": 343.5
        },
        {
          "name": "李四",
          "cardType": "1",
          "cardNo": "441721198812150039",
          "mobile": "13812345678",
          "ticketType": 1,
          "seatType": 8,
          "preTicketPrice": 343.5
        },
        {
          "name": "王二",
          "cardType": "1",
          "cardNo": "620821200112042422",
          "mobile": "13812345679",
          "ticketType": 1,
          "seatType": 8,
          "preTicketPrice": 343.5
        }
      ]
    }
  ]
}

JSON返回示例 :

下单成功示例：
{
    "data": {
        "orderNo": "TX25011213525343937",
        "totalPreTicketPriceAmount": 232.5
    },
    "success": true,
    "msg": "请求成功"
}

下单失败示例：
{
    "data": null,
    "success": false,
    "msg": "火车票票款余额不足，当前账户火车票票款余额:8.51小于订单票款总金额：232.5"
}

参数名称	类型	说明
success	bool	是否获取成功
msg	string	获取失败时原因（只要改签单号无误，都会获取成功，除非服务器异常了）
data	ChangeOrder	业务参数，改签单详情类型，和【订单详情接口】响应参数中的changeOrders数组类型，是同一个类型
chaNo	string	改签单号
orderNo	string	订单号
oldTrainSegmentID	string	原订单车程ID( 对应订单详情中的 trainSegments—>trainSegmentID车程ID字段 )，在联程订单中通过该值可以判断当前的改签是第一程的改签，还是第二程的改签
trainCode	string	改签后的车次号
fromStation	string	改签后的出发站
toStation	string	改签后的到达站
FromDateTime	string	改签后的出发日期时间（精确到分钟，如： 2024-11-25 16:30）
toDateTime	string	改签后的到达日期时间（精确到分钟，如： 2024-11-25 16:30）
ticketEntrance	string	检票口
chaOrderStatus	int	改签单状态(改签待支付或待确认 = 1 , 改签处理中 = 2 , 改签成功 = 3 , 改签失败 = 4 , 改签已取消 = 9 )，，是否改签成功以此字段值为准哦，当且仅当该值等于 3 时才是改签成功
totalOldTicketPriceAmount	decimal	改签单中所有乘客原客票的实际出票票款之和，即改签单总的原票实际出票票款。
totalChaTicketPriceAmount	decimal	改签单中所有改签新客票的实际出票票价之和，即改签单总的新客票实际出票票款金额 (改签成功才有值哦)
totalPrePayAmount	decimal	整个改签单总的改签预收款金额（如果涉及改签收费的，该值为确认改签时需要预收的改签单总金额，为0表示改签时无需支付预收款）。PS:如果改签成功时实际应付的总金额小于该值时，在改签成功时系统会自动退差额
total12306RealPayAmount	decimal	改签单(总的)12306实际支付金额，改签成功才有值。PS:如果在改签成功时该值小于totalPrePayAmount值时，系统会自动退差额
total12306RealRefundAmount	decimal	改签单(总的)12306实际退款金额，改签成功才有值。
confirmChangeTime	string	调用【改签确认/支付接口】接口来确认改签的时间
changeSuccessTime	string	改签成功的时间
payStatus	int	当改签单需要预支付时（即totalPrePayAmount >0），改签单的支付状态：0未支付 1已支付
refundAmount	decimal	改签失败退款或改签成功预收差价退款的退款金额
refundTime	string	改签失败退款或改签成功预收差价退款的退款时间
numberOfTickets	int	改签单中的改签客票数
totalChangeTicketServiceFee	decimal	改签单总的改签服务费（改签成功才会收取）
changeTicketServiceFeePerTicket	decimal	单张票的改签服务费
changeTicketServiceFee_PayTime	string	改签服务费支付成功时间（改签成功时改签服务费自动扣取成功后才会有值）
callbackUrl	string	改签结果异步回调地址（在改签下单接口中传入的）
confirmChangeLimitTime	string	确认改签时间限制（超过此时限将无法确认），现在是改签下单后的30分钟，比如是在 2025-01-01 10:00:00 改签下单的，则该值为顺延30分钟后的时间点，即： 2025-01-01 10:30:00
unFinishedReason	string	当改签失败时原因（常见原因如：余票不足、超时未确认改签自动取消等）
createTime	string	改签单申请时间
changeTickets	ChangeTicket[]	改签客票对象数组（长度=当前改签单的改签人数）
passengerID	int	客票ID（同原票的客票ID）
name	string	乘客姓名
cardType	int	证件类型( 身份证 = 1,护照 = 2, 港澳居民来往内地通行证 = 3 , 台湾居民来往大陆通行证 = 4 ,外国人永久居留身份证 = 8 ,港澳台居民居住证 = 9 )
cardNo	string	证件号码
ticketType	int	票种类型（成人票 = 1,儿童票 = 2, 学生票 = 3, 残军票 = 4）
seatType	int	改签新票的席别类型（商务座 = 1,特等座 = 2,一等座 = 3,二等座 = 4,高级软卧 = 5,软卧 = 6,动卧 = 7 ,硬卧 = 8,软座 = 9,硬座 = 10,一等卧 = 11,二等卧 = 12,高级动卧 = 13, 一等软座 = 14 , 二等软座 = 15, 特等软座 = 16, 包厢硬卧 = 17, 一人软包 = 18, 多功能座 = 19, 无座 =98,其他 = 99）
oldTicketPrice	decimal	原票的实际出票价
ticketPrice	decimal	改签新票的实际出票价(改签成功才有值哦)
preTicketPrice	decimal	改签新票的预收票价( 卧铺按照下铺收，儿童按照成人收 )，改签下单时传入的
priceChangeType	int	当前客票改签后，价格变动类型：新票款高于原票款 = 1 , 新票款等于原票款 = 2 , 新票款低于原票款 = 3 （改签成功后该值才是准确的，改签成功之前是根据传入的PreTicketPrice判断的）
changeRate	decimal	改签费率，如 0,0.05,0.15,0.4
changeFee	decimal	改签费
diffRate	decimal	改签差额退票手续费率，默认 0，如 0,0.05
diffRefundFee	decimal	高改低差额退票的手续费 = （高原票价 - 新低票价）* 改签差额退票手续费率diffRate
prePayAmount	decimal	当前改签乘客预收款，大于0表示需要预付，计算规则：同改时=改签费，低改高时=新票价+改签费，高改低时 = Max( 改签费+票款差额退票费 - 票款差额,0)
realRefundAmount	decimal	改签(成功)实际退款金额(改签成功才有值哦)
realPayAmount	decimal	改签(成功)实际支付金额(改签成功才有值哦)
carriageNo	string	改签新票的车厢号(改签成功才有值哦)
seatNo	string	改签新票的座位号(改签成功才有值哦)
ticketStatus	int	改签新票的客票状态（待改签 = 4, 改签成功 = 5 ，已退票 = 99）
appRefundTicketTime	string	申请退票时间(多次申请，为最后一次申请时间)
refundOrderStatus	int	退票(单)状态（未申请 = 0 , 退票处理中 = 1 , 已退票待退款 = 2 , 已退票退款中 = 3, 已退票已退款 = 4, 退票失败 = 9。 PS：当该值为1/2/3/4时不可再次重复提交退票申请；当值为0/9时可提交退票申请）
refundTicketAmount	decimal	退票退款金额(改签票退票成功才有值)
refundSuccessTime	string	退票退款成功时间（改签票退票退款成功才有值）
refundTicketWay	int	退票方式：1:线上 , 2:线下 (退票成功才有值)。只有1:线上退票的才收退票服务费
refundFailReason	string	（退票）退款失败原因
refundTicketServiceFee	decimal	单张票的退票服务费 (退票成功后收取)
refundTicketServiceFee_PayTime	string	退票服务费支付成功时间（有值表示已收取，空表示未收取）

	内容	详细
	售前咨询:	15021905015
	客服热线:	17306152795
	在线客服QQ:	1437759532
	测试工具:	推荐使用PostMan
	技术支持:	info@panhe.net

参数名称	类型	说明
success	bool	支付结果，true表示余额支付成功，false表示余额支付失败。
msg	string	当支付失败，失败原因

参数名称	类型	说明
success	string	true表示退票申请成功，false表示退票申请失败（PS: 返回true时，仅代表退票申请成功，是否退票成功结果将会通过退票回调接口推送给采购，也可轮询订单详情接口获取）
msg	string	申请失败时，失败原因

参数名称	类型	说明
success	bool	true表示改签下单成功，false表示改签下单失败
msg	string	当改签下单失败时，失败原因
data	object	当改签成功时才有值，具体类型如下
chaNo	string	改签单号
totalPrePayAmount	string	改签单需预付款金额（大于0表示确认改签时需要先支付）

参数名称	类型	说明
success	bool	true：改签确认/支付成功，false改签改签确认/支付失败
msg	bool	当改签确认/支付失败时，失败原因

参数名称	类型	必填	说明
appKey	string	是	接口账户appKey
orderNo	string	是	线下火车票订单号