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

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

返回格式： json

请求方法： get/post

请求参数：

参数名称	类型	必填	说明
flightRangeType	int	是	航程类型( 单程 = 0, 往返 = 1，多程 = 2)
cabinLevelList	int[]	否	舱位等级：经济舱 = 1, 公务舱 = 2, 头等舱 = 3, 超级经济舱=4 (ps:仅允许同时搜索两个不同舱等，默认查询经济舱和超级经济舱)
adultNumber	int	是	成人数，取值范围[1,9] (PS:查询和预订时填写的乘客类型及人数需保持一致，否则价格可能不准)
childNumber	int	否	儿童人数，取值范围[0,9] 默认值为0 (PS:查询和预订时填写的乘客类型及人数需保持一致，否则价格可能不准)
babyNumber	string	否	婴儿人数，取值范围[0,9] 默认值为0 (PS:查询和预订时填写的乘客类型及人数需保持一致，否则价格可能不准)
isAsync	bool	是	是否异步查询,true异步分页查询，false同步返回所有航班数据（PS: 异步优点是请求响应速度快，但需分页轮询查询，，同步优点是一次性返回所有数据，缺点是请求响应慢）
airLineCode	string[]	否	指定筛选航司二字码（指定的话只返回指定出票航司的航班组合）

返回参数：

参数名称	类型	说明
isLoadCompleted	bool	是否全部加载完成,当启用异步查询时（isAsync=true），如果该值返回true表示已获取完成，应停止继续轮询
nextPollingKey	string	下一个轮询key，当isLoadCompleted=false时，才需要该值
tripCombineList	tripCombine[]	行程组合(对象)数组
tripCombineID	string	行程唯一标识 ( 调用查询客规接口和下单接口时需原样传入)
ticketingAirlineCode	string	出票航司二字码
priceList	priceInfo[]	价格信息(对象)数组
priceId	string	价格ID ( 调用查询客规接口和下单接口时需原样传入)
adultSalePrice	decimal	成人结算价（不含税费）, 即磐河给你们的不含税成人票价
adultFarePrice	decimal	成人票面价（不含税费），即原价
adultTax	decimal	成人税费
childSalePrice	decimal	儿童结算价（不含税费）, 即磐河给你们的不含税儿童票价（如果入参childNumber=0，该值返回null）
childFarePrice	decimal	儿童票面价（不含税费），即原价（如果入参childNumber=0，该值返回null）
childTax	decimal	儿童税费（如果入参childNumber=0，该值返回null）
babySalePrice	decimal	婴儿结算价（不含税费）, 即磐河给你们的不含税婴儿票价（如果入参childNumber=0，该值返回null）
babyFarePrice	decimal	婴儿票面价（不含税费），即原价（如果入参childNumber=0，该值返回null）
babyTax	decimal	婴儿税费（如果入参childNumber=0，该值返回null）
tripList	tripInfo[]	行程(对象)数组
fromAirportCode	string	行程出发机场三字码
fromAirportName	string	行程出发机场名称
fromCityName	string	行程出发城市名称
toAirportCode	string	行程到达机场三字码
toAirportName	string	行程到达机场名称
toCityName	string	行程到达城市名称
fromDateTime	string	行程出发日期及时间(均为当地时间)
toDateTime	string	行程到达日期及时间(均为当地时间)
flightList	flightInfo[]	航班列表
flightNo	string	航班号
airlineCode	string	航司二字码
airlineCompany	string	航司名称
fromAirportCode	string	出发机场三字码
fromAirportName	string	出发机场名称
fromCityName	string	出发城市名称
toAirportCode	string	到达机场三字码
toAirportName	string	到达机场名称
toCityName	string	到达城市名称
fromDateTime	string	出发日期及时间(均为当地时间)
toDateTime	string	到达日期及时间(均为当地时间)
fromTerminal	string	出发航站楼
toTerminal	string	到达航站楼
flyDuration	string	航班飞行耗时
craftType	string	机型
cabinCode	string	舱位代码
cabinLevel	int	舱位等级（经济舱 = 1, 公务舱 = 2,头等舱 = 3,超级经济舱=4）
shareFlightNo	string	如果是共享航班，共享航班号

JSON请求示例 :

{
  "appKey": "您申请的AppKey",
  "flightRangeType": 0,
  "tripList": [
    {
      "fromCityCode": "CTU",
      "toCityCode": "SEL",
      "fromDate": "2026-04-25"
    }
  ],
  "isAsync":true ,
  "pollingKey":"dcab661ebfd04431892ade9c9cddd414",
  "adultNumber": 1
}

JSON返回示例 :

