国内机票接口文档-磐河旅行开放平台

接口地址： http://接口域名/flight/query

返回格式： json

请求方法： get

请求示例： http://接口域名/flight/query?appKey=您申请的APPKEY&fromCityCode=KRL&toCityCode=CTU&fromDate=2020-06-10&sign=17fb3f159a93cf6a5d0275565d1a0954

接口说明：

此接口可以通过指定航线、航班、出发日期、航空公司等条件查询，查询结果包括航班数据、库存、票面价、机建税、燃油费、结算价、返点返现政策等信息。

往返或联程查询通过两次单程查询实现即可！

请求参数：

参数名称	类型	必填	说明
fromCityCode	string	是	出发城市三字码或机场三字码
toCityCode	string	是	到达城市三字码或机场三字码
fromDate	string	是	出发日期(格式：yyyy-MM-dd 如：2020-10-01 )
cabinLevel	int	否	仓位类型(等级): 1=经济舱,2=公务舱,3=头等舱
airlineCode	string	否	航司二字代码,如： CZ （即南方航空）
flightNo	string	否	航班号，只查询指定航班号的航班
sign	string	是	签名校验值，md5(secretKey+fromCityCode+toCityCode+fromDate+secretKey) ，secretKey为请求密钥，开通账户时即可获得，加密结果转为32位小写。【注意：加密前的拼接原串不包含'+'】

返回参数：

参数名称	类型	说明
voyage	voyageInfo	航程信息
fromCityCode	string	出发城市三字码
toCityCode	string	到达城市三字码
fromCityName	string	出发城市名称
toCityName	string	到达城市名称
fromDate	string	出发日期格式：yyyy-MM-dd
flights	flightInfo[]	航程对应的航班信息
flightNo	string	航班号
airlineCompany	string	航空公司名称
airlineCode	string	航空公司二字码
airlineLogoUrl	string	航空公司 logo
fromAirportCode	string	出发机场三字码
toAirportCode	string	到达机场三字码
fromAirportName	string	出发机场名称
toAirportName	string	到达机场名称
isShareFlight	bool	是否为共享航班
realFlightNo	string	当为共享航班时，实际承运的航班号
fromDateTime	datetime	出发时间(格式：yyyy-MM-dd HH:mm:ss)
toDateTime	datetime	到达时间(格式：yyyy-MM-dd HH:mm:ss)
fromTerminal	string	出发航站楼，如：T1
toTerminal	string	到达航站楼，如：T2
flyDuration	string	飞行时长，格式HH:mm，如：03:05，表示飞行 3小时5分钟
adultTax	int	成人机建费
adultFuel	int	成人燃油税
childTax	int	儿童机建费
childFuel	int	儿童燃油税
babyTax	int	婴儿机建费
babyFuel	int	婴儿燃油税
stopNum	int	经停次数
craftType	string	机型，如：空客A320
meals	string	餐食情况（值：有餐食\|无餐食）
cabins	cabinInfo[]	航班舱位列表
cabinCode	string	舱位代码
cabinLevel	int	国内机票舱位等级(经济舱 =1 ,公务舱 = 2, 头等舱=3)
cabinName	string	舱位名称
seatLeftNum	int	舱位剩余座位数：1-10（备注：<10表示实际座位余数 10表示余票充足，泛指）
discount	double	折扣，如：0.29 表示29折
cabinBookPara	string	舱位下单参数，下单原样传入即可（备注：下单必传字段）
cabinPrice	CabinPriceInfo	舱位价格信息
adultFarePrice	int	成人票面价（即官网公布运价，行程单上的票面价）
adultSalePrice	float	成人销售价（不含税）,即贵司在平台的采购价
childFarePrice	int	儿童票面价（一般为成人所选舱等的全价票的50%）
childSalePrice	float	儿童销售价（不含税）
babyFarePrice	int	婴儿票面价（一般为成人所选舱等的全价票的10%）
babySalePrice	float	婴儿销售价（不含税）

JSON返回示例 :

