ChinaTicket.Online OPEN API Document
  1. train
ChinaTicket.Online OPEN API Document
  • Open API
    • flight
      • Flight Shopping
      • Flight Pricing
      • Price validation
      • Create origin order
      • pay an order
      • cancel an order
      • order detail
      • search change solutions
      • request an flight change
      • request an refund
      • confirm to refund the tiekct
    • train
      • Train Stations
        GET
      • Train shopping
        POST
      • Create train order
        POST
      • Order detail
        GET
      • Cancel an order
        DELETE
      • Pay an order
        POST
      • Intercept an order
        POST
      • Refund an order
        POST
    • Get Balance
      GET
  • Schemas
    • request
      • request.FlightShoppingRequest
      • request.PayFlightOrderRequest
      • request.ChangeFlightOrderRequests
      • request.CreateFlightOriginOrderRequest
      • request.FlightChangeSearchRequest
      • request.RefundFlightOrderRequest
    • consts
      • consts.CabinClass
      • consts.RefundReason
      • consts.FlightOrderStatus
      • consts.FlightOrderType
      • consts.FlightTicketStatus
      • consts.FlightProductType
      • consts.FlightInvoiceType
      • consts.FlightTaxType
      • consts.PassengerEligibility
    • model
      • model.FlightJourneyCore
      • model.PassengerCountRequest
      • model.ChangeSegment
      • model.PassengerFlightOrder
      • model.ChangeShoppingResult
      • model.ChangeShoppingSegment
      • model.FlightSegmentInfo
      • model.BaggageRule
      • model.BaggageRuleDetail
      • model.FlightCoreSegmentCache
      • model.StopOver
      • model.OrderDetail
      • model.FareRule
      • model.FlightJourney
      • model.FlightSegmentWithCoreSegment
      • model.CoreSegmentDetail
      • model.FlightScheduleChange
      • model.FlightPassengerTickets
      • model.FlightTicket
      • model.PriceDetail
      • model.PriceInFlightOriginOrder
      • model.PriceInFlightChangeOrder
      • model.PriceInFlightRefundOrder
      • model.PriceInFlightVoidOrder
      • model.FlightSolutionResp
      • model.FlightJourneyResp
      • model.FlightPriceDetail
      • model.FlightPrice
      • model.FlightTax
      • model.FlightSolutionLimitation
      • model.FlightLimitAgePair
    • Schemas
      • consts.PassengerType
      • consts.Gender
      • consts.TrainIssueWay
      • consts.TravelDocumentType
      • consts.TrainOrderStatus
      • consts.TrainOrderTicketStatus
      • consts.TrainPassengerStatus
      • consts.TrainRefundStatus
      • dto.PaginationList-array_resp_TrainOrderResp
      • resp.TrainOrderResp
      • resp.TrainOriginTicketDetail
      • req.TrainOrderListReq
      • response.Response-dto_PaginationList-array_resp_TrainOrderResp
      • model.CreateTrainOriginOrderReq
      • response.Response-resp_TrainOrderResp
      • resp.TrainChangeDetail
      • resp.TrainChangeTicketDetail
      • resp.StationDetail
      • model.ShoppingCNTrainStationsResp
      • req.TrainShoppingReq
      • response.Response-array_model_ShoppingCNTrainStationsResp
      • resp.Seats
      • resp.StationInfo
      • response.Response-array_resp_TrainShoppingResp
      • resp.TrainShoppingResp
  1. train

Create train order

POST
/api/v3/train/orders
create a train order

Request

Body Params application/json