{
  "data": {
    "tripCombineList": [
      {
        "tripCombineID": "H4sIAAAAAAAEADOvMzVINTUzSUoysExNMkmzSElKtTQ1Tkq2MDI3N0kzNgfSAI16AowkAAAA",
        "ticketingAirlineCode": "CZ",
        "tripList": [
          {
            "fromAirportCode": "TFU",
            "fromAirportName": "天府国际机场",
            "fromCityName": "成都",
            "toAirportCode": "ICN",
            "toAirportName": "仁川国际机场",
            "toCityName": "首尔",
            "fromDateTime": "2026-04-25 21:00:00",
            "toDateTime": "2026-04-26 13:55:00",
            "flightList": [
              {
                "flightNo": "CZ3476",
                "airlineCode": null,
                "airlineCompany": null,
                "fromAirportCode": "TFU",
                "fromAirportName": "天府国际机场",
                "fromCityName": "成都",
                "toAirportCode": "CAN",
                "toAirportName": "白云国际机场",
                "toCityName": "广州",
                "fromDateTime": "2026-04-25 21:00:00",
                "toDateTime": "2026-04-25 23:25:00",
                "fromTerminal": "2",
                "toTerminal": "2",
                "flyDuration": "02:25",
                "craftType": "32N",
                "cabinCode": "Q",
                "cabinLevel": 1,
                "shareFlightNo": null
              },
              {
                "flightNo": "CZ337",
                "airlineCode": null,
                "airlineCompany": null,
                "fromAirportCode": "CAN",
                "fromAirportName": "白云国际机场",
                "fromCityName": "广州",
                "toAirportCode": "ICN",
                "toAirportName": "首尔仁川国际机场",
                "toCityName": "首尔",
                "fromDateTime": "2026-04-26 09:35:00",
                "toDateTime": "2026-04-26 13:55:00",
                "fromTerminal": "2",
                "toTerminal": "1",
                "flyDuration": "03:20",
                "craftType": "789",
                "cabinCode": "V",
                "cabinLevel": 1,
                "shareFlightNo": null
              }
            ]
          }
        ],
        "priceList": [
          {
            "priceId": "H4sIAAAAAAAEAKtWKi5IUbLKK83J0VFKLC5QsjIzN9EzMABzjJSsDPRAzBKguLmZKYStZGVqaAFiJoOUQ3QmgxVD2SUI4RIYKwmhNglJbRJCbRJUbS0ADEaDM5MAAAA=",
            "adultSalePrice": 674.00,
            "adultFarePrice": 765.0,
            "adultTax": 518.0,
            "childSalePrice": null,
            "childSalePrice2": null,
            "childFarePrice": null,
            "childTax": null,
            "babySalePrice": null,
            "babySalePrice2": null,
            "babyFarePrice": null,
            "babyTax": null
          }
        ]
      }
    ],
    "isLoadCompleted": true,
    "nextPollingKey": "dcab661ebfd04431892ade9c9cddd414",
    "channelID": 7
  },
  "success": true,
  "msg": "请求成功"
}

接口地址： http://接口域名/iFlight/queryRules

返回格式： json

请求方法： get

请求参数：

参数名称	类型	必填	说明
appKey	string	是	您申请的appkey
priceId	string	是	价格ID，航班查询接口返回
tripCombineID	string	是	行程唯一标识，航班查询接口返回

返回参数：

参数名称	类型	说明
segmentRules	segmentRuleInfo[]	航段客规(对象)数组
fromAirportCode	string	出发机场三字码
toAirportCode	string	到达机场三字码
fromAirportName	string	出发机场名称
toAirportName	string	到达机场名称
fromCityName	string	出发城市名称
toCityName	string	到达城市名称
adultRule	RefundChangeLuggageRule	成人客规
childRule	RefundChangeLuggageRule	儿童客规
babyRule	RefundChangeLuggageRule	婴儿客规
luggageDescription	string	行李描述
refundDescription	string	退票规则描述
changeDescription	string	改签规则描述
noshowDescription	string	误机规则描述
formatRefundRule	RefundChangerFormatRule[]	格式化退票规则（RefundChangerFormatRule 对象数组类型）
formatChangeRule	RefundChangerFormatRule[]	格式化改期规则（RefundChangerFormatRule 对象数组类型）
ruleType	int	客规类型，1-全部未使用，2-部分使用（RefundChangerFormatRule 对象属性，，以下字段到startTime都是RefundChangerFormatRule 对象属性）
ruleStatus	int	退票/改签标识:1：不可退/改， 2：有条件退/改，3：允许，免费，4:允许，可能收取费用
feeType	int	费用类型：1-具体金额；2-百分比（%）。
fee	decimal	费用：当feeType=1时，数字代表具体退/改收费金额，0代表免费；当feeType=2时，数字代表折扣，100代表票面价的100%，90代表票面价的90%，80代表票面价的80%，以此类推。当为不允许时费用为空。
currency	string	货币类型，默认是CNY，当为不允许时货币类型为空。
startTime	string	区间开始时间，null表示不限开始时间，正数代表起飞前多少小时（如24代表起飞前24小时），0在时间段开始点代表起飞后，负数代表起飞后多少小时（如-24代表起飞后24小时）
luggageDetails	LuggageDetailInfo[]	格式化_托运行李
fromAirportCode	string	出发机场三字码
toAirportCode	string	到达机场三字码
fromCityName	string	出发城市名称
toCityName	string	到达城市名称
checkedBaggage	FormatLuggage	托运行李额(FormatLuggage对象类型)
handLuggage	FormatLuggage	手提行李额(FormatLuggage对象类型)
luggageNum	int	行李件数，-1代表不确定，单位是PC
luggageWeight	decimal	行李重量，-1代表不确定，单位是KG。

JSON请求示例 :

{
  "appKey": "您申请的appkey",
  "priceId": "H4sIAAAAAAAEAE2LSw6AIAxE79K1Ma1pQbgNFV0ZYyKujHc34Ad3b2beHLCtETxMcWISosCBGcX1xhq0xikLOdQRGgjbCp6MdS1iSR14bDOmPIj0dwAvVHDIh2Wf54Ldx6nW6SWtrv5cra4+7nkBGPntQLMAAAA=",
  "tripCombineID": "H4sIAAAAAAAEAAXBgQEAEAwDsJc2atVzsDnD7RI+2ylMZLIcapLbIGKpR9yjon8HA6BcJAAAAA=="
  }

JSON返回示例 :