{
  "data": {
    "voyage": {
      "fromCityCode": "KRL",
      "toCityCode": "CTU",
      "fromCityName": "库尔勒",
      "toCityName": "成都",
      "fromDate": "2020-06-10",
      "flights": [
        {
          "flightNo": "CZ6925",
          "airlineCompany": "南方航空",
          "airlineCode": "CZ",
           "airlineLogoUrl":"http://api.panhe.net/Content/Images/AirLineLogo/CZ.png",
          "fromAirportCode": "KRL",
          "toAirportCode": "CTU",
          "fromAirportName": "库尔勒",
          "toAirportName": "成都双流",
          "isShareFlight": false,
          "realFlightNo": null,
          "fromDateTime": "2020-06-10 09:40:00",
          "toDateTime": "2020-06-10 15:45:00",
          "fromTerminal": "--",
          "toTerminal": "T2",
          "flyDuration": "06:05",
          "adultTax": 50,
          "adultFuel": 0,
          "childTax": 0,
          "childFuel": 0,
          "babyTax": 0,
          "babyFuel": 0,
          "cabins": [
            {
              "cabinCode": "M",
              "cabinLevel": 1,
              "cabinName": "经济舱",
              "seatLeftNum": 10,
              "discount": 0.84,
              "cabinBookPara": "117BD92FEA4F0821324606EB5854A95B88DAE807DCFF74193A88B739B1FD885420038AE8EF89BC10A72B9A12EBD4E616F2B69D936EEAC20BE2D9C2B34B8DAB7F75D2A1BEAE88C5D853C2466C8CD698EACA33BBBFA2E24218A6FF167C726EB928EC95B30107D5B02C79E35E8426C9DD283852F21072BFBEC4267EE346A9C2F7CCDFAD9B24DA74E891F6A99213FF2C271B170C115209BC476727FCFD68902A3638A6D92DD3E204634838C8BC26BDE38BFC21CDC3FCB5BF39E6D33DF8FA2F1CEF0A22386762FCA4FD91CF3F10DFD853CC339619E5F2599E185DBC726C15FEBDB6D21892FDBEFA88420BECC2A1D6BB92C643114274DE1AAADC16119A6E889796A663B074510CC773C96B8DFB75D60EDC6A49D97EEC666AA36F296040F6950C3204B02C6B3E3F18F69E4192053803763F004681832ED7CF366D6EF7B33C2BCE43D7BB6400A90010850DC27A48CB3A987C7EC9703A8D34EC067267F671142CC223113F780FA8CE7F7F7B794904492DF96D3BC7F95DC3E66BE2A749EE508CDD3A5D42E0291FA8A1D97D904442992A88E70C34C84FEADE25719D55E2089FAAC37C1010592038805A63B29F46F7533DEC509E6CCE661D1F8C04C88556DFDAF286015EC0B654384544D2D54D49BDBB29E8F5B9480EB3E47AD9D2D7FF5141DE856698935C7E62E417A09ED465AE1B7498E24E9FA9DA7942E48E9DE3FF9216809DC4E53F9ADFEB4A70665E133C6391971DDB74F418B1",
              "cabinPrice": {
                "adultFarePrice": 2110,
                "adultSalePrice": 2097,
                "childFarePrice": 1260,
                "childSalePrice": 1266.0,
                "babyFarePrice": 260,
                "babySalePrice": 270.0,
                "cabinClassFullFarePrice": 0
              }
            },
            {
              "cabinCode": "S",
              "cabinLevel": 1,
              "cabinName": "特价舱位",
              "seatLeftNum": 6,
              "discount": 0.86,
              "cabinBookPara": "117BD92FEA4F0821324606EB5854A95B88DAE807DCFF74193A88B739B1FD885420038AE8EF89BC10A72B9A12EBD4E616F2B69D936EEAC20BE2D9C2B34B8DAB7F75D2A1BEAE88C5D853C2466C8CD698EACA33BBBFA2E24218A6FF167C726EB928EC95B30107D5B02C79E35E8426C9DD283852F21072BFBEC4267EE346A9C2F7CCDFAD9B24DA74E891F6A99213FF2C271B170C115209BC476727FCFD68902A3638A6D92DD3E204634838C8BC26BDE38BFC21CDC3FCB5BF39E6D33DF8FA2F1CEF0A22386762FCA4FD91CF3F10DFD853CC339619E5F2599E185DBC726C15FEBDB6D2AE802E29B8C496892AA06B48447600CE70C0154193BF4C8B959FBDEF4BDD2B575663F5D3AF7017FAC65060D4EA2071D4A939F6D142A1B9BBE9A5A1A6BD2487EC08565C20810DA1895DAB6A55835007C381648A3DF6CD6F6E9283CDA8606A63CCE02EF57ED8A5B678A23E8E3DAF7AEF5E57D447F670266B9B04A6A7E5792CD7C26D2FAEACEE623F90D32A1B39F383E55D27E3797174DE7874BF8E94EFD84A49A43DE7D03D4ACF252D35434BF65B318BE1A515B15BC65E59BACC97CD70F9A8C2C5A4ECE3DE9EEDF1EFAEFBE755EE95A46AAD09391ECDFEB5BE3D85B42C541134336E29183D5D3DF4F66CE226CA5B7FD830B8DD19D65522C7375527CFBA9134E155DA06D8554571E1FABB1CBAB865081455D379A7D3A06F9244F39DCF4564A943429F1A15D5AE4B790BBF5BB29D32EE0256",
              "cabinPrice": {
                "adultFarePrice": 2160,
                "adultSalePrice": 2151,
                "childFarePrice": 1260,
                "childSalePrice": 1266.0,
                "babyFarePrice": 260,
                "babySalePrice": 270.0,
                "cabinClassFullFarePrice": 0
              }
            },
            {
              "cabinCode": "Y",
              "cabinLevel": 1,
              "cabinName": "经济舱",
              "seatLeftNum": 10,
              "discount": 1.0,
              "cabinBookPara": "117BD92FEA4F0821324606EB5854A95B88DAE807DCFF74193A88B739B1FD885420038AE8EF89BC10A72B9A12EBD4E616F2B69D936EEAC20BE2D9C2B34B8DAB7F75D2A1BEAE88C5D853C2466C8CD698EACA33BBBFA2E24218A6FF167C726EB928EC95B30107D5B02C79E35E8426C9DD283852F21072BFBEC4267EE346A9C2F7CCDFAD9B24DA74E891F6A99213FF2C271B170C115209BC476727FCFD68902A3638A6D92DD3E204634838C8BC26BDE38BFC21CDC3FCB5BF39E6D33DF8FA2F1CEF0A22386762FCA4FD91CF3F10DFD853CC339619E5F2599E185DBC726C15FEBDB6D27B28D82CB1D7A047488A030326C4CAD941542CBA78EAF87F991634FC4A1681858804FED882F4D4DE7790D81A4274AAFEB6A581ECA2B4EEF41D3D799F785ED802DC0C519E099CDB97DFBA987619E782A073FE58C002F754517E15ED90F7303CBFF3317FE9285B109ED23567884869829731B4DCD8104BDFAEAA20349F9B445D9C3C1FA2616F23D66AC9702EA403FA102545F3898907B2B119E6754DD1FDC9EE1ADAC44B91E5C2B87B87A348A1BE237B714CED46C1B91E2739AEFCC224CC941CF62F8E98852C2AB186574FDC4597E6FC114682FE42C3A642817B5128B4545CC41CD458C6843F47C3063C93019D9D57FA702173241DCDFBBE9D1016AE6416505AD6785F466E437B08C916BF1F0C1D8AF472658465CDF6CDF2BDAE043CA3D17809C87250DC65EDFCE561FD729777C623EE2C",
              "cabinPrice": {
                "adultFarePrice": 2510,
                "adultSalePrice": 2494,
                "childFarePrice": 1260,
                "childSalePrice": 1266.0,
                "babyFarePrice": 260,
                "babySalePrice": 270.0,
                "cabinClassFullFarePrice": 0
              }
            },
            {
              "cabinCode": "C",
              "cabinLevel": 2,
              "cabinName": "特价舱位",
              "seatLeftNum": 4,
              "discount": 1.8,
              "cabinBookPara": "117BD92FEA4F0821324606EB5854A95B88DAE807DCFF74193A88B739B1FD885420038AE8EF89BC10A72B9A12EBD4E616F2B69D936EEAC20BE2D9C2B34B8DAB7F75D2A1BEAE88C5D853C2466C8CD698EACA33BBBFA2E24218A6FF167C726EB928EC95B30107D5B02C79E35E8426C9DD283852F21072BFBEC4267EE346A9C2F7CCDFAD9B24DA74E891F6A99213FF2C271B170C115209BC476727FCFD68902A3638A6D92DD3E204634838C8BC26BDE38BFC21CDC3FCB5BF39E6D33DF8FA2F1CEF0A22386762FCA4FD91CF3F10DFD853CC339619E5F2599E185DBC726C15FEBDB6D2912301FEE9235C9807509C8050C3CF1FC6FC3C481C79693F70F3299410EEF962F14751A3286C1CCF936CD35AE196BA767D10AD2BE74BE48B312E2BEEB404C2F921A20A280B615C9F17DEEB19914687B9BD0B84462C95C339D243D6F93D325C9416F7085EC6FA1860D2A84AECF2235560BDE5D64B295E9B14F23F122D146311FFC2473E5984C06253D1DD9A575ED40271F8BF02473924A1A153B2ACA4267B94538D94826016ECA6E81224FD1043688E348D059FE3E18C7C085FCD6040AD372C143CDB5AFD98EB011A8D6C436A572864CC48F9A280B2B0D19BB783B4E8472DE33F1D45236F053E402D4A1514C6C0308DCCAAF981ABAFB2711CF07CE9387593E0BF4DE851B7533C20C7B7270D442C4531C46520862AC65795BB5CDE5DB946119B301913FBB06FDE882E2007D4A2329B8A2B",
              "cabinPrice": {
                "adultFarePrice": 4520,
                "adultSalePrice": 4492,
                "childFarePrice": 2890,
                "childSalePrice": 2896.0,
                "babyFarePrice": 580,
                "babySalePrice": 590.0,
                "cabinClassFullFarePrice": 0
              }
            },
            {
              "cabinCode": "J",
              "cabinLevel": 2,
              "cabinName": "商务舱",
              "seatLeftNum": 8,
              "discount": 2.3,
              "cabinBookPara": "117BD92FEA4F0821324606EB5854A95B88DAE807DCFF74193A88B739B1FD885420038AE8EF89BC10A72B9A12EBD4E616F2B69D936EEAC20BE2D9C2B34B8DAB7F75D2A1BEAE88C5D853C2466C8CD698EACA33BBBFA2E24218A6FF167C726EB928EC95B30107D5B02C79E35E8426C9DD283852F21072BFBEC4267EE346A9C2F7CCDFAD9B24DA74E891F6A99213FF2C271B170C115209BC476727FCFD68902A3638A6D92DD3E204634838C8BC26BDE38BFC21CDC3FCB5BF39E6D33DF8FA2F1CEF0A22386762FCA4FD91CF3F10DFD853CC339619E5F2599E185DBC726C15FEBDB6D21D18CF6E6435F33514754BD16C4670A6998A6BBE6A7CC2A4FBAD923B21FE5D2F400F6E952E0CD17FD4FB1B690AA7780FA3D5CCC1A550D1216F942494AD286701C17DBFECDA0614E1153451500D4BC61782EFB5857EE3EEE768DE3F89A80503DB81314E39D934090031666C8FE9FCBD9D68061CE8A231160CEB631CE3C95FFEC0D40C9BA64058615BD386FE6D8F0315C67978EC509BF7E47CBA2698C9F174C17B6F2688DFDABA28C6A84E350B04DCC8B7008102898EC8BDC9C33B516CA263C03B0F5E8FB193B756107B1AB50B87DCDB3517725A566A21F922718E53388130A22C61225F612D0E0472CD6843F2C3E42A2F86114BD5A7263A90784EBB4E30DA4561B0C0D7DC2DDF61A29F96CA1175C806448BD838D1AFB89D6D731F1CB4A75B9BA596BF5F0E7F89A0F9",
              "cabinPrice": {
                "adultFarePrice": 5770,
                "adultSalePrice": 5735,
                "childFarePrice": 2890,
                "childSalePrice": 2896.0,
                "babyFarePrice": 580,
                "babySalePrice": 590.0,
                "cabinClassFullFarePrice": 0
              }
            }
          ],
          "yCabinLevelFullPrice": 2510,
          "cCabinLevelFullPrice": 5770,
          "fCabinLevelFullPrice": null,
          "stopNum": 1,
          "craftType": "波音738"
        }
      ]
    }
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/flight/checkCabinAndPrice

返回格式： json

请求方法： post

接口说明：

此接口用于验证是否有位置，价格是否正确。一般在提交订单和支付前进行舱位检查

请求参数：

参数名称	类型	必填	说明
fromAirportCode	string	是	出发机场三字码
toAirportCode	string	是	到达机场三字码
flightNo	string	是	航班号
cabinCode	string	是	舱位代码
fromDateTime	string	是	出发时间(格式：yyyy-MM-dd HH:mm)
adultFarePrice	int	是	成人票面价（只需验成人票面价格），PS：是成人票面价不要传成成人销售价了
cabinLevel	int	否	舱位等级(经济舱 =1 , 公务舱 = 2, 头等舱=3)
toDateTime	string	否	到达时间(格式：yyyy-MM-dd HH:mm)
cabinBookPara	string	是	舱位下单参数，航班查询接口中舱位信息里返回的cabinBookPara字段值（跟在url后传参的需要utf8 urlencode ; 放在请求体里不需要）

返回参数：

参数名称	类型	说明
isCanBook	bool	是否可以预订（返回false表示价格发生变动了或者没票了，需引导用户重新查询预订）
newFare	int	新票面价（可能为空，表示没有获取到该舱位的票面价格，如此舱位已经没有余票了）

JSON请求示例 :

{
  "adultFarePrice": 360 ,
  "appKey": "您申请的APPKEY",
  "cabinBookPara": "H4sIAAAAAAAEAKtWKkmsULIyNdBRSitNzVGyAjLySnOVrAyBjGQfIA2k/JSslJ537nyye/uLjo1P9vYq6SilZBYD1eoZ6SgVFGUmpypZVSslphUoWRmbAfUlFoNYpqZ6IDNAopYg05JALENLg1qgHs8UoJGGuiYm5qbGlsZGurpAIwtCgGJOwQEgppuSlQncHEM9EyAntaIApEepFgDs6jA3swAAAA==",
  "cabinCode": "R",
  "cabinLevel": 1,
  "flightNo": "CZ8714",
  "fromAirportCode": "HGH",
  "fromDateTime": "2021-10-19 21:50",
  "toAirportCode": "SZX",
  "toDateTime": "2021-10-20 00:05"
}

JSON返回示例 :

{
    "data": {
        "isCanBook": false,
        "newFare": 240.0
    },
    "success": true,
    "msg": "请求成功"
}

接口地址： http://接口域名/flight/getAllAirPort

返回格式： json

请求方法： get

请求示例： http://接口域名/flight/getAllAirPort?appKey=您申请的APPKEY

接口说明：

该接口用于获取全球所有国家机场城市信息，实际使用中，调用一次保存本地即可。PS: 静态数据，切勿实时调用该接口，每天最多请求10次。(可半年或1年手动更新1次，基本无更新...)

请求参数：

参数名称	类型	必填	说明

返回参数：

参数名称	类型	说明
airportName	string	机场名称（非空）
airportShortName	string	机场简称（可能为空）
airportCode	string	机场三字码
cityName	string	城市名称
cityCode	string	城市三字码
cityPinYin	string	城市拼音
cityShortChar	string	城市拼音简称
countryName	string	所属国家名称
countryCode	string	所属国家代码
continent	int	所属洲
isInternal	bool	是否国内（大陆）机场城市

JSON返回示例 :

{
  "data": [
    {
      "airportName": "合肥新桥国际机场",
      "airportShortName": "合肥新桥",
      "airportCode": "HFE",
      "cityName": "合肥",
      "cityCode": "HFE",
      "cityPinYin": "HeFei",
      "cityShortChar": "HF",
      "countryName": "中国",
      "countryCode": "CN",
      "continent": "1",
      "isInternal": true
    },
    {
      "airportName": "香格里拉迪庆机场",
      "airportShortName": null,
      "airportCode": "DIG",
      "cityName": "迪庆",
      "cityCode": "DIG",
      "cityPinYin": "diqing",
      "cityShortChar": "DQ",
      "countryName": "中国",
      "countryCode": "CN",
      "continent": "1",
      "isInternal": true
    }
  ],
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/flight/getRefundAndChangeRules

返回格式： json

请求方法： get/post

接口说明：

行李额和退改签规则，是磐河通过各大航司官网公布的行李运输规则和退改签规则整理而来，固正确率没有办法保证100%，请对接商户知悉，如有差异请以航司为准。

如商户对接了该接口则表示商户已知悉并同意：行李额和退改签规则数据仅供参考，因为显示错误，磐河不承担任何损失。

商户在终端展示给用户时，切记提示用户：数据仅供参考，具体以航司审核为准。

请求参数：

参数名称	类型	必填	说明
appKey	string	是	接口账号appKey
isGetBaggageAllowance	bool	是	是否获取行李额规则（默认：false 不需要获取，则相应参数中baggageAllowance就会null，当只需要获取退改签规则时传false可以提高请求速度）
fromAirportCode	string	是	出发机场三字码（必传）
toAirportCode	string	是	到达机场三字码（必传）
fromDate	string	是	出发日期时间（精确到分钟，格式：yyyy-MM-dd HH:mm）（必传）
flightNo	string	是	航班号或航司代码,建议传航班号，更准确（必传）
cabinCode	string	是	舱位代码（必传）
cabinLevel	int	是	舱位等级(经济舱 =1 ,公务舱 = 2, 头等舱=3)（必传）
adultFarePrice	int	否	成人票面价(可为空，传值时系统根据退票和改签费率自动计算出退票费改签费，也可自行计算)
childFarePrice	int	否	儿童票面价(可为空，传值时系统根据退票和改签费率自动计算出退票费改签费，也可自行计算)
babyFarePrice	int	否	婴儿票面价(可为空，传值时系统根据退票和改签费率自动计算出退票费改签费，也可自行计算)

返回参数：

参数名称	类型	说明
baggageAllowance	BaggageAllowanceRules	行李额规定(可能为null，当isGetBaggageAllowance传false或未匹配到时就会返回null)
refundAndChangeRegulations	RefundAndChangeRule	退改签规定(可能为null，当未匹配到时就会返回null)
handLuggage	BaggageAllowanceRule	手提行李（baggageAllowance节点下的字段）
checkedBaggage	BaggageAllowanceRule	托运行李（baggageAllowance节点下的字段）
totalFreeWeight	decimal	总的免费行李（BaggageAllowanceRule类型的属性字段）
freeWeight	decimal	免费行李额重量，单位KG(当限制件数有值时，此值为每件的重量) （BaggageAllowanceRule类型的属性）
freeCountLimit	int	件数限制，null表示不限件数（BaggageAllowanceRule类型里的属性字段）
showText	string	前端可显示的文本（BaggageAllowanceRule类型的里属性字段）
volumeLength	int	体积限制_长(cm)（BaggageAllowanceRule类型里的属性字段）
volumeWidth	int	体积限制_宽(cm)（BaggageAllowanceRule类型里的属性字段）
volumeHigh	int	体积限制_高(cm)（BaggageAllowanceRule类型里的属性字段）
refundFile	string	退票规定内容,具体的退票客规文本(refundAndChangeRegulations 节点下的字段，可能为空)
changeFile	string	改签规定内容,具体的改签客规文本(refundAndChangeRegulations 节点下的字段，可能为空)
rules	RefundAndChangeRuleItem[]	规定分解，仅供参考 (refundAndChangeRegulations 节点下的字段，可能为空)
currentRule	RefundAndChangeRuleItem	当前阶段的客规（冗余数据）
isCurrent	bool	true表示，当前阶段（RefundAndChangeRuleItem类型里的属性字段）
refundRate	decimal	退票费率，如20%，等于0.2，25%等于0.25（RefundAndChangeRuleItem类型里的属性字段）
adultRefundAmount	decimal	成人退票费金额（当传了成人票面时才会有值，也可以自行根据成人票面*退票费率计算）（RefundAndChangeRuleItem类型里的属性字段）
childRefundAmount	decimal	儿童退票费金额（当传了儿童票面时才会有值，也可以自行根据儿童票面*退票费率计算）（RefundAndChangeRuleItem类型里的属性字段）
babyRefundAmount	decimal	婴儿退票费金额（当传了婴儿票面时才会有值，也可以自行根据婴儿票面*退票费率计算）（RefundAndChangeRuleItem类型里的属性字段）
changeRate	decimal	改签费率，如20%，等于0.2，25%等于0.25
adultChangeAmount	decimal	成人改签费金额（当传了成人票面时才会有值，也可以自行根据成人票面*改签费率计算）（RefundAndChangeRuleItem类型里的属性字段）
childChangeAmount	decimal	儿童改签费金额（当传了儿童票面时才会有值，也可以自行根据儿童票面*改签费率计算）（RefundAndChangeRuleItem类型里的属性字段）
babyChangeAmount	decimal	婴儿改签费金额（当传了婴儿票面时才会有值，也可以自行根据婴儿票面*改签费率计算）（RefundAndChangeRuleItem类型里的属性字段）
timeNode	string	退改时间节点，如：2023年12月18日11:15前， 2023年12月18日11:15后
minTime	datetime	该时间段的开始时间(可能为空，比如第一段))
maxTime	datetime	该时间段的结束时间(可能为空，比如最后一段)
isPastTime	bool	是否过去时间段

JSON请求示例 :

{
  "appKey": "您申请的APPKEY",
  "isGetBaggageAllowance": true,
  "fromAirportCode": "HET",
  "toAirportCode": "KHN",
  "fromDate": "2024-03-04 10:10",
  "flightNo": "CA8195",
  "cabinCode": "S",
  "cabinLevel": 1,
  "adultFarePrice": 670
}

JSON返回示例 :

{
  "data": {
    "baggageAllowance": {
      "handLuggage": {
        "type": 1,
        "typeName": "手提",
        "totalFreeWeight": 5.0,
        "freeWeight": 5.0,
        "freeCountLimit": 1,
        "showText": "每人1件,每件5.0KG",
        "volumeLength": 55,
        "volumeWidth": 40,
        "volumeHigh": 20
      },
      "checkedBaggage": {
        "type": 2,
        "typeName": "托运",
        "totalFreeWeight": 20.0,
        "freeWeight": 20.0,
        "freeCountLimit": null,
        "showText": "每人20.0KG ,件数不限",
        "volumeLength": 100,
        "volumeWidth": 60,
        "volumeHigh": 40
      }
    },
    "refundAndChangeRegulations": {
      "refundFile": "取消座位时间计算手续费;按照当前舱位票面价收取退票费;起飞前7天（含）以外收取当前舱位票面价的20.0%退票费,起飞前7天(不含)内到2天（含）收取当前舱位票面价的30.0%退票费,起飞前2天(不含)内到4小时（含）收取当前舱位票面价的65.0%退票费,起飞前4小时以内收取当前舱位票面价的70.0%退票费;",
      "changeFile": null,
      "rules": [
        {
          "isCurrent": false,
          "refundRate": 0.2,
          "adultRefundAmount": 134.0,
          "childRefundAmount": null,
          "babyRefundAmount": null,
          "changeRate": 0.1,
          "adultChangeAmount": 67.0,
          "childChangeAmount": null,
          "babyChangeAmount": null,
          "timeNode": "2024-02-26 10:10前",
          "minTime": null,
          "maxTime": "2024-02-26 10:10:00",
          "isPastTime": true
        },
        {
          "isCurrent": true,
          "refundRate": 0.3,
          "adultRefundAmount": 201.0,
          "childRefundAmount": null,
          "babyRefundAmount": null,
          "changeRate": 0.2,
          "adultChangeAmount": 134.0,
          "childChangeAmount": null,
          "babyChangeAmount": null,
          "timeNode": "2024-03-02 10:10前",
          "minTime": "2024-02-26 10:10:00",
          "maxTime": "2024-03-02 10:10:00",
          "isPastTime": false
        },
        {
          "isCurrent": false,
          "refundRate": 0.65,
          "adultRefundAmount": 436.0,
          "childRefundAmount": null,
          "babyRefundAmount": null,
          "changeRate": 0.45,
          "adultChangeAmount": 302.0,
          "childChangeAmount": null,
          "babyChangeAmount": null,
          "timeNode": "2024-03-04 06:10前",
          "minTime": "2024-03-02 10:10:00",
          "maxTime": "2024-03-04 06:10:00",
          "isPastTime": false
        },
        {
          "isCurrent": false,
          "refundRate": 0.7,
          "adultRefundAmount": 469.0,
          "childRefundAmount": null,
          "babyRefundAmount": null,
          "changeRate": 0.55,
          "adultChangeAmount": 369.0,
          "childChangeAmount": null,
          "babyChangeAmount": null,
          "timeNode": "2024-03-04 06:10后",
          "minTime": "2024-03-04 06:10:00",
          "maxTime": null,
          "isPastTime": false
        }
      ],
      "currentRule": {
        "isCurrent": true,
        "refundRate": 0.3,
        "adultRefundAmount": 201.0,
        "childRefundAmount": null,
        "babyRefundAmount": null,
        "changeRate": 0.2,
        "adultChangeAmount": 134.0,
        "childChangeAmount": null,
        "babyChangeAmount": null,
        "timeNode": "2024-03-02 10:10前",
        "minTime": "2024-02-26 10:10:00",
        "maxTime": "2024-03-02 10:10:00",
        "isPastTime": false
      }
    }
  },
  "success": true,
  "msg": "请求成功"
}

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

返回格式： json

请求方法： post

接口说明：

下单流程图.png

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

由于航班舱位价格及余票变动频繁，下单成功后请及时支付。30分钟未支付订单将自动取消。

请求参数：

参数名称	类型	必填	说明
customerOrderNo	string	是	商户订单号（即你们自己平台的本地订单号，用于双方订单关联映射。单号值必须唯一，否则会被系统判定为重复下单进行拦截）
flightRangeType	int	是	航程类型：单程 = 0, 往返 = 1
isApplyReimbursement	bool	是	是否申请报销凭证(true表示申请，报销凭证将于航班起飞后打印邮寄)
receivingInformation	ReceivingInformation	否	当需要报销凭证时，必传的快递收件信息
name	string	否	快递收件人姓名，父节点 receivingInformation
mobile	string	否	快递收件人手机号，父节点 receivingInformation
province	string	否	收件地址所在省份，父节点 receivingInformation
city	string	否	收件地址所在城市，父节点 receivingInformation
area	string	否	收件地址所在区/县，父节点 receivingInformation
detailAddress	string	否	收件地址具体位置（街道位置），父节点 receivingInformation
email	string	否	邮箱，用于接受电子发票，父节点 receivingInformation
callBackUrl	string	是	订单状态异步回调地址，回调详见:订单状态推送通知说明
orderAmount	float	否	磐河机票订单总金额（商户需要支付的该单采购成本），传值服务端就会校验，不传值服务端就会自己计算订单总金额并返回。计算方法：所有人总票价（包括机建、燃油）+行程单打印邮寄费（isApplyReimbursement=true时才有该费用）。单人总票价=单人磐河销售价(以SalePrice结尾的价格，如成人：adultSalePrice)+机建费+燃油费。行程单打印邮寄费 = 25元（快递费）+2元(每人行程单代打印服务费)*订单人数
contactName	string	是	订单联系人
contactMobile	string	是	联系人手机号
flights	FlightInfo[]	是	航班信息
flightNo	string	是	航班号
fromAirportCode	string	是	出发机场三字码
toAirportCode	string	是	到达机场三字码
fromDateTime	datetime	是	出发日期时间（精确到分钟，如:2020-04-26 12:20）
toDateTime	datetime	是	到达日期时间（精确到分钟，如:2020-04-26 15:55）
fromTerminal	string	是	出发航站楼（航班查询时，有返回就填写，没有就填写空字符串）
toTerminal	string	是	到达航站楼（航班查询时，有返回就填写，没有就填写空字符串）
isShareFlight	bool	是	是否为共享航班
realFlightNo	string	是	为共享航班时，实际承运航班号
cabinCode	string	是	舱位（代码）
cabinBookParms	string	是	舱位预订下单请求参数，用航班查询接口中返回的cabinBookPara字段值，原样传入即可
passengers	PassengerInfo[]	是	乘客信息
name	string	是	乘客姓名(注意事项：1.乘客姓名需与登机所持证件上的名字一致；2.姓名中含特殊符号“··”“_”等，可不用输入；3.英文名的姓和名必须用'/'分隔开，格式为：姓/名，如(刘德华)英文名：liu/dehua; 4.生僻字可用拼音代替，例如：“王鬳”可输入为“王yan”)
ticketType	int	是	乘客类型:成人票 = 1,儿童票 = 2,婴儿票 = 3 (ps:航班起飞日期算起，>12岁（含）成人；2岁（含）~12岁（不含）为儿童；14天（含）~2岁（不含）以下为婴儿 )
cardType	int	是	证件类型( 身份证 = 1,护照 = 2, 回乡证 = 3 , 台胞证 = 4 ,军人证 = 7 , 外国人永久居留身份证 = 8 ,港澳台居民居住证 = 9 , 户口簿= 10 , 出生证明= 11)
cardNo	string	是	证件号码
birthday	date	是	出生日期(当证件类型为身份证时，出生日期可以为空；非身份证时，出生日期必填，切记。)
cardValidEndDate	date	否	证件有效期，格式：yyyy-MM-dd，不能小于起飞日期（当证件类型是以下类型时，证件有效期必填，否则下单会失败：护照 = 2, 回乡证 = 3 , 台胞证 = 4 ,军人证 = 7 , 外国人永久居留身份证 = 8 ,港澳台居民居住证 = 9）
nationalityCode	string	否	国籍（国家/地区）二字码，示例：中国传：CN、美国传：US ，法国传：FR。。。，二字码数据字典请联系平台获取（当证件类型是以下类型时，国籍必填，否则下单会失败：护照 = 2,外国人永久居留身份证 = 8，出生证明= 11）
sex	int	否	性别：男 = 1 , 女 = 2（当证件类型是以下类型时，性别必填，否则下单会失败：护照 = 2, 回乡证 = 3 , 台胞证 = 4 ,军人证 = 7 , 外国人永久居留身份证 = 8 ,港澳台居民居住证 = 9 , 出生证明= 11）
mobile	string	是	乘客手机号

返回参数：

参数名称	类型	说明
orderNo	string	国内机票订单号
orderAmount	float	订单总金额
pnr	string	编码（可能为空）

JSON请求示例 :

{
  "appKey": "您申请的APPKEY",
  "customerOrderNo": "1804257654",
  "flightRangeType": 0,
  "isApplyReimbursement": true,
  "receivingInformation": {
    "name": "张飞",
    "mobile": "13912341234",
    "province": "上海市",
    "city": "上海市",
    "area": "浦东新区",
    "detailAddress": "朝阳路23号新丰广场1号楼2015室",
    "email": "123@qq.com"
  },
  "contactName": "李伟",
  "contactMobile": "18754683215",
  "callBackUrl": "订单状态异步回调地址",
  "flights": [
    {
      "flightNo": "CZ6754",
      "fromAirportCode": "PVG",
      "toAirportCode": "SYX",
      "fromDateTime": "2020-06-10 12:45",
      "toDateTime": "2020-06-10 16:15",
      "fromTerminal": "T2",
      "toTerminal": "T1",
      "isShareFlight": false,
      "realFlightNo": null,
      "cabinCode": "A",
      "cabinBookParms": "BF216356179765BE8FF5064BFCBA9DBD41A5D1357837CA9048AA4D986CF8D868279424D90C3324CBF9BA1FFD2B7923D77C64836E84037DAE203E807BD7BF5184128DA9A74913A9529A8FF9A36E7AFDEE5578C98E2BCFF6E1CCBBA91889250A8C881528581C8893C35E47BA98EE3C70B822C8C684308A523B413FAB15BB303D831CC1189B350C62B56F74201924EC1186701F55191C8BB1FE1CB2EDE6905B05C58519614159FC6CF5526FB496648A8840033E1A5248E421B27DD661B4875061ACBD8F51151D7268F4685F31E69B2F22D1E89085F5D8AAEE3059FA4086FB999693C8DFBF67A90406B61A389D38C414C4A698FBF25970A0CD6CFA6EE198854656D04A1132C91079AFF5C78982A6675D482582FF0D849E1E094B587F81B90FECC5B87B12AC44E0FF0C4DCD84446EA5C1E7D4873F8C2E2531F231D5D35BC849533B1D2E3D69C0F596BFA860564FB521521C0E3E33DCC83D716409E7614EA3705ECB63392054CF0A97C310"
    }
  ],
  "passengers": [
    {
      "name": "王洋",
      "cardType": 1,
      "cardNo": "330227********5368",
      "mobile": "18956251378",
      "birthday": "1870-10-25",
      "ticketType": 1
    },
    {
      "name": "周杰",
      "cardType": 1,
      "cardNo": "150423********0028",
      "mobile": "18247568923",
      "birthday": "1876-03-16",
      "ticketType": 1
    }
  ]
}

JSON返回示例 :

{
  "data": {
    "orderNo": "2020060522483288143360",
    "orderAmount":3398 ,
    "pnr": null
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/flight/autoPay

返回格式： json

请求方法： post

请求示例： http://接口域名/flight/autoPay?appKey=您申请的APPKEY&orderNo=2020061120354733935090&payAmount=3398&paymentType=1&sign=17fb3f159a93cf6a5d0275565d1a0954

接口说明：

确认出票，自动支付代扣接口。目前仅支持钱包代扣，必须保证钱包余额够支付本次订单才能代扣成功。支付成功不等于出票成功，具体出票结果会异步回调通知，以订单状态为准。

请求参数：

参数名称	类型	必填	说明
orderNo	string	是	订单号
payAmount	float	否	订单支付金额（可为null ,传值时将和订单金额进行比对。传值时就参与签名，为null时不参与签名）
paymentType	int	是	1商旅钱包代扣 2企业支付宝代扣（目前只支持1钱包代扣）
sign	string	是	签名校验值，md5(secretKey+orderNo+payAmount+secretKey)，secretKey为请求密钥，开通账户时即可获得，加密结果转为32位小写。【注意：加密前的拼接原串不包含'+'】

返回参数：

参数名称	类型	说明
success	bool	true表示代扣支付成功；false表示代扣失败,msg为失败原因。

JSON返回示例 :

{
    "data": true,
    "success": true,
    "msg": "请求成功"
}

接口地址： http://接口域名/flight/getOrderDetail

返回格式： json

请求方法： get

请求示例： http://接口域名/flight/getOrderDetail?appKey=您申请的APPKEY&orderNo=2020042123265292071192

请求参数：

参数名称	类型	必填	说明
orderNo	string	是	国内机票订单号

返回参数：

参数名称	类型	说明
orderNo	string	订单号
customerOrderNo	string	商户订单号
orderAmount	decimal	订单总金额（即订单应支付金额）
insuranceAmount	decimal	订单保险金额（购保了才有值，未够保为0）
ticketSaleAmount	decimal	订单机票（不含保险和其他增值服务部分）销售总金额( 等于每位乘客的机票销售总额之和，单人机票销售总额 = 销售价 + 机建 + 燃油 + 手续费 )
itineraryApplyOrderAmount	decimal	申请报销凭证所需费用(含快递费和打印服务费)
flightRangeType	int	航程类型：单程 = 0, 往返 = 1
orderStatus	int	国内机票订单状态（新订单待支付 = 1 ,已支付待出票 = 2,出票中 = 3 ,已出票 = 4 ,不能出票待退款 = 5 ,不能出票退款中 = 6 ,不能出票已退款 = 7,已取消 = 99）
orderStatusName	string	订单状态名称（和orderStatus 一一对应，如：出票中）
payStatus	int	支付状态（0未支付 1已支付）
payTime	string	支付时间，支付成功才有值（格式：yyyy-MM-dd HH:mm:ss）
ticketTime	string	出票成功时间，出票成功才有值（格式：yyyy-MM-dd HH:mm:ss）
pnr	string	PNR编码
isHasRefundOrder	bool	是否有退票单（true有，false无）
isHasChangeOrder	bool	是否有改签单（true有，false无）
payLimitTime	string	支付时限，下单后有30分钟支付时限，必须在此时间前发起支付出票，超过这个时间订单将自动取消（格式：yyyy-MM-dd HH:mm:ss）
contactName	string	订单联系人
contactMobile	string	联系人手机号
unFinishedReason	string	订单未完成出票原因（比如超时未支付自动取消，余票不足，乘客信息有误等，通过此字段可以得到出票失败原因）
createTime	string	下单时间
flights	FlightInfo[]	订单航班信息（数组，单程长度为1，往返或联程长度为2）
flightID	int	航段ID（订单航段的系统唯一标识，无实际含义）
flightNo	string	航班号
fromAirportCode	string	出发机场三字码
toAirportCode	string	到达机场三字码
fromAirportName	string	出发机场名称
toAirportName	string	到达机场名称
fromCityName	string	出门城市名称
toCityName	string	到达城市名称
fromDateTime	string	出发时间(格式：yyyy-MM-dd HH:mm:ss)
toDateTime	string	到达时间(格式：yyyy-MM-dd HH:mm:ss)
flyDuration	string	飞行时长，格式HH:mm，如：3:05，表示飞行 3小时5分钟
fromTerminal	string	出发航站楼，如：T1
toTerminal	string	到达航站楼，如：T2
airlineCode	string	航司二字码（即航班号的前两个字符），如：CZ
airlineCompany	string	航空公司名称，如：南方航空
craftType	string	机型
cabinCode	string	舱位代码
cabinName	string	舱位名称
cabinLevel	int	舱等级别(经济舱 =1 ,公务舱 = 2, 头等舱=3)
discount	float	折扣，如：0.29 表示29折
passengers	PassengerInfo[]	订单乘客信息（数组）
psgID	int	乘客ID（订单乘客唯一标识）
name	string	乘客姓名
cardType	int	证件类型( 身份证 = 1,护照 = 2, 回乡证 = 3 , 台胞证 = 4 ,军人证 = 7 , 外国人永久居留身份证 = 8 ,港澳台居民居住证 = 9 , 户口簿= 10 , 出生证明= 11)
cardTypeName	string	证件类型名称，如：身份证（和证件类型值一一对应）
cardNo	string	证件号
birthday	date	乘客出生日期
ticketType	int	乘客类型:成人票 = 1,儿童票 = 2,婴儿票 = 3 (ps:航班起飞日期算起，>12岁（含）成人；2岁（含）~12岁（不含）为儿童；14天（含）~2岁（不含）以下为婴儿 )
ticketTypeName	string	乘客类型名称，如：成人票（和乘客类型值一一对应）
mobile	string	乘客手机号
ticketNo	string	票号，出票成功才有值（当往返或联程有多个票号时以英文逗号分隔）
farePrice	int	票面价(往返或联程时为两段总的票面价)
salePrice	float	销售价,不含税(即机票实际销售价，往返或联程时为两段总的销售价)
tax	int	机建费(往返或联程时为两段总的机建费)
oil	int	燃油费(往返或联程时为两段总的燃油费)
psgStatus	int	乘客状态（未出票 = 0,已出票 = 1,退票中 = 11,不能退票 = 12,已退票 = 13, 改签中 = 21,不能改签 = 22,改签完成 = 23）
psgStatusName	string	乘客状态名称（和乘客状态值一一对应）

JSON返回示例 :

{
  "data": {
    "orderNo": "2020060522483288143360",
    "customerOrderNo": "1804257654",
    "orderAmount": 3398.00,
    "insuranceAmount": 0.00,
    "flightRangeType": 0,
    "orderStatus": 3,
    "orderStatusName": "出票中",
    "payStatus": 1,
    "payTime": "2020-06-06 00:04:04",
    "ticketTime": null,
    "pnr": null,
    "isHasRefundOrder": false,
    "isHasChangeOrder": false,
    "payLimitTime": "2020-06-06 00:20:00",
    "contactName": "李伟",
    "contactMobile": "18754683215",
    "flights": [
      {
        "flightID": 8,
        "flightNo": "CZ6754",
        "fromAirportCode": "PVG",
        "toAirportCode": "SYX",
        "fromAirportName": "上海浦东",
        "toAirportName": "三亚凤凰",
        "fromCityName": "上海",
        "toCityName": "三亚",
        "fromDateTime": "2020-06-10 12:45:00",
        "toDateTime": "2020-06-10 16:15:00",
        "flyDuration": "03:30",
        "fromTerminal": "T2",
        "toTerminal": "T1",
        "airlineCode": "CZ",
        "airlineCompany": "南方航空",
        "craftType": null,
        "cabinCode": "A",
        "cabinName": "经济舱",
        "cabinLevel": 1,
        "cabinLevelName": "经济舱",
        "discount": 0.69
      }
    ],
    "passengers": [
      {
        "psgID": 10,
        "name": "王洋",
        "cardType": 1,
        "cardTypeName": "身份证",
        "cardNo": "330227********5368",
        "birthday": "1870-10-25 00:00:00",
        "ticketType": 1,
        "ticketTypeName": "成人票",
        "mobile": "18956251378",
        "ticketNumber": null,
        "farePrice": 1650,
        "salePrice": 1649.00,
        "tax": 50,
        "oil": 0,
        "psgStatus": 0,
        "psgStatusName": "正常"
      },
      {
        "psgID": 11,
        "name": "周杰",
        "cardType": 1,
        "cardTypeName": "身份证",
        "cardNo": "150423********0028",
        "birthday": "1876-03-16 00:00:00",
        "ticketType": 1,
        "ticketTypeName": "成人票",
        "mobile": "18247568923",
        "ticketNumber": null,
        "farePrice": 1650,
        "salePrice": 1649.00,
        "tax": 50,
        "oil": 0,
        "psgStatus": 0,
        "psgStatusName": "正常"
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/flight/cancelOrder

返回格式： json

请求方法： get/post

请求示例： http://接口域名/flight/cancelOrder?appKey=您申请的APPKEY&orderNo=2020042123265292071192

接口说明：

只有新订单待支付状态下的订单才允许取消操作，因为该接口响应参数同步返回取消结果，所以取消结果成功与否不再有(也无需)异步回调通知。

（PS:逾期[超过支付时限，目前为下单后30分钟内]未支付的订单，系统将自动取消，这种由于是系统异步取消的，会有回调通知的。）

请求参数：

参数名称	类型	必填	说明
orderNo	string	是	国内机票订单号

返回参数：

参数名称	类型	说明
success	bool	true表示取消成功；false表示取消失败（msg为取消失败原因）

JSON返回示例 :

//取消成功返回：
{
    "data": true,
    "success": true,
    "msg": "请求成功"
}

//取消失败返回：
{
  "data": null,
  "success": false,
  "msg": "只有新订单才允许取消,当前订单状态为:出票中"
}

接口地址： http://接口域名/flight/applyRefundTicket

返回格式： json

请求方法： post

请求示例： http://接口域名/flight/applyRefundTicket?appKey=您申请的APPKEY&orderNo=2020060522483288143360&refundFlightNos=CZ6754&refundPsgNames=王洋|周杰&refundType=1&refundReason=我要改变行程计划、我不想飞了&callBackUrl=退票结果通知地址

接口说明：

此接口同步返回退票申请结果，success=true仅代表退票申请成功。退票申请成功不等于退票成功，具体退票结果会异步回调通知，以订单状态为准。（可以申请退票的乘客状态（字段PsgStatus值）有：已出票=1,不能退票=12,不能改签 = 22,改签完成=23）

请求参数：

参数名称	类型	必填	说明
orderNo	string	是	国内机票订单号
refundFlightNos	string	是	退票航班号，多个航段用'\|'分割（重要说明：1、往返或联程时，只允许两段一起退或者只退后段，不能只退第一段。2、不管有没改签过，退票只传原订单的航班号，不要传改签后的航班号）
refundPsgNames	string	是	退票乘客姓名，多个航段用'\|'分割，如：张三\|李四（重要说明：只有乘客状态为以下值时才能申请退票：已出票 = 1,不能退票 = 12 ,不能改签 = 22, 改签完成 = 23 。乘客状态值在订单详情接口里有返回）
refundType	int	是	退票类型：1=自愿退票，10=非自愿退票（说明：自愿退票:是指旅客因其自身原因要求变更客票，非自愿退票:是指因航班取消、延误、提前、航程改变、舱位等级变更或者承运人无法运行原航班等情形，导致旅客变更客票的情形。）
refundReason	string	是	退票原因（填写退票原因：如：航班延误，病退等原因，退票必传）
involuntaryProveUrls	string	否	非自愿退票证明文件地址（多个文件用'\|'分割，支持的文件类型有：pdf/jpg/jpeg/png），自愿退票无需填写
callBackUrl	string	是	退票结果异步通知地址，回调详见:订单状态推送通知说明

返回参数：

参数名称	类型	说明
data	string	国内机票退票单号

JSON返回示例 :

//申请失败返回示例
{
  "data": null,
  "success": false,
  "msg": "国内机票订单“2020060522483288143360”尚未出票，不能退票"
}

//申请成功返回示例
{
  "data": "2020060522483288143360T1173",
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/flight/getRefundOrderDetail

返回格式： json

请求方法： get

请求示例： http://接口域名/flight/getRefundOrderDetail?appKey=您申请的APPKEY&refundNo=20200605224832881433601173

请求参数：

参数名称	类型	必填	说明
orderNo	string	是	国内机票订单号（订单号和退票单号至少传一个，只传订单号时获取当前订单下所有退票单）
refundNo	string	是	国内机票退票单号（退票单号和订单号至少传一个，当传入退票单号时只获取退票单号对应的退票单）

返回参数：

参数名称	类型	说明
refundOrders	RefundOrder[]	退票单列表（数组，只传订单号时返回该订单下所有退票单信息，传退票单号时只获取某一具体退票单）
refundNo	string	国内机票退票单号
orderNo	string	国内机票订单号
refundPsgNames	string	退票乘客姓名，多个用'\|'分割
refundFlightNos	string	退票航班号，多个用'\|'分割
refundOrderStatus	int	退票单状态值（新申请待平台审核 = 11,提交到供应审核 = 12,审核不通过交易结束 = 13,审核通过等待退款 = 14, 退款中 = 15 , 已退款交易结束 = 16）
refundOrderStatusName	string	退票单状态名称（和refundOrderStatus一一对应，如：已退款交易结束）
refundType	int	退票类型值( 1自愿 10非自愿 20退差价)
refundTypeName	string	退票类型名称（和refundType一一对应，如：非自愿）
refundPoundageAmount	float	退票手续费总金额（航司收取）
refundAmount	float	退款总金额
refundSuccessTime	datetime	退款成功时间
refundTransactionNo	string	退票退款交易单号
refundFailedReason	string	退票失败原因
createTime	datetime	退票申请时间
refundPassengers	RefundPassenger[]	退票乘客信息（数组）
psgID	int	国内机票订单乘客唯一标识
name	string	姓名
ticketType	int	机票类型( 1成人票 2儿童票 3婴儿票)
ticketNo	string	票号
farePrice	int	票面价(往返或联程时为两段总的票面价)
salePrice	float	销售价,不含税(即机票实际销售价，往返或联程时为两段总的销售价)
tax	int	机建费(往返或联程时为两段总的机建费)
fuel	int	燃油费(往返或联程时为两段总的燃油费)
refundAmount	float	当前乘客退款金额
refundPoundage	float	当前乘客退票费
refundFlights	FlightInfo[]	退票航班信息（同订单详情接口返回）

JSON返回示例 :

{
  "data": {
    "refundOrders": [
      {
        "refundNo": "20200605224832881433601173",
        "orderNo": "2020060522483288143360",
        "refundPsgNames": "王洋|周杰",
        "refundFlightNos": "CZ6754",
        "refundOrderStatus": 13,
        "refundOrderStatusName": 13,
        "refundType": 1,
        "refundTypeName": 1,
        "refundPoundageAmount": null,
        "refundAmount": null,
        "refundSuccessTime": null,
        "refundTransactionNo": null,
        "refundFailedReason": null,
        "createTime": "2020-06-07 20:58:14",
        "refundFlights": [
          {
            "flightNo": "CZ6754",
            "fromAirportCode": "PVG",
            "toAirportCode": "SYX",
            "fromAirportName": "上海浦东",
            "toAirportName": "三亚凤凰",
            "fromCityName": "上海",
            "toCityName": "三亚",
            "fromDateTime": "2020-06-10 12:45:00",
            "toDateTime": "2020-06-10 16:15:00"
          }
        ],
        "refundPassengers": [
          {
            "psgID": 10,
            "name": "王洋",
            "ticketType": 1,
            "ticketNo": "8475288582374",
            "farePrice": 1650,
            "salePrice": 1649.00,
            "tax": 50,
            "fuel": 0,
            "refundAmount": null,
            "refundPoundage": null
          },
          {
            "psgID": 11,
            "name": "周杰",
            "ticketType": 1,
            "ticketNo": "8475288582375",
            "farePrice": 1650,
            "salePrice": 1649.00,
            "tax": 50,
            "fuel": 0,
            "refundAmount": null,
            "refundPoundage": null
          }
        ]
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/flight/submitInvoluntaryProve

返回格式： json

请求方法： get/post

请求示例： http://接口域名/flight/submitInvoluntaryProve?appKey=您申请的APPKEY&refundNo=220627135449086858&involuntaryProveUrls=https://img12.360buyimg.com/jdcms/s150x150_jfs/t1/182274/32/20102/116837/611f58a5E9af2d3f7/c461c76c2957667f.jpg&remark=无核酸证明被机场拒载

接口说明：

非自愿退票证明文件是终端旅客用户通过分销商平台，将文件上传至分销商平台（服务器），分销商通过该接口将 “非自愿退票证明文件的访问地址”提交至磐河即可

请求参数：

参数名称	类型	必填	说明
appKey	string	是	接口账号appKey
refundNo	string	是	退票单号
involuntaryProveUrls	string	是	非自愿退票证明文件地址（多个文件用'\|'分割，支持的文件类型有：pdf/jpg/jpeg/png），自愿退票无需填写
remark	string	否	备注（可选，用户填写）

返回参数：

参数名称	类型	说明
success	bool	true提交成功 false提交失败

JSON返回示例 :

{
    "data": true,
    "success": true,
    "msg": "请求成功"
}

接口地址： http://接口域名/flight/applyChangeTicket

返回格式： json

请求方法： post

接口说明：

由于机票改签流程相对较慢。旅客再提交改签时，至少预留两个小时给到平台进行操作，临近航班(2h以内的)和夜间旅客需自行联系航司进行改签。（可以申请改签的乘客状态（字段PsgStatus值）有：已出票=1, 不能退票=12, 不能改签=22, 改签完成=23）

请求参数：

参数名称	类型	必填	说明
orderNo	string	是	订单号
changeType	int	是	申请变更类型：1=改签（含改期和升舱），2=改姓名，3=改证件号
remark	string	否	改签备注。
callBackUrl	string	是	改签结果异步通知地址，回调详见:订单状态推送通知说明
changePassengers	changePassengerInfo[]	是	改签客票信息（数组）（哪些乘客可以改签：乘客状态（PsgStatus）为：已出票 = 1, 不能退票 = 12, 不能改签 = 22, 改签完成 = 23 这些状态才允许改签））
ticketNo	string	是	票号（说明：不管乘客有无改签过，始终传原订单乘客票号）
name	string	否	乘客（正确的）姓名（说明：当变更类型值为2即改姓名时传正确的姓名，其他变更类型时可不传）
cardNo	string	否	乘客（正确的）证件号（说明：当变更类型值为3即改证件号时传正确的证件号，其他变更类型时可不传）
changeFlights	changeFlightInfo[]	是	改签（新）航班信息（数组）
originalFlightNo	string	是	原航班号，当为往返或联程时必传原订单的航班号，表示对应哪一段的改签，单程可不传
flightNo	string	是	（改签新）航班号
fromAirportCode	string	是	（改签新）出发机场三字码
toAirportCode	string	是	（改签新）到达机场三字码
fromDateTime	string	是	（改签新）出发时间，格式：yyyy-MM-dd HH:mm
toDateTime	string	是	（改签新）到达时间，格式：yyyy-MM-dd HH:mm
cabinCode	string	是	（改签新）舱位代码
fromTerminal	string	是	（改签新）出发航站楼
toTerminal	string	是	（改签新）到达航站楼

返回参数：

参数名称	类型	说明
success	bool	true表示申请成功；false表示申请失败（msg为失败原因）
data	string	改签单号（success=true 申请成功才有值）

JSON请求示例 :

{
  "appKey": "您申请的APPKEY",
  "orderNo": "2020060522483288143360",
  "changeType": 1 ,
  "changePassengers": [
    {
      "ticketNo": "8475288582374",
      "name": null ,
      "cardNo": null 
 
    },
    {
      "ticketNo": "8475288582375",
      "name": null ,
      "cardNo": null 
    }
  ],
  "changeFlights": [
    {
      "originalFlightNo":"CZ6754",
      "flightNo": "CZ6754",
      "fromAirportCode": "PVG",
      "toAirportCode": "SYX",
      "fromDateTime": "2020-06-12 12:45",
      "toDateTime": "2020-06-12 16:15",
      "cabinCode": "A",
      "fromTerminal":"",
      "toTerminal":""
    }
  ],
  "remark":"行程推后",
  "callBackUrl": "改签状态异步回调地址"
}

JSON返回示例 :

//申请失败返回示例
{
  "data": null,
  "success": false,
  "msg": "乘机人[王洋]处于‘退票中’状态，暂不能申请改签"
}

//申请成功返回示例
{
  "data": "2020060522483288143360C9314",
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/flight/chaAutoPay

返回格式： json

请求方法： post

接口说明：

此接口同步返回的是支付结果，success=true表示改签支付成功。支付成功不等于改签成功，具体改签结果会异步回调通知，以订单状态为准。

请求参数：

参数名称	类型	必填	说明
orderNo	string	是	国内机票订单号
chaNo	string	是	国内机票改签单号
payAmount	float	否	改签支付金额（传入将验证支付金额；传值时就参与签名，为null时不参与签名）
sign	string	是	签名校验值，md5(secretKey+chaNo+payAmount+secretKey)，secretKey为请求密钥，开通账户时即可获得。加密结果转为32位小写

返回参数：

参数名称	类型	说明
success	bool	true表示成功；false表示失败（msg为失败原因）

JSON请求示例 :

{
    "appKey": "您申请的APPKEY",
    "orderNo": "2020080617221655461288",
    "chaNo": "2020080617221655461288C4494",
    "payAmount": "100.00",
    "sign":"17fb3f159a93cf6a5d0275565d1a0954"
}

JSON返回示例 :

//代扣支付成功示例
{
    "data": true,
    "success": true,
    "msg": "请求成功"
}

//代扣支付失败示例
{
  "data": null,
  "success": false,
  "msg": "钱包余额不足！"
}

接口地址： http://接口域名/flight/cancelChange

返回格式： json

请求方法： get/post

请求示例： http://接口域名/flight/cancelChange?appKey=您申请的APPKEY&chaNo=2020060522483288143360C9314

接口说明：

只有 “新申请待审核”和 “需补款待支付”状态下的改签单，才允许取消操作！

请求参数：

参数名称	类型	必填	说明
chaNo	string	是	国内机票改签单号

返回参数：

参数名称	类型	说明
success	bool	true表示成功；false表示失败（msg为失败原因）

JSON返回示例 :

{
  "data": true,
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/flight/getChaOrderDetail

返回格式： json

请求方法： get/post

请求示例： http://接口域名/flight/getChaOrderDetail?appKey=您申请的APPKEY&chaNo=2020060522483288143360C9314&orderNo=

请求参数：

参数名称	类型	必填	说明
orderNo	string	否	国内机票订单号（订单号和改签单号至少传一个，只传订单号时获取当前订单下所有改签单）
chaNo	string	是	国内机票改签单号（改签单号和订单号至少传一个，当传入改签单号时只获取改签单号对应的改签单）

返回参数：

参数名称	类型	说明
chaOrders	ChaOrder[]	改签单列表（数组，只传订单号时返回该订单下所有改签单信息，传改签单号时只获取某一具体改签单）
chaNo	string	国内机票改签单号
orderNo	string	国内机票订单号
chaPsgNames	string	改签乘客姓名，多个用'\|'分割
chaOriginFlightNos	string	改签原航段航班号，多个用'\|'分割
changeType	int	变更类型( 1= 改签， 2= 改姓名， 3= 改证件号， 4=其他变更)
changeTypeName	string	变更类型名称（和changeType 一一对应，如：改姓名）
chaOrderAmount	float	改签单需支付金额（默认为0，只有改签需补款后才有值）
realPayAmount	float	改签补款实际支付金额（改签支付成功后才有值）
chaOrderStatus	int	改签单状态值(新申请待审核 = 21,审核不通过交易结束 = 22, 需补款待支付 = 23,已补款待处理 = 24,无法改签退款中 = 25,无法改签已退款交易结束 = 26,改签成功交易结束 = 27,改签已取消交易结束 = 28, 改签处理中 = 29)
chaOrderStatusName	string	改签单状态名称（和chaOrderStatus一一对应，如：需补款待支付）
payStatus	int	支付状态（0未支付 1已支付）
payTime	datetime	支付时间（支付成功才有值）
remark	string	改签申请时传入的改签备注
chaCompleteTime	datetime	改签完成时间（改签成功交易结束后才有值）
chaFailedReason	string	改签失败原因（改签失败时才有值）
createTime	datetime	改签申请时间
chaPassengers	chaPassenger[]	改签乘客信息（数组）
psgID	int	国内机票订单乘客唯一标识
name	string	乘机人姓名
cardType	int	证件类型( 身份证 = 1,护照 = 2,港澳通行证 = 5,台湾通行证 = 6)
cardNo	string	证件号
birthday	string	出生日期
ticketType	int	机票类型( 1成人票 2儿童票 3婴儿票)
mobile	string	乘机人手机号
oldTicketNo	string	原票号
newTicketNo	string	改签成功后的新票号
oldFarePrice	int	原票面价
newFarePrice	int	改签后的新票面价
changeFee	float	改签费（航空公司按照改签规则收取的改签费用）
differenceFare	float	升舱费（即新票面价和原票面价之差）
serviceFee	float	改签服务费（平台收取的改签服务费用）
chaFlights	ChaFlight[]	改签后的航班信息（数组，当变更类型为 1=改签时，才有改签航班信息，改证件、改姓名时该值为空）
originalFlight	FlightInfo	当前改签航班对应的原航班信息（FlightInfo数据结构请参考订单详情接口返回的航班信息）
flightNo	string	改签后的航班号
airlineCode	string	改签后的航司二字码
airlineCompany	string	改签后的航空公司名称
cabinCode	string	改签后的舱位代码
discount	float	改签后的舱位折扣
fromAirportCode	string	改签后的出发机场三字码
toAirportCode	string	改签后的到达机场三字码
fromAirportName	string	改签后的出发机场名称
toAirportName	string	改签后的到达机场名称
fromCityName	string	改签后的出发城市名称
toCityName	string	改签后的到达城市名称
fromDateTime	datetime	出发时间改签后的
toDateTime	datetime	改签后的到达时间
fromTerminal	string	改签后的出发航站楼
toTerminal	string	改签后的到达航站楼

JSON返回示例 :

{
  "data": {
    "chaOrders": [
      {
        "chaNo": "2020060522483288143360C9314",
        "orderNo": "2020060522483288143360",
        "chaPsgNames": "王洋|周杰",
        "chaOriginFlightNos": "CZ6754",
        "changeType": 1,
        "changeTypeName": "改签",
        "chaOrderAmount": 0.00,
        "realPayAmount": null,
        "chaOrderStatus": 21,
        "chaOrderStatusName": "新申请待审核",
        "payStatus": 0,
        "payTime": null,
        "remark": "行程推后",
        "chaCompleteTime": null,
        "chaFailedReason": null,
        "createTime": "2020-06-08 00:29:31",
        "chaPassengers": [
          {
            "psgID": 10,
            "name": "王洋",
            "cardType": 1,
            "cardNo": "330227********5368",
            "birthday": "1870-10-25 00:00:00",
            "ticketType": 1,
            "mobile": "18956251378",
            "oldTicketNo": "8475288582374",
            "newTicketNo": null,
            "oldFarePrice": 1650,
            "newFarePrice": null,
            "changeFee": 0.00,
            "differenceFare": 0.00,
            "serviceFee": 0.00
          },
          {
            "psgID": 11,
            "name": "周杰",
            "cardType": 1,
            "cardNo": "150423********0028",
            "birthday": "1876-03-16 00:00:00",
            "ticketType": 1,
            "mobile": "18247568923",
            "oldTicketNo": "8475288582375",
            "newTicketNo": null,
            "oldFarePrice": 1650,
            "newFarePrice": null,
            "changeFee": 0.00,
            "differenceFare": 0.00,
            "serviceFee": 0.00
          }
        ],
        "chaFlights": [
          {
            "originalFlight": {
              "flightID": 8,
              "flightNo": "CZ6754",
              "fromAirportCode": "PVG",
              "toAirportCode": "SYX",
              "fromAirportName": "上海浦东",
              "toAirportName": "三亚凤凰",
              "fromCityName": "上海",
              "toCityName": "三亚",
              "fromDateTime": "2020-06-10 12:45:00",
              "toDateTime": "2020-06-10 16:15:00",
              "flyDuration": "03:30",
              "fromTerminal": "T2",
              "toTerminal": "T1",
              "airlineCode": "CZ",
              "airlineCompany": "南方航空",
              "craftType": null,
              "cabinCode": "A",
              "cabinName": "经济舱",
              "cabinLevel": 1,
              "cabinLevelName": "经济舱",
              "discount": 0.69
            },
            "flightNo": "CZ6754",
            "airlineCode": null,
            "airlineCompany": null,
            "cabinCode": "A         ",
            "discount": null,
            "fromAirportCode": "PVG",
            "toAirportCode": "SYX",
            "fromAirportName": "上海浦东",
            "toAirportName": "三亚凤凰",
            "fromCityName": "上海",
            "toCityName": "三亚",
            "fromDateTime": "2020-06-12 12:45:00",
            "toDateTime": "2020-06-12 16:15:00",
            "fromTerminal": null,
            "toTerminal": null
          }
        ]
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

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

在线接口文档中心

国内机票

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON请求示例 :

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON请求示例 :

JSON返回示例 :

请求参数：

返回参数：

JSON请求示例 :

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON请求示例 :

JSON返回示例 :

请求参数：

返回参数：

JSON请求示例 :

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :