FR24 OpenAPI

RefundRequest 退票申请接口

POST

/api/new/refundRequest.do

调用refundRequest提交退票申请，FR24会在核价完成后，使用orderchangeInforming接口推送核价结果
若合作方无需核价，可调用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 时间戳

必需

单位：秒

tktOrderNo

string

FR24出票订单号

必需

正则匹配:

^\d*$

partnerOrderNo

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}}"
  },
  "partnerOrderNo": "",
  "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": [
    "{{fileId}}"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

    "authentication": {

        "sign": "",

        "timestamp": "{{time}}"

    },

    "partnerOrderNo": "",

    "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": [

        "{{fileId}}"

    ]

}'

返回响应

🟢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": "NEWAPI2501171215007670829",
  "code": "000000",
  "message": "成功",
  "processingTime": 4368,
  "data": {
    "refundOrderNo": "18599158552006656",
    "refundOrderStatus": "70",
    "tktOrderNo": "18599020016177152"
  }
}

修改于 2025-03-11 07:07:01

ReissueRequest 改期申请接口

RefundConfirming 退票确认接口