{
  "data": {
    "segmentRules": [
      {
        "fromAirportCode": "TFU",
        "toAirportCode": "GMP",
        "fromAirportName": null,
        "toAirportName": null,
        "fromCityName": "成都",
        "toCityName": "首尔",
        "adultRule": {
          "luggageDescription": "成都-上海  上海-首尔: 免费托运:每人1件每件23公斤每件长宽高之和≤158CM      免费手提:每人1件每件8公斤  每件长宽高之和≤115CM      ",
          "refundDescription": "起飞前:100元/人  起飞后:200元/人",
          "changeDescription": "起飞前:300元/人  起飞后:400元/人",
          "noshowDescription": null,
          "formatRefundRule": [
            {
              "ruleType": 1,
              "ruleStatus": 2,
              "feeType": 1,
              "fee": 100.0,
              "currency": "CNY",
              "startTime": 8760.0
            },
            {
              "ruleType": 1,
              "ruleStatus": 2,
              "feeType": 1,
              "fee": 200.0,
              "currency": "CNY",
              "startTime": 0.0
            }
          ],
          "formatChangeRule": null,
          "luggageDetails": [
            {
              "fromAirportCode": "TFU",
              "toAirportCode": "SHA",
              "fromCityName": "成都",
              "toCityName": "上海",
              "checkedBaggage": {
                "luggageNum": 1,
                "luggageWeight": 23.0
              },
              "handLuggage": {
                "luggageNum": 1,
                "luggageWeight": 8.0
              }
            },
            {
              "fromAirportCode": "SHA",
              "toAirportCode": "GMP",
              "fromCityName": "上海",
              "toCityName": "首尔",
              "checkedBaggage": {
                "luggageNum": 1,
                "luggageWeight": 23.0
              },
              "handLuggage": {
                "luggageNum": 1,
                "luggageWeight": 8.0
              }
            }
          ]
        },
        "childRule": null,
        "babyRule": null
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

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

返回格式： json

请求方法： post

请求参数：

参数名称	类型	必填	说明
appKey	string	是	您申请的appkey
flightRangeType	int	是	航程类型( 单程 = 0, 往返 = 1，多程 = 2)
priceId	string	是	价格ID，航班查询接口返回
tripCombineID	string	是	行程唯一标识，航班查询接口返回
ticketingAirlineCode	string	是	出票航司二字码，航班查询接口返回
customerOrderNo	string	是	商户订单号(关联用，不得重复)
orderAmount	decimal	是	磐河机票订单总金额（商户需要支付的该单采购成本），传值服务端就会校验，不传值服务端就会自己计算订单总金额并返回
contactName	string	是	订单联系人
contactMobile	string	是	联系人手机号
contactEmail	string	否	联系人邮箱
tripList	tripInfo[]	是	行程数组(按照行程顺序)
flightList	flightInfo[]	是	航班数组(每一段必须按照航段顺序)
flightNo	string	是	航班号
airlineCode	string	是	航司二字码
airlineCompany	string	是	航司名称
fromAirportCode	string	是	出发机场三字码
fromAirportName	string	是	出发机场名称
fromCityName	string	是	出发城市名称
toAirportCode	string	是	到达机场三字码
toAirportName	string	是	到达机场名称
toCityName	string	是	到达城市名称
fromDateTime	string	是	出发日期及时间
toDateTime	string	是	到达日期及时间
fromTerminal	string	否	出发航站楼
toTerminal	string	否	到达航站楼
flyDuration	string	是	飞行时长，格式HH:mm，如：03:05，表示飞行 3小时5分钟
craftType	string	否	机型
cabinCode	string	是	舱位代码
cabinLevel	int	是	舱位等级：经济舱 = 1, 公务舱 = 2, 头等舱 = 3, 超级经济舱=4
isShareFlight	bool	是	是否为共享航班
realFlightNo	string	是	当为共享航班时，实际承运航班号
passengers	Passenger[]	是	乘客列表（需和查询时乘客类型及数量保持一致）
surname	string	是	乘客姓
givenName	string	是	乘客名
passengerType	int	是	乘客类型：成人 = 1，儿童=2，婴儿 = 3
cardType	int	是	证件类型：护照 = 2,回乡证 = 3,台胞证 = 4,港澳通行证 = 5,台湾通行证 = 6,外国人永久居留身份证 = 8,港澳台居民居住证 = 9
cardNo	string	是	证件号
birthday	string	是	出生日期(格式：yyyy-MM-dd)
cardValidEndDate	string	是	证件有效期截止日期 (格式：yyyy-MM-dd)
sex	int	是	1=男 2=女
nationalityCode	string	是	国籍二字码
mobile	string	是	乘客手机号

返回参数：

参数名称	类型	说明
success	bool	下单是否成功
msg	string	下单失败时，失败原因
orderNo	string	订单号
orderAmount	decimal	订单总金额

JSON请求示例 :

{
  "appKey": "您申请的appkey",
  "flightRangeType": 0,
  "priceId": "H4sIAAAAAAAEAE2LQQqAMAwE/5KzlLRWrf1NkupJRLCexL+rQa2Hhdlkdod1SRCBktRITS09Jc+thJAsXWkHGr0VBxXQukC0iN4ganMQ0dyY9dE8BaLrFOUezNs0KbqPcznnl7i4/HO5uPy4xwn4CXFmswAAAA==",
  "tripCombineID": "H4sIAAAAAAAEADOvM09MtUg2tjQ3s7Q0NDEyN7NIMjFJSzQ0NEmzqDI2rDJwNAUARRHBnSQAAAA=",
  "ticketingAirlineCode": "CA",
  "tripList": [
    {
      "flightList": [
     {
                                "flightNo": "CA427",
                                "airlineCode": "CA",
                                "airlineCompany": "中国国航",
                                "fromAirportCode": "TFU",
                                "fromAirportName": "天府国际机场",
                                "fromCityName": "成都",
                                "toAirportCode": "HKG",
                                "toAirportName": "香港国际机场",
                                "toCityName": "香港",
                                "fromDateTime": "2026-04-22 13:15:00",
                                "toDateTime": "2026-04-22 15:55:00",
                                "fromTerminal": "T1",
                                "toTerminal": "1",
                                "flyDuration": "02:40",
                                "craftType": "32N",
                                "cabinCode": "T",
                                "cabinLevel": 1,
                                "shareFlightNo": ""
                            }
      ]
    }
  ],
  "passengers": [
    {
      "surname": "Wang",
      "givenName": "Tao",
      "ticketType": 1,
      "cardType": 2,
      "cardNo": "EJ456782",
      "birthday": "2000-10-01",
      "cardValidEndDate": "2030-10-01",
      "sex": 1,
      "nationalityCode": "CN",
      "mobile": "13912345678"
    }
  ]
}

JSON返回示例 :

{
    "data": {
        "orderNo": "IF26041323051155978",
        "orderAmount": 1274.00
    },
    "success": true,
    "msg": "请求成功"
}

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

返回格式： json

请求方法： get

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

请求参数：

参数名称	类型	必填	说明
appKey	string	是	您申请的APPKEY
orderNo	string	是	采购单号
payAmount	decimal	是	支付金额（支付金额空时不验证，不为空时会和订单金额比对）
paymentType	int	是	支付方式：固定传 1：余额支付
sign	string	是	签名校验值，md5(secretKey+orderNo+payAmount+secretKey)，secretKey为请求密钥，开通账户时即可获得，加密结果转为32位小写。【注意：加密前的拼接原串不包含'+'】

返回参数：

参数名称	类型	说明
success	bool	是否支付成功（支付接口同步就返回支付结果了，所以支付结果无需回调，支付成功后等待出票即可，出票结果会回调的，亦可轮询订单同步状态）
msg	string	支付失败时，失败原因

JSON返回示例 :

失败示例：
{
    "data": null,
    "success": false,
    "msg": "只有新订单才允许支付！"
}

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

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

返回格式： json

请求方法： get

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

请求参数：

参数名称	类型	必填	说明
appKey	string	是	您申请的APPKEY
orderNo	string	是	采购单号
remark	string	是	取消备注

返回参数：

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

JSON返回示例 :

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

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

返回格式： json

请求方法： get/post

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

请求参数：

参数名称	类型	必填	说明
appKey	string	是	您申请的APPKEY
orderNo	string	是	国际采购单号

返回参数：

参数名称	类型	说明
orderNo	string	国际采购单号
orderAmount	decimal	订单总金额
customerOrderNo	string	商户单号
flightRangeType	int	航程类型( 单程 = 0, 往返 = 1，多程 = 2)
orderStatus	int	国际采购单状态值(新订单待支付 = 1,已支付待出票 = 2,出票中 = 3,已出票 = 4,不能出票待退款 = 5,不能出票退款中 = 6,不能出票已退款 = 7, 已取消 = 99)
orderStatusName	string	国际采购单状态名称
payStatus	int	支付状态（0未支付 1已支付）
payTime	string	支付时间（支付成功才有值）
ticketTime	string	出票时间（出票成功才有值）
contactName	string	联系人
contactMobile	string	联系人手机号
payLimitTime	string	支付时限
unFinishedReason	string	当出票失败时，失败原因
callbackUrl	string	出票结果回调地址
adultNumber	int	订单成人数
childNumber	int	订单儿童数
babyNumber	int	订单婴儿数
adultSalePrice	decimal	成人结算票价（不含税）
adultFarePrice	decimal	成人票面价（不含税）
adultTax	decimal	成人税费
childSalePrice	decimal	儿童结算票价（不含税）
childFarePrice	decimal	儿童票面价（不含税）
childTax	decimal	儿童税费
babySalePrice	decimal	婴儿结算票价（不含税）
babyFarePrice	decimal	婴儿面价（不含税）
babyTax	decimal	婴儿税费
createTime	string	下单时间
passengerList	Passenger[]	乘客列表
psgID	int	乘客ID(退票和改签需要用到)
surname	string	乘客证件上的姓氏
givenName	string	乘客证件上的名字
nationalityCode	string	国籍二字码
nationalityCName	string	国籍中文名称
cardType	int	证件类型：护照 = 2,回乡证 = 3,台胞证 = 4,港澳通行证 = 5,台湾通行证 = 6,外国人永久居留身份证 = 8,港澳台居民居住证 = 9
cardTypeName	string	证件类型名称
cardNo	string	证件号
cardValidEndDate	string	证件有效期截止日期 (格式：yyyy-MM-dd)，不能小于起飞日期
birthday	string	出生日期
sex	string	性别（1=男 2=女）
mobile	string	手机号
passengerType	int	乘客类型:成人票 = 1,儿童票 = 2,婴儿票 = 3
passengerTypeName	string	客票（乘客）类型名称
ticketNo	string	票号，出票成功才有值，多个英文逗号分隔
psgStatus	int	乘客状态
psgStatusName	string	订乘客状态名称
flightList	flightInfo[]	航班(对象)数组
flightNo	string	航班号
tripIndex	int	行程索引，从1开始，当前航班是订单中第几程的
fromAirportCode	string	出发机场三字码
toAirportCode	string	到达机场三字码
fromAirportName	string	出发机场名称
toAirportName	string	到达机场名称
fromCityName	string	出发城市名称
toCityName	string	到达城市名称
fromDateTime	string	出发时间(精确到分钟)
toDateTime	string	到达时间(精确到分钟)
fromTerminal	string	出发航站楼
toTerminal	string	到达航站楼
airlineCode	string	航司二字码
airlineCompany	string	航空公司名称
flyDuration	string	飞行时长，格式HH:mm，如：3:05，表示飞行 3小时5分钟
craftType	string	机型
cabinCode	string	舱位代码
cabinLevel	int	舱位等级：经济舱 = 1, 公务舱 = 2, 头等舱 = 3, 超级经济舱=4
isShareFlight	bool	是否为共享航班
realFlightNo	string	当为共享航班时，实际承运航班号

JSON返回示例 :

{
  "data": {
    "orderNo": "IF26040123055365258",
    "orderAmount": 14828.00,
    "customerOrderNo": null,
    "flightRangeType": 0,
    "orderStatus": 4,
    "orderStatusName": "已出票",
    "payStatus": 1,
    "payTime": "2026-04-01 23:16:46",
    "ticketTime": "2026-04-02 16:07:15",
    "contactName": null,
    "contactMobile": null,
    "payLimitTime": null,
    "unFinishedReason": null,
    "callbackUrl": null,
    "ticketRules": null,
    "adultNumber": 1,
    "childNumber": 0,
    "babyNumber": 0,
    "adultSalePrice": 14472.00,
    "adultFarePrice": 13751.00,
    "adultTax": 356.00,
    "childSalePrice": null,
    "childFarePrice": null,
    "childTax": null,
    "babySalePrice": null,
    "babyFarePrice": null,
    "babyTax": null,
    "createTime": "2026-04-01 23:05:53",
    "passengerList": [
      {
        "psgID": 1,
        "surname": "Wang",
        "givenName": "Tao",
        "nationalityCode": "CN",
        "nationalityCName": "中国",
        "cardType": 2,
        "cardTypeName": "护照",
        "cardNo": "EJ845629",
        "cardValidEndDate": "2030-10-01 00:00:00",
        "birthday": "2000-10-01 00:00:00",
        "sex": 1,
        "mobile": "13912345678",
        "passengerType": 1,
        "passengerTypeName": "成人票",
        "ticketNo": "111222",
        "psgStatus": 13,
        "psgStatusName": "已退票",
        "isCanApplyRefundTicket": false,
        "isCanApplyChangeTicket": false
      }
    ],
    "flightList": [
      {
        "flightNo": "CA1502",
        "tripID": null,
        "tripIndex": 1,
        "segmentIndex": 1,
        "fromAirportCode": "SHA",
        "toAirportCode": "PEK",
        "fromAirportName": "虹桥国际机场",
        "toAirportName": "首都国际机场",
        "fromCityName": "上海",
        "toCityName": "北京",
        "fromDateTime": "2026-04-10 12:25:00",
        "toDateTime": "2026-04-10 14:45:00",
        "fromTerminal": "2",
        "toTerminal": "3",
        "airlineCode": "CA",
        "airlineCompany": "中国国航",
        "flyDuration": "02:20",
        "craftType": "789",
        "cabinCode": "J",
        "cabinLevel": 2,
        "isShareFlight": false,
        "realFlightNo": null
      },
      {
        "flightNo": "CA117",
        "tripID": null,
        "tripIndex": 1,
        "segmentIndex": 2,
        "fromAirportCode": "PEK",
        "toAirportCode": "HKG",
        "fromAirportName": "首都国际机场",
        "toAirportName": "赤腊角机场",
        "fromCityName": "北京",
        "toCityName": "香港",
        "fromDateTime": "2026-04-10 17:30:00",
        "toDateTime": "2026-04-10 21:05:00",
        "fromTerminal": "3",
        "toTerminal": "1",
        "airlineCode": "CA",
        "airlineCompany": "中国国航",
        "flyDuration": "03:35",
        "craftType": "7M8",
        "cabinCode": "J",
        "cabinLevel": 2,
        "isShareFlight": false,
        "realFlightNo": null
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

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

返回格式： json

请求方法： post

请求参数：

参数名称	类型	必填	说明
appKey	string	是	您申请的AppKey
orderNo	string	是	采购单号
chaNo	string	是	改签单号(改签单申请退票时必填)
psgIDList	int[]	是	退票乘客ID列表（如果是采购单退票，就传采购单详情的乘客ID，如果是改签单退票就传改签单改签乘客ID,，切记，切记，，传错的话会提交失败）
flightIDList	int[]	是	退票航班ID列表（如果是采购单退票，就传采购单详情的航班ID，如果是改签单退票就传改签航班ID,，切记，切记，，传错的话会提交失败）
refundType	int	是	退票类型： 1自愿退票 10非自愿退票
callBackUrl	string	否	退票结果回调地址
refundRemark	string	否	退票备注
involuntaryProveUrls	string	否	非自愿退票证明文件地址（多个文件用'\|'分割，支持的文件类型有：pdf/jpg/jpeg/png），自愿退票无需填写

返回参数：

参数名称	类型	说明
success	bool	退票申请是否成功，成功data会返回退票单号，失败msg会返回失败原因
data	string	国际机票退票单号，当success=true即退票申请成功时才有值。

JSON请求示例 :

{
  "appKey": "您申请的AppKey",
  "orderNo": "IF26040912413534936",
  "chaNo": "IF26040912413534936C9684",
  "psgIDList": [
    10
  ],
  "flightIDList": [
    22,
    23
  ],
  "refundType": 1,
  "callBackUrl": null,
  "refundRemark": null
}

JSON返回示例 :

失败示例：
{
    "data": null,
    "success": false,
    "msg": "乘机人[Wang/Tao]处于‘已退票’状态，暂不能申请退票"
}

成功示例：
{
    "data": null,
    "success": true,
    "msg": "请求成功"
}

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

返回格式： json

请求方法： get/post

请求示例： http://接口域名/iFlight/getRefundOrderDetail?appKey=您申请的AppKey&refundNo=IF26040221310432509T9322

请求参数：

参数名称	类型	必填	说明
refundNo	string	是	退票单号

返回参数：

参数名称	类型	说明
refundNo	string	退票单号
orderNo	string	采购单号
chaNo	string	改签单号（如果是改签单申请退票才有值）
refundOrderStatus	int	退票单状态（新申请待平台审核 = 11,提交到供应审核 = 12,审核不通过交易结束 = 13,审核通过等待退款 = 14,款中 = 15,已退款交易结束 = 16）
refundOrderStatusName	string	退票单状态名称
refundType	int	退票类型：1自愿 10非自愿
refundPoundageAmount	decimal	退票手续费总金额（航司收取）
refundAmount	decimal	退款总金额
refundSuccessTime	string	退款成功时间
refundTransactionNo	string	退票退款交易单号
remark	string	申请退票时的备注
adultNumber	int	退票成人数
childNumber	int	退票儿童数
babyNumber	int	退票婴儿数
serviceFeePerTicket	decimal	单人退票服务费(平台收取,不分成人儿童婴儿)
totalRefundableAmountPerAdult	decimal	每位成人原单待退款总金额
refundFeePerAdult	decimal	单个成人退票手续费
usedFlightPricePerAdult	decimal	单成人已使用航段费
refundAmountPerAdult	decimal	单个成人退款金额(= totalRefundableAmountPerAdult-refundFeePerAdult-usedFlightPricePerAdult- serviceFeePerTicket)
totalRefundableAmountPerChild	decimal	每位儿童原单待退款总金额
refundFeePerChild	decimal	单个儿童退票手续费
usedFlightPricePerChild	decimal	单儿童已使用航段费
refundAmountPerChild	decimal	单个儿童退款金额(=totalRefundableAmountPerChild-refundFeePerChild-usedFlightPricePerChild-serviceFeePerTicket)
totalRefundableAmountPerBaby	decimal	每位婴儿原单待退款总金额
refundFeePerBaby	decimal	单个婴儿退票手续费
usedFlightPricePerBaby	decimal	单婴儿已使用航段费
refundAmountPerBaby	decimal	单个婴儿退款金额(=totalRefundableAmountPerBaby-refundFeePerBaby-usedFlightPricePerBaby-serviceFeePerTicket)
callbackUrl	string	退票单状态变更异步回调地址
refundFailedReason	string	退票失败原因
createTime	string	申请退票时间
refundPassengerList	refundPassenger[]	退票乘客(对象)数组
surname	string	乘客-姓
givenName	string	乘客-名
cardType	int	证件类型：护照 = 2,回乡证 = 3,台胞证 = 4,港澳通行证 = 5,台湾通行证 = 6,外国人永久居留身份证 = 8,港澳台居民居住证 = 9
cardNo	string	证件号
passengerType	string	乘客类型:成人票 = 1,儿童票 = 2,婴儿票 = 3
ticketNo	string	票号
psgStatus	int	退票乘客状态
psgStatusName	string	退票乘客状态名称
refundFlightList	refundFlight[]	退票航班(对象)数组
flightNo	string	航班号
fromAirportCode	string	出发机场三字码
toAirportCode	string	到达机场三字码
fromAirportName	string	出发机场名称
toAirportName	string	到达机场名称
fromCityName	string	出发城市名称
toCityName	string	到达城市名称
fromDateTime	string	出发日期及时间
toDateTime	string	到达日期及时间
cabinCode	string	舱位代码
cabinLevel	int	舱位等级：经济舱 = 1, 公务舱 = 2, 头等舱 = 3, 超级经济舱=4
cabinLevelName	string	舱位等级名称
airlineCode	string	航司二字码
airlineCompany	string	航司名称

JSON返回示例 :

{
  "data": {
    "refundNo": "IF26040221310432509T9322",
    "orderNo": "IF26040221310432509",
    "chaNo": null,
    "refundOrderStatus": 13,
    "refundOrderStatusName": "审核不通过交易结束",
    "refundType": 1,
    "refundPoundageAmount": 0.00,
    "refundAmount": 0.00,
    "refundSuccessTime": null,
    "refundTransactionNo": null,
    "refundTransactionMethods": null,
    "remark": "",
    "adultNumber": 1,
    "childNumber": 0,
    "babyNumber": 0,
    "refundFeePerAdult": null,
    "refundAmountPerAdult": null,
    "refundFeePerChild": null,
    "refundAmountPerChild": null,
    "refundFeePerBaby": null,
    "refundAmountPerBaby": null,
    "callbackUrl": null,
    "refundFailedReason": "测试",
    "createTime": "2026-04-02 22:04:26",
    "refundPassengerList": [
      {
        "surname": "LI",
        "givenName": "JIE",
        "cardType": 2,
        "cardNo": "EJ4056554",
        "passengerType": 1,
        "ticketNo": "123321",
        "psgStatus": 12,
        "psgStatusName": "退票失败",
        "psgID": 3
      }
    ],
    "refundFlightList": [
      {
        "flightID": 9,
        "chaFlightID": null,
        "flightNo": "CA4502",
        "fromAirportCode": "SHA",
        "toAirportCode": "CTU",
        "fromAirportName": "虹桥国际机场",
        "toAirportName": "双流国际机场",
        "fromCityName": "上海",
        "toCityName": "成都",
        "fromDateTime": "2026-04-11 20:45:00",
        "toDateTime": "2026-04-12 00:05:00",
        "cabinCode": "J",
        "cabinLevel": 2,
        "cabinLevelName": "公务舱",
        "airlineCode": "CA",
        "airlineCompany": "中国国航"
      },
      {
        "flightID": 10,
        "chaFlightID": null,
        "flightNo": "CA411",
        "fromAirportCode": "TFU",
        "toAirportCode": "HKG",
        "fromAirportName": "天府国际机场",
        "toAirportName": "赤腊角机场",
        "fromCityName": "成都",
        "toCityName": "香港",
        "fromDateTime": "2026-04-12 09:10:00",
        "toDateTime": "2026-04-12 11:50:00",
        "cabinCode": "C",
        "cabinLevel": 2,
        "cabinLevelName": "公务舱",
        "airlineCode": "CA",
        "airlineCompany": "中国国航"
      }
    ]
  },
  "success": true,
  "msg": "请求成功"
}

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

返回格式： json

请求方法： post

请求参数：

参数名称	类型	必填	说明
appKey	string	是	您申请的AppKey
type	int	是	改签类型(1自愿，10非自愿)
involuntaryProveUrls	string	否	非自愿改签证明文件地址（多个文件用'\|'分割，支持的文件类型有：pdf/jpg/jpeg/png），自愿改签无需填写
orderNo	string	是	采购单号
previousChaNo	string	否	上次改签成功后的改签单号，如果是二次或多次改签必传上一次的改签单号，采购单发起的改签该值为空即可
psgIDList	int[]	是	改签乘客ID列表（如果是在改签单（改签单号previousChaNo）基础上发起的改签，就传改签单详情的乘客ID，如果是由采购单发起的就传采购单详情接口返回的乘客ID）
remark	string	是	申请备注
callBackUrl	string	是	改签结果回调地址
chaTripList	chaTripInfo[]	是	改签行程列表
tripIndex	int	是	当前行程序号，必须和原单保持一致
originalFlightIDList	int[]	是	原航班ID 列表，当前行程中的，原航班列表，按行程分组（如果是在改签单（改签单号previousChaNo）基础上发起的改签，就传改签单详情的航班ID：FlightID ，在采购单上发起的就传改采购单里的航班ID）
flightList	flightInfo[]	是	改签新航班数组(每一段必须按照航段顺序)，，flightInfo类型详见【下单接口】请求参数中的 tripList->flightList字段类型

返回参数：

参数名称	类型	说明
success	bool	改签申请是否成功，成功时，data为改签单号，失败时msg为失败原因
data	string	当改签申请成功时（即success=true）改签单号

JSON请求示例 :

{
  "appKey": "您申请的AppKey",
  "type": 1,
  "involuntaryProveUrls": null,
  "orderNo": "IF26040912413534936",
  "previousChaNo": "IF26040912413534936C5454",
  "psgIDList": [
    8
  ],
  "remark": "行程取消了",
  "callBackUrl": null,
  "chaTripList": [
    {
      "tripIndex": 1,
      "originalFlightIDList": [
        17,
        18
      ],
      "flightList": [
        {
          "flightNo": "FM9204",
          "airlineCode": "FM",
          "airlineCompany": "上海航空",
          "fromAirportCode": "XIY",
          "fromAirportName": "咸阳国际机场",
          "fromCityName": "西安",
          "toAirportCode": "SHA",
          "toAirportName": "虹桥国际机场",
          "toCityName": "上海",
          "fromDateTime": "2026-04-16 20:00:00",
          "toDateTime": "2026-04-16 22:25:00",
          "fromTerminal": "T5",
          "toTerminal": "T2",
          "flyDuration": "02:25",
          "craftType": "325",
          "cabinCode": "J",
          "cabinLevel": 2
        },
        {
          "flightNo": "FM3011",
          "airlineCode": "FM",
          "airlineCompany": "上海航空",
          "fromAirportCode": "SHA",
          "fromAirportName": "虹桥国际机场",
          "fromCityName": "上海",
          "toAirportCode": "HKG",
          "toAirportName": "香港国际机场",
          "toCityName": "香港",
          "fromDateTime": "2026-04-17 09:10:00",
          "toDateTime": "2026-04-17 11:50:00",
          "fromTerminal": "1",
          "toTerminal": "1",
          "flyDuration": "02:40",
          "craftType": "333",
          "cabinCode": "I",
          "cabinLevel": 2
        }
      ]
    }
  ]
}

JSON返回示例 :

失败示例：
{
    "data": null,
    "success": false,
    "msg": "乘机人[Wang/Tao]处于‘已改签’状态，暂不能申请改签"
}

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

返回格式： json

请求方法： get/post

请求示例： http://接口域名/iFlight/chaAutoPay?appKey=您申请的AppKey&chaNo=IF26040912413534936C9684&payAmount=1250

请求参数：

参数名称	类型	必填	说明
appKey	string	是	您申请的AppKey
chaNo	string	是	改签单号
payAmount	decimal	是	支付金额

返回参数：

参数名称	类型	说明
success	bool	是否支付成功（支付接口同步就返回支付结果了，所以支付结果无需回调，支付成功后等待出票即可，出票结果会回调的，亦可轮询订单同步状态）
msg	string	支付失败时，失败原因

JSON返回示例 :

失败示例：
{
    "data": null,
    "success": false,
    "msg": "只有‘需补款待支付’状态下改签单才能支付"
}

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

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

返回格式： json

请求方法： get/post

请求示例： http://接口域名/iFlight/cancelChange?appKey=您申请的AppKey&chaNo=IF26040821120323552C2963

请求参数：

参数名称	类型	必填	说明
appKey	string	是	您申请的AppKey
chaNo	string	是	改签单号

返回参数：

参数名称	类型	说明
success	string	是否取消成功，取消失败时msg为失败原因
msg	string	取消失败时msg为失败原因

JSON返回示例 :

失败示例：
{
    "data": null,
    "success": false,
    "msg": "只有‘新申请待审核’或‘需补款待支付’状态下才能申请取消改签，当前状态为‘改签已取消交易结束’。"
}

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

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

返回格式： json

请求方法： get/post

请求示例： http://接口域名/iFlight/getChaOrderDetail?appKey=您申请的AppKey&chaNo=IF26040310550199434C4613

请求参数：

参数名称	类型	必填	说明
appKey	string	是	您申请的AppKey
chaNo	string	是	改签单号

返回参数：

参数名称	类型	说明
chaNo	string	改签单号
orderNo	string	采购单号
previousChaNo	string	上一次成功改签单号，有值表示当前是多次改签，为null表示当前是首次改签
changeType	int	改签类型(自愿改签 = 1 ,非自愿改签 = 10)
chaOrderAmount	decimal	改签单需支付金额
realPayAmount	decimal	改签单实付金额，成功才有值
chaOrderStatus	int	新申请待审核 = 21, 审核不通过交易结束 = 22,需补款待支付 = 23,已补款待处理 = 24,无法改签退款中 = 25,无法改签已退款交易结束 = 26, 改签成功交易结束 = 27,改签已取消交易结束 = 28,改签处理中 = 29
payStatus	int	支付状态：0未支付， 1已支付
payTime	string	支付时间
payLimitTime	string	改签支付，参考时限
remark	string	改签备注
adultNumber	int	改签成人数
childNumber	int	改签儿童数
babyNumber	int	改签婴儿数
serviceFeePerTicket	decimal	单人改签服务费(平台收取,不分成人儿童婴儿)
adultDifferenceFare	decimal	单成人升舱费 (含票差和税差，航司收取)
adultChangeFee	decimal	单成人改签费(航司收取)
adultTotalFee	decimal	单成人总应补款金额（= 升舱费+改签费+服务费）
childDifferenceFare	decimal	单儿童升舱费 (含票差和税差，航司收取)
childChangeFee	decimal	单儿童改签费(航司收取)
childTotalFee	decimal	单儿童总应补款金额（= 升舱费+改签费+服务费）
babyDifferenceFare	decimal	单婴儿升舱费 (含票差和税差，航司收取)
babyChangeFee	decimal	单婴儿改签费(航司收取)
babyTotalFee	decimal	单婴儿总应补款金额（= 升舱费+改签费+服务费）
callbackUrl	string	改签单状态变更异步回调地址
chaCompleteTime	string	改签完成时间
chaFailedReason	string	改签失败原因
chaOriginalFlightID	string	改签原航班ID(多个英文逗号分隔)
involuntaryProveUrls	string	非自愿改签证明文件地址（多个文件用'\|'分割，支持的文件类型有：pdf/jpg/jpeg/png），自愿改签无需填写
createTime	string	改签申请时间
chaPassengerList	chaPassenger[]	改签乘客列表
psgID	int	改签乘客ID ，申请退票或再次改签时需要用到该值
surname	string	乘客-姓
givenName	string	乘客-名
nationalityCode	string	国籍二字码
nationalityCName	string	国籍中文名
cardType	int	证件类型
cardNo	string	证件号
cardValidEndDate	string	证件有效期截止日期 (格式：yyyy-MM-dd)，不能小于起飞日期
birthday	string	出生日期
sex	int	性别（对应枚举Sex值 0=未知 1=男 2=女）
mobile	string	手机号
passengerType	int	乘客类型:成人票 = 1,儿童票 = 2,婴儿票 = 3 (ps:航班起飞日期算起，>12岁（含）成人；2岁（含）~12岁（不含）为儿童；14天（含）~2岁（不含）以下为婴儿 )
ticketNo	string	改签成功后的新票号，多个英文逗号分隔
oldTicketNo	string	原票号，多个英文逗号分隔
psgStatus	int	乘客状态（对应枚举IFlightPsgStatus值）
psgStatusName	string	乘客状态名称
chaFlightList	chaFlightInfo[]	改签航班(对象)数组
flightID	string	改签航班ID（退票或再次改签时需要用到）
flightNo	string	航班号
tripIndex	string	行程索引，从1开始，当前航班是订单中第几程的
fromAirportCode	string	出发机场三字码
toAirportCode	string	到达机场三字码
fromAirportName	string	出发机场名称
toAirportName	string	到达机场名称
fromCityName	string	出发城市名称
toCityName	string	到达城市名称
fromDateTime	string	出发时间(精确到分钟)
toDateTime	string	到达时间(精确到分钟)
fromTerminal	string	出发航站楼
toTerminal	string	到达航站楼
airlineCode	string	航司二字码
airlineCompany	string	航空公司名称
flyDuration	string	飞行时长，格式HH:mm，如：3:05，表示飞行 3小时5分钟
craftType	string	机型
cabinCode	string	舱位代码
cabinLevel	int	舱位等级：经济舱 = 1, 公务舱 = 2, 头等舱 = 3, 超级经济舱=4
isShareFlight	bool	是否为共享航班
realFlightNo	string	当为共享航班时，实际承运航班号
isRealChange	bool	否真实改签航班，false表示当前航班是原单号中未改签部分的航班，true表示本次真实改签到的新航班

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

在线接口文档中心

国际机票

请求参数：

返回参数：

JSON请求示例 :

JSON返回示例 :

请求参数：

返回参数：

JSON请求示例 :

JSON返回示例 :

请求参数：

返回参数：

JSON请求示例 :

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON请求示例 :

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON请求示例 :

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：

JSON返回示例 :

请求参数：

返回参数：