PayValid

  • 用途：用于校验当前Order是否可支付，保证出票成功率
  • 请求方式：POST
  • 接口加密：否

请求参数

参数名称 类型 必填 说明
requestId string ✅ 请求ID，预订环节中的各个接口是唯一的，可通过本字段串联一个完整的预订流程，长度32位
orderNo string ✅ AeroHub的订单号，长度20个字符，供应商需要保存，出票环节需要用这个字段做关联
tripType int ✅ 行程类型：1 单程、2 往返，若传1或2，则代表本次搜索只需要这个类型的行程
sessionId string ✅ 会话标识，供应商在预定环节串联各个接口的唯一标识，由数字或字母组成，最大长度40字符
routing object/routing Element ✅ 行程与报价信息，参考Order接口中的object/routing Element
pnrCode string 用于报价（占舱）的PNR编码

object/routing Element

参数名称 类型 必填 说明
data string ✅ Order接口Routing返回的data原文，用于供应商做内部业务串联长度不超过64位
fromSegments array/Segment Element ✅ 去程的行程信息
retSegments array/Segment Element ⬜️ 回程的行程信息

array/Segment Element

参数名称 类型 必填 说明
marketingCarrier string ✅ 航空公司代码，采用 IATA 二字代码做为标准，与flightNumber中的前两位对应
depAirport string ✅ 出发机场代码，采用 IATA 三字代码做为标准
depTime string ✅ 起飞日期和起飞时间（当地时间），格式：YYYYMMDDHHMM，例如202303100300 表示 2023年3月10日3时0分
arrAirport string ✅ 到达机场代码，采用 IATA 三字代码做为标准
arrTime string ✅ 到达日期和到达时间（当地时间），格式：YYYYMMDDHHMM，例如202303101305 表示 2023年3月10日13时5分
stopCities string ⬜️ 经停城市，多个用/分开，采用 ISO 3166 三字代码做为标准
codeShare bool ✅ 本航班是否是共享航班，true 是共享航班、false 不是共享航班，若返回true，则operatingCarrier和operatingFlightNo必须返回
seatClass string ✅ 舱位
aircraftCode string ✅ 机型，采用 IATA 三字代码做为标准
flightNumber string ✅ 航班号，如：CA123

请求示例

{
    "requestId": "bc3461520668454e",
    "orderNo": "F1726885264686714880",
    "tripType": 2,
    "sessionId": "aNBOGd3p7Kf72ALZOQY",
    "routing": {
        "data": "DST_djlfOUNCMkNCSl9QVkd",
        "fromSegments": [{
            "marketingCarrier": "9C",
            "depAirport": "PVG",
            "depTime": "202302100915",
            "arrAirport": "HKG",
            "arrTime": "202302101220",
            "stopCities": "",
            "codeShare": false,
            "seatClass": "V",
            "aircraftCode": "",
            "flightNumber": "9C8921"
        }],
        "retSegments": [{
            "marketingCarrier": "9C",
            "depAirport": "HKG",
            "depTime": "202302151320",
            "arrAirport": "PVG",
            "arrTime": "202302151545",
            "stopCities": "",
            "codeShare": false,
            "seatClass": "V",
            "aircraftCode": "",
            "flightNumber": "9C8922"
        }],
    },
    "pnrCode":"R17ZCV",
}

返回参数

参数名称 类型 必填 说明
marketErrorCode int ✅ 供应商系统错误码，用于协助AeroHub与供应商排查问题，请如实返回真实错误
marketErrorMsg string ✅ 供应商系统错误描述，请如实返回真实错误原因，长度小于 300
sessionId string ✅ 会话标识，供应商在预定环节串联各个接口的唯一标识，由数字或字母组成，最大长度40字符
orderNo string ✅ 供应商自己系统的订单号，最大 30 个字符，AeroHub会记录本字段，用于后期追溯
routing object ✅ 行程与报价信息，参考Order接口中的object/routing Element

返回示例

Success-Response:

{
    "marketErrorCode": 200,
    "marketErrorMsg": "Successful",
    "sessionId": "aNBOGd3p7Kf72ALZOQY",
    "orderNo": "231121164918540071",
    "routing": {
        "data": "DST_djlfOUNCMkNCSl9QVkdfSEtHXzIwMj",
        "fromSegments": [{
            "marketingCarrier": "9C",
            "depAirport": "PVG",
            "depTime": "202302100915",
            "arrAirport": "HKG",
            "arrTime": "202302101220",
            "seatGrade": "",
            "seatClass": "V",
            "flightNumber": "9C8921",
            "codeShare": false,
            "aircraftCode": "",
            "segmentNo": 1,
            "operatingCarrier": "",
            "operatingFlightNo": "",
            "stopCities": "",
            "stopAirports": ""
        }],
        "retSegments": [{
            "marketingCarrier": "9C",
            "depAirport": "HKG",
            "depTime": "202302151320",
            "arrAirport": "PVG",
            "arrTime": "202302151545",
            "seatClass": "V",
            "seatGrade": "",
            "flightNumber": "9C8922",
            "codeShare": false,
            "aircraftCode": "",
            "segmentNo": 2,
            "operatingCarrier": "",
            "operatingFlightNo": "",
            "stopCities": "",
            "stopAirports": ""
        }],
        "priceList": [{
            "passengerType": 0,
            "publishPrice": 0,
            "price": 608,
            "taxFeeAmount": 369,
            "taxFeeDisclosureList": []
        },
        "eligibility": "NOR",
        {
            "passengerType": 1,
            "publishPrice": 0,
            "price": 608,
            "taxFeeAmount": 369,
            "taxFeeDisclosureList": []
        }],
        "validatingCarrier": "9C",
        "productType": "",
        "fareBasis": "",
        "bookingOfficeNo": "",
        "ticketingOfficeNo": "",
        "reservationType": "",
        "posCode": "",
        "complexTerm": 0,
        "minAge": 0,
        "maxAge": 0,
        "planCategory": 0,
        "invoiceType": "E",
        "minPassengerCount": 1,
        "maxPassengerCount": 9,
        "note": "xxx",
        "airlineAncillaries": {
            "baggageService": true,
            "unFreeBaggage": true
        },
        "formatBaggageDetailList": [],
        "refundInfoList": [{
            "passengerType": 0,
            "refundType": 0,
            "refundStatus": "T",
            "refundFee": 0,
            "refNoshow": "T",
            "refNoShowCondition": 0,
            "refNoshowFee": 0,
            "conditionList": []
        },
        {
            "passengerType": 1,
            "refundType": 0,
            "refundStatus": "T",
            "refundFee": 0,
            "refNoshow": "T",
            "refNoShowCondition": 0,
            "refNoshowFee": 0,
            "conditionList": []
        }],
        "changesInfoList": [{
            "passengerType": 0,
            "changesType": 0,
            "changesStatus": "T",
            "changesFee": 0,
            "revNoshow": "T",
            "revNoShowCondition": 0,
            "revNoshowFee": 0,
            "conditionList": ""
        },
        {
            "passengerType": 1,
            "changesType": 0,
            "changesStatus": "T",
            "changesFee": 0,
            "revNoshow": "T",
            "revNoShowCondition": 0,
            "revNoshowFee": 0,
            "conditionList": ""
        }],
        "packageInfo": null,
        "currency": "USD",
        "ticketTimeUnit": 1000,
        "combineIndexs": [],
        "endorsement": 0
    }
}

Error-Response

{
    "marketErrorCode": 5112,
    "marketErrorMsg": "Price changed to no seat"
}
Author：AeroHub  Create time：2023-07-10 16:14
Last editor：AeroHub  Update time：2025-10-28 15:50