CTO OPEN API Document
    中文
    • English
    • 中文
    • Default module
      • Flight
        • 查询与报价
          • 航班查询
          • 航段报价
          • 全舱报价
          • 方案验价
          • 查询退改签和行李规则
        • 订单
          • 创建航班原始订单
          • 查询航班订单列表
          • 查询航班订单详情
          • 取消航班订单
          • 通过外部订单号查询航班订单
          • 支付航班订单
        • 退改签
          • 查询订单是否可退改
          • 航班改签搜索 / 查价
          • 创建航班改签单
          • 查询航班可退金额
          • 创建航班退票单
          • 确认航班退票单
        • 服务与状态
          • 行李直挂 / 中转行李查询
          • 查询航班票号状态
          • 下载电子客票行程单
        • 账户
          • 查询航班账户余额
      • Train
        • 12306
          • 获取 12306 常用联系人
          • 获取 12306 支付表单
          • 登录 12306
          • 发送 12306 短信验证码
          • 验证 12306 短信验证码
          • 编辑 12306 乘客
          • 执行 12306 人脸核验
          • 提交外籍护照核验
          • 查询外籍护照核验进度
        • 查询与预订
          • 查询火车票
          • 检查座位和价格
          • 查询预订必填项
          • 创建火车票订单
        • 订单
          • 查询火车票订单
          • 查询订单退改条件
          • 确认预售订单
          • 支付订单
          • 取消订单
        • 车次与站点
          • 按订单查询经停车站
          • 按车次查询经停车站
          • 搜索城市和车站
          • 批量获取城市和车站
          • 查询汇率
        • 退改签
          • 预估改签费用
          • 预估退票费用
          • 申请改签
          • 申请退票
          • 确认改签
          • 确认退票
        • 合作方同步
          • 增量同步城市
          • 增量同步车站
        • 电子票
          • 下载 PDF 电子票
          • 获取 HTML 电子票
          • 按类型获取电子票
      • Schemas
        • ApiResponseBase
        • ErrorResponse
        • EmptyObject
        • CabinClass
        • PassengerType
        • Gender
        • TravelDocument
        • AllianceCode
        • TransportType
        • RefundReason
        • ChangeReason
        • FlightOrderType
        • FlightOrderStatus
        • PaymentChannel
        • ConfirmationType
        • ConfirmationIata
        • PassengerInfo
        • FlightJourney
        • PassengerCount
        • AccountCode
        • ShoppingRequirements
        • ShoppingVirtualInterlineConfig
        • ShoppingConfigs
        • OpenAPIFlightShoppingReq
        • PricingReqSegment
        • FlightPricingReq
        • AllCabinPriceReq
        • SolutionValidateReq
        • FareRulesReq
        • CreateFlightOriginOrderRequest
        • PassengerForCreateOriginOrder
        • PayFlightOrderReq
        • RefundChangeAvailabilityReq
        • ChangeSearchReq
        • ChangeSearchPassenger
        • ChangeSearchJourney
        • CreateChangeOrderReq
        • ChangeSegmentItem
        • ChangeNewSegment
        • RefundMoneySearchReq
        • CreateFlightRefundOrderOpenAPIRequest
        • BaggageTransitReq
        • BaggageTransitLeg
        • BaggageTransitSegment
        • BaggageTransitStopInfo
        • TicketStatusReq
        • TicketStatusPassenger
        • DownloadAirTicketItineraryRequest
        • ConfirmationSheetPrice
        • OpenAPIShoppingResp
        • OpenAPICoreSegment
        • StopOver
        • OpenAPISolutionResp
        • OpenAPIPriceDetail
        • OpenAPILimitInfo
        • FlightLimitAgePair
        • FlightSolutionGroupInfo
        • OpenAPIPrice
        • OpenAPITax
        • OpenAPIJourneyResp
        • OpenAPISegmentInfo
        • OpenAPIBaggageRule
        • BaggageRuleDetail
        • OpenAPIBaggageRules
        • OpenAPIFareRules
        • OpenAPIFareRule
        • OpenAPIPricingResp
        • OpenAPIPricingSolutionResp
        • OpenAPIPricingPriceDetail
        • OpenAPIPricingPrice
        • OpenAPIPricingJourneyResp
        • OpenAPIPricingSegmentInfo
        • OpenAPIVerificationResp
        • OpenAPIFareRulesResp
        • OpenAPIOrderResp
        • OpenAPIOrderJourney
        • OpenAPIOrderSegment
        • OpenAPIOrderCoreSegment
        • OpenAPIOrderPassenger
        • OpenAPIOrderTicket
        • OpenAPIOrderPriceDetail
        • OpenAPIOrderPrice
        • OpenAPIOriginOrderPrice
        • OpenAPIChangeOrderPrice
        • OpenAPIRefundOrderPrice
        • OpenAPIOrderListResp
        • OpenAPIRefundChangeAvailabilityResp
        • OpenAPIRefundChangeAvailabilityPassenger
        • OpenAPIAskChangeDetail
        • OpenAPIAskRefundDetail
        • OpenAPIChangeSearchResp
        • OpenAPIChangeSolutionResp
        • OpenAPIChangePriceDetail
        • OpenAPIChangePrice
        • OpenAPIRefundMoneySearchResp
        • OpenAPIBaggageTransitLeg
        • OpenAPIBaggageTransitSegmentInfo
        • TicketStatusResp
        • TicketStatusItem
        • TicketCouponStatus
        • BalanceResp
        • TrainApiResponseBase
        • TrainErrorResponse
        • TrainConnectionRegion
        • TrainPriceBasis
        • TrainOrderStatus
        • TrainTicketStatus
        • TrainTicketType
        • TrainPassengerAttribute
        • LocalizedName
        • TrainShoppingLocation
        • TrainShoppingRequest
        • TrainStationWithDateTime
        • TrainCarrier
        • TrainShoppingFeature
        • TrainPassengerTypeInfo
        • TrainSeatInfo
        • TrainShoppingSegment
        • TrainShoppingJourney
        • TrainShoppingData
        • TrainPrice
        • TrainAvailabilityRequest
        • TrainAvailabilityData
        • TrainBookingRequirementsData
        • TrainSeatPreference
        • TrainOrderContactRequest
        • TrainOrderContact
        • TrainPassengerRequest
        • Train12306Account
        • TrainCreateOrderRequest
        • TrainCreateChangeRequest
        • TrainCreateRefundRequest
        • TrainChangeEstimateRequest
        • TrainRefundEstimateRequest
        • TrainPassenger
        • TrainOrderSegment
        • TrainOrderTicket
        • TrainOrderJourney
        • TrainOrder
        • TrainConditionFee
        • TrainCondition
        • TrainOrderConditions
        • TrainRefundEstimateItem
        • TrainRefundEstimateData
        • TrainChangeEstimateItem
        • TrainChangeEstimateData
        • TrainStopStation
        • Train12306AccountRequest
        • Train12306Contact
        • Train12306PayFormRequest
        • Train12306PayFormData
        • Train12306LoginRequest
        • Train12306PassengerInfo
        • Train12306LoginData
        • Train12306SendSmsRequest
        • Train12306SmsVerifyRequest
        • Train12306SmsSendData
        • Train12306OperationData
        • Train12306PassengerDto
        • Train12306EditPassengerRequest
        • Train12306FaceImage
        • Train12306FaceVideo
        • Train12306FaceVerifyRequest
        • Train12306ForeignPassportRequest
        • Train12306PassportProcessRequest
        • Train12306PassportCheckData
        • TrainStationInfo
        • TrainCityInfo
        • TrainStationSearchCity
        • TrainStationSearchData
        • TrainCitiesStationsData
        • TrainOrderTicketFile
        • TrainSyncRequest
        • TrainSyncCity
        • TrainSyncStation
        • TrainSyncCitiesData
        • TrainSyncStationsData
        • TrainShoppingApiResponse
        • TrainAvailabilityApiResponse
        • TrainBookingRequirementsApiResponse
        • TrainOrderApiResponse
        • TrainStopStationsApiResponse
        • TrainConditionsApiResponse
        • TrainChangeEstimateApiResponse
        • TrainRefundEstimateApiResponse
        • TrainEmptyApiResponse
        • Train12306ContactsApiResponse
        • Train12306PayFormApiResponse
        • Train12306LoginApiResponse
        • Train12306SmsSendApiResponse
        • Train12306SmsVerifyApiResponse
        • Train12306OperationApiResponse
        • Train12306PassportCheckApiResponse
        • TrainSyncCitiesApiResponse
        • TrainSyncStationsApiResponse
        • TrainTicketsApiResponse
        • TrainStationSearchApiResponse
        • TrainCitiesStationsApiResponse
        • TrainExchangeRatesApiResponse
        • ShoppingApiResponse
        • PricingApiResponse
        • VerificationApiResponse
        • FareRulesApiResponse
        • OrderApiResponse
        • OrderListApiResponse
        • RefundChangeAvailabilityApiResponse
        • ChangeSearchApiResponse
        • RefundMoneySearchApiResponse
        • BaggageTransitApiResponse
        • TicketStatusApiResponse
        • BalanceApiResponse

    OpenAPIPricingResp

    {
        "searchKey": "sk_001",
        "segments": [
            {
                "id": "PEK-SHA-20260801-CA1234",
                "airline": "CA",
                "flightNo": "CA1234",
                "isCodeShare": false,
                "opAirline": "CA",
                "opFlightNo": "CA1234",
                "equipment": "738",
                "mealType": "Meal",
                "departure": "PEK",
                "departureDate": "2026-08-01",
                "departureTime": "08:00",
                "departureTerminal": "T3",
                "arrival": "SHA",
                "arrivalDate": "2026-08-01",
                "arrivalTime": "10:20",
                "arrivalTerminal": "T2",
                "distance": 1080,
                "flightTime": "2h20m",
                "stopovers": [
                    {
                        "city": "HGH",
                        "airport": "HGH",
                        "duration": "1h10m",
                        "arrivalTime": "10:00",
                        "departureTime": "11:10"
                    }
                ]
            }
        ],
        "solutions": [
            {
                "solutionId": "sol_2f4d3c",
                "source": "",
                "orderKey": "ok_9ecf",
                "priceDetail": {
                    "invoiceType": "normal",
                    "issuingAirline": "CA",
                    "saleAirline": "CA",
                    "productType": "publish",
                    "maxCount": 9,
                    "limitInfo": {
                        "nationalityAllows": [
                            "CN"
                        ],
                        "nationalityForbids": [
                            "US"
                        ],
                        "agePairs": [
                            {
                                "maxAge": 65,
                                "minAge": 18
                            }
                        ],
                        "allowedTravelDocuments": [
                            "passport"
                        ],
                        "passengerQualification": "",
                        "groupInfo": {
                            "max": 9,
                            "min": 2
                        }
                    },
                    "priceList": [
                        {
                            "passengerType": "adult",
                            "fareBasisCode": "YOWCN",
                            "brandCode": "ECONOMY",
                            "num": 1,
                            "publishPrice": 1000,
                            "price": 950,
                            "salePrice": 1000,
                            "tax": 200,
                            "currency": "CNY",
                            "taxDetail": [
                                {
                                    "type": "YQ",
                                    "amount": 100
                                }
                            ],
                            "discount": 100,
                            "serviceFee": 50
                        }
                    ]
                },
                "journeys": [
                    {
                        "origin": "BJS",
                        "destination": "BKK",
                        "departureDate": "2026-08-01",
                        "departureTime": "08:00",
                        "arrivalDate": "2026-08-01",
                        "arrivalTime": "15:00",
                        "duration": "7h00m",
                        "transferNum": 1,
                        "segments": [
                            {
                                "coreSegmentId": "PEK-SHA-20260801-CA1234",
                                "cabinClass": "economy",
                                "cabinCode": "Y",
                                "subCabinCode": "Y1",
                                "fareBasis": "YOWCN",
                                "brandCode": "ECONOMY",
                                "availability": 9,
                                "stayTime": "2h10m",
                                "fareBasisCode": "YOWCN"
                            }
                        ]
                    }
                ],
                "fareRules": {
                    "PEKSHA": [
                        {
                            "passengerType": "adult",
                            "canVoid": true,
                            "currency": "CNY",
                            "change": {
                                ">0": 300,
                                ">4": 200,
                                "<-4": 500
                            },
                            "refund": {
                                ">0": 500,
                                ">4": 300,
                                "<-4": 800
                            }
                        }
                    ]
                },
                "baggageRules": {
                    "PEKSHA": [
                        {
                            "passengerType": "adult",
                            "carryOn": {
                                "pieces": 1,
                                "weight": 7,
                                "unit": "KG"
                            },
                            "checked": {
                                "pieces": 1,
                                "weight": 23,
                                "unit": "KG"
                            }
                        }
                    ]
                }
            }
        ]
    }
    Built with