FR24 OpenAPI

RefundConfirming 退票确认接口

POST

/api/new/refundConfirming.do

核价完成后，采购确定退票，通过退票确认接口refundConfirm确认退票。

请求参数

Header 参数

Accept-Encoding

string

必需

使用gzip压缩格式

默认值:

gzip, deflate, br

content-Type

string

响应格式

必需

默认值:

application/json

appKey

string

用户账户

必需

默认值:

Body 参数application/json

authentication

object

用户认证信息

必需

sign

string

签名

必需

appkey + appsecret + timestamp加密后的字符串，加密见附录

timestamp

string

使用 unix 时间戳

必需

单位：秒

refundOrderNo

string

退票订单号

可选

退票订单号和出票订单号二者必填其一

tktOrderNo

string

出票订单号

可选

退票订单号和出票订单号二者必填其一

passengers

array[object (退票乘客信息) {4}]

退票乘客信息

可选

当仅传了出票订单号时，必填

paxId

string

乘客id

必需

name

string

乘客姓名

必需

姓/名

birthday

string

乘客生日

可选

格式：YYYY-MM-DD

正则匹配:

^\d{4}-\d{2}-\d{2}$

gender

enum<string>

乘客性别

可选

枚举值:

segments

array [object {6}]

退票航段信息

可选

当仅传了出票订单号时，必填

carrier

string

销售航司

必需

使用IATA航司标准二字代码

flightNo

string

航班号

必需

和carrier搭配使用
BA1234，carrier为BA，flightNo为1234

depAirport

string

出发机场

必需

使用IATA机型标准三字代码

depTime

string <date-time>

出发时间

必需

格式：YYYY-MM-DDThh:mm
比如2022-10-21T21:23
起飞机场所在地时间

arrAirport

string

到达机场

必需

使用IATA机场标准三字代码

arrTime

string <date-time>

到达时间

必需

格式：YYYY-MM-DDThh:mm
到达机场所在地时间

refundReason

enum<string>

退票理由

必需

枚举值:

0123

remarks

string

备注

可选

fileData

array [object {1}]

证明文件

可选

id取自file upload接口

fileId

string

文件id

可选

示例

{

    "authentication": {

        "sign": "{{sign}}",

        "timestamp": "{{time}}"

    },

    "refundOrderNo": "{{refundOrderNo}}",

    "tktOrderNo": "{{orderNo_detail}}",

    "passengers": [

        {

            "paxId": "1",

            "name": "{{pname_detail}}",

            "birthday": "{{pbirthday_detail}}",

            "gender": "{{pgender_detail}}"

        }

    ],

   "segments":   [

        {

            "carrier": "{{carrier_detail}}",

            "flightNo": "{{flightNo_detail}}",

            "depAirport": "{{depAirport_detail}}",

            "depTime": "{{depTime_detail}}",

            "arrAirport": "{{arrAirport_detail}}",

            "arrTime": "{{arrTime_detail}}"

        }

    ],

    "refundReason": "1",

    "remarks": ""

    "fileId": [

       "DM/ITIz9fuE1AYGYc5sTGTopjvd6iZ6VCMQ==",

      " DM/ITIz9fuE1AYGYc5sTGTopjvd6iZ6VCME=="

    ]

}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://flight-test.flightroutes24.com/api/new/refundConfirming.do' \
--header 'Accept-Encoding;' \
--header 'appKey;' \
--header 'content-Type: application/json' \
--data-raw '{

    "authentication": {

        "sign": "",

        "timestamp": "{{time}}"

    },

    "refundOrderNo": "{{refundOrderNo}}",

    "tktOrderNo": "{{orderNo_detail}}",

    "passengers": [

        {

            "paxId": "1",

            "name": "{{pname_detail}}",

            "birthday": "{{pbirthday_detail}}",

            "gender": "{{pgender_detail}}"

        }

    ],

   "segments":   [

        {

            "carrier": "{{carrier_detail}}",

            "flightNo": "{{flightNo_detail}}",

            "depAirport": "{{depAirport_detail}}",

            "depTime": "{{depTime_detail}}",

            "arrAirport": "{{arrAirport_detail}}",

            "arrTime": "{{arrTime_detail}}"

        }

    ],

    "refundReason": "1",

    "remarks": ""

    "fileId": [

       "DM/ITIz9fuE1AYGYc5sTGTopjvd6iZ6VCMQ==",

      " DM/ITIz9fuE1AYGYc5sTGTopjvd6iZ6VCME=="

    ]

}'

返回响应

🟢200OK

application/json

Body

traceId

string

追溯码

必需

code

string

状态码

必需

000000 代表成功，其他代表失败

message

string

状态说明

必需

processingTime

number

处理时长

必需

单位：ms

>= 0

data

object (退票响应)

返回的所有数据

必需

当code为”失败“时，内容为空

refundOrderNo

string

退票订单号

必需

tktOrderNo

string

出票订单号

必需

refundOrderStatus

string

退票订单状态

必需

示例

{
  "traceId": "NEWAPI2501171216283290830",
  "code": "000000",
  "message": "成功",
  "processingTime": 1091,
  "data": {
    "refundOrderNo": "18599158552006656",
    "refundOrderStatus": "71",
    "tktOrderNo": "18599020016177152"
  }
}

修改于 2025-03-13 07:16:08

RefundRequest 退票申请接口

VoidRequest 废票提交接口