Example
{
    "train": {
        "from": "BJS",
        "to": "SHA",
        "date": "2024-08-01",
        "trainCode": "51",
        "seatClassId": "yingzuo",
        "passengers": [
            {
                "surname": "Pam",
                "givenNames": "Marguerite",
                "birthday": "2005-07-19",
                "passengerType": "adult",
                "gender": "female",
                "nationality": "US",
                "travelDocument": "idcard",
                "travelDocumentNumber": "16",
                "travelDocumentExpireDate": "2025-03-06"
            },
            {
                "surname": "Mr. Jermaine Wilderman",
                "givenNames": "Dina",
                "birthday": "2025-02-25",
                "passengerType": "adult",
                "gender": "female",
                "nationality": "qui consectetur ea veniam",
                "travelDocument": "fpidcard",
                "travelDocumentNumber": "EY756745",
                "travelDocumentExpireDate": "2025-03-07 04:17:05"
            },
            {
                "surname": "Melanie",
                "givenNames": "Darrin",
                "birthday": "2004-04-06",
                "passengerType": "infant",
                "gender": "male",
                "nationality": "HK",
                "travelDocument": "tphm",
                "travelDocumentNumber": "EH868973",
                "travelDocumentExpireDate": "2025-03-07 04:27:19"
            }
        ]
    },
    "contact": {
        "contactName": "Elmer Doyle",
        "contactEmail": "Rupert.Balistreri@yahoo.com",
        "contactPhone": "(793) 528-4549"
    },
    "alterative": true
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v3/train/orders' \
--header 'Content-Type: application/json' \
--data-raw '{
    "train": {
        "from": "BJS",
        "to": "SHA",
        "date": "2024-08-01",
        "trainCode": "51",
        "seatClassId": "yingzuo",
        "passengers": [
            {
                "surname": "Pam",
                "givenNames": "Marguerite",
                "birthday": "2005-07-19",
                "passengerType": "adult",
                "gender": "female",
                "nationality": "US",
                "travelDocument": "idcard",
                "travelDocumentNumber": "16",
                "travelDocumentExpireDate": "2025-03-06"
            },
            {
                "surname": "Mr. Jermaine Wilderman",
                "givenNames": "Dina",
                "birthday": "2025-02-25",
                "passengerType": "adult",
                "gender": "female",
                "nationality": "qui consectetur ea veniam",
                "travelDocument": "fpidcard",
                "travelDocumentNumber": "EY756745",
                "travelDocumentExpireDate": "2025-03-07 04:17:05"
            },
            {
                "surname": "Melanie",
                "givenNames": "Darrin",
                "birthday": "2004-04-06",
                "passengerType": "infant",
                "gender": "male",
                "nationality": "HK",
                "travelDocument": "tphm",
                "travelDocumentNumber": "EH868973",
                "travelDocumentExpireDate": "2025-03-07 04:27:19"
            }
        ]
    },
    "contact": {
        "contactName": "Elmer Doyle",
        "contactEmail": "Rupert.Balistreri@yahoo.com",
        "contactPhone": "(793) 528-4549"
    },
    "alterative": true
}'

Responses

🟢200OK
application/json
OK
Body

Example
{
    "code": 0,
    "data": {
        "id": "string",
        "departureStation": {
            "code": "string",
            "name": "string",
            "altName": "string"
        },
        "departureDate": "string",
        "departureTime": "string",
        "arrivalStation": {
            "code": "string",
            "name": "string",
            "altName": "string"
        },
        "travelDays": 0,
        "arrivalTime": "string",
        "trainCode": "string",
        "trainType": "string",
        "duration": "string",
        "seatClassId": "string",
        "seatClassName": "string",
        "alterative": true,
        "estimateIssueTime": "string",
        "contactName": "string",
        "contactEmail": "string",
        "contactPhone": "string",
        "totalPrice": 0,
        "tickets": [
            {
                "id": 0,
                "surname": "string",
                "givenNames": "string",
                "birthday": "string",
                "passengerType": "adult",
                "gender": "male",
                "nationality": "string",
                "travelDocument": "passport",
                "travelDocumentNumber": "string",
                "travelDocumentExpireDate": "string",
                "ticketPrice": 0,
                "serviceFee": 0,
                "confirmationNumber": "string",
                "carNumber": "string",
                "seatNumber": "string",
                "status": "pending",
                "estimateRefund": "string",
                "createdAt": "string",
                "updatedAt": "string"
            }
        ],
        "status": "pending",
        "createdAt": "string",
        "updatedAt": "string"
    },
    "message": "string",
    "realMessage": "string"
}
Modified at 2025-12-10 04:10:59
Previous
Train shopping
Next
Order detail
Built with