RefundRequest

POST

/api/new/refundRequest.do

Refund Request Interface. By invoking the refundRequest interface, a refund pricing application will be initiated to FR24.
The pricing result will be pushed through the orderChangeInforming API

Request

Header Params

Accept-Encoding

string

required

Use gzip compression format

Default:

gzip, deflate, br

content-Type

string

required

Response format

Default:

application/json

appKey

string

required

User account

Default:

Body Params application/json

authentication

object

User authentication

required

sign

string

Signature

required

The encrypted string of appkey, appSecret and timestamp.Refer to Appendix I

timestamp

string

Unix timestamp

required

measuring in Second

tktOrderNo

string

FR24 Ticket Order Number

required

Match pattern:

^\d*$

partnerOrderNo

string

Partner order number

optional

passengers

array[object (Refund passenger information) {4}]

Passenger information

required

paxId

string

Passenger’s Id

required

name

string

Passenger’s name

required

English capital LastName/FirstName Spaces”␣” are not permitted

birthday

string

Passenger’s date of birth

optional

YYYY-MM-DD

Match pattern:

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

gender

enum<string>

Passenger’s gender

optional

Allowed values:

segments

array [object {6}]

Segments for ticket refund

optional

If not provided, it represents a refund for the entire itinerary of the passenger's order.

carrier

string

Selling carrier

required

Airline code by IATA

flightNo

string

Flight number

required

used with carrier.E.g. BA1234, carrier is BA, flightNo is 1234.

depAirport

string

Departure airport

required

code by IATA

depTime

string <date-time>

Departure time

required

YYYY-MM-DDThh:mmDeparture airport local timeE.g., 2022-10-21T21:23

arrAirport

string

Arrival airport

required

code by IATA

arrTime

string <date-time>

Arrival time

required

YYYY-MM-DDThh:mmArrival airport local time.

refundReason

enum<string>

Refund reason

required

Allowed values:

0123

remarks

string

Additional notes on the reason for ticket refund

optional

Additional notes on the reason for ticket refund.

fileData

array [object {1}]

Proof documents

optional

with the ID obtained from the file upload interface.

fileId

string

Documents id

optional

Example

{
  "authentication": {
    "sign": "{{sign}}",
    "timestamp": "{{timestamp}}"
  },
  "partnerOrderNo": "",
  "tktOrderNo": "17981635587543040",
  "passengers": [
    {
      "paxId": "1",
      "name": "YGVU/ZTMII",
      "birthday": "1981-07-21",
      "gender": "M"
    }
  ],
  "segments": [
    {
      "segmentId": "82ba60be4c9f9af3c2cdb06dd78403ae",
      "duration": 1612,
      "carrier": "FD",
      "flightNo": "2271",
      "codeShare": false,
      "operatingCarrier": "FD",
      "operatingFlightNo": "FD2271",
      "aircraftCode": "空客A300",
      "depAirport": "SIN",
      "depTerminal": "T1",
      "depTime": "2024-11-17T03:18",
      "arrAirport": "BKK",
      "arrTerminal": "T2",
      "arrTime": "2024-11-18T05:10",
      "stopAirport": null,
      "stopDuration": null
    },
    {
      "segmentId": "cdabc75289fb9dcf917526324de0e878",
      "duration": 1492,
      "carrier": "FD",
      "flightNo": "8750",
      "codeShare": false,
      "operatingCarrier": "FD",
      "operatingFlightNo": "FD8750",
      "aircraftCode": "空客A300",
      "depAirport": "DMK",
      "depTerminal": "T1",
      "depTime": "2024-10-24T03:18",
      "arrAirport": "SIN",
      "arrTerminal": "T2",
      "arrTime": "2024-10-25T05:10",
      "stopAirport": null,
      "stopDuration": null
    }
  ],
  "refundReason": "1",
  "remarks": "",
  "fileData": []
}

Request samples

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": ""
    },
    "partnerOrderNo": "",
    "tktOrderNo": "17981635587543040",
    "passengers": [
        {
            "paxId": "1",
            "name": "YGVU/ZTMII",
            "birthday": "1981-07-21",
            "gender": "M"
        }
    ],
    "segments": [
        {
            "segmentId": "82ba60be4c9f9af3c2cdb06dd78403ae",
            "duration": 1612,
            "carrier": "FD",
            "flightNo": "2271",
            "codeShare": false,
            "operatingCarrier": "FD",
            "operatingFlightNo": "FD2271",
            "aircraftCode": "空客A300",
            "depAirport": "SIN",
            "depTerminal": "T1",
            "depTime": "2024-11-17T03:18",
            "arrAirport": "BKK",
            "arrTerminal": "T2",
            "arrTime": "2024-11-18T05:10",
            "stopAirport": null,
            "stopDuration": null
        },
        {
            "segmentId": "cdabc75289fb9dcf917526324de0e878",
            "duration": 1492,
            "carrier": "FD",
            "flightNo": "8750",
            "codeShare": false,
            "operatingCarrier": "FD",
            "operatingFlightNo": "FD8750",
            "aircraftCode": "空客A300",
            "depAirport": "DMK",
            "depTerminal": "T1",
            "depTime": "2024-10-24T03:18",
            "arrAirport": "SIN",
            "arrTerminal": "T2",
            "arrTime": "2024-10-25T05:10",
            "stopAirport": null,
            "stopDuration": null
        }
    ],
    "refundReason": "1",
    "remarks": "",
    "fileData": []
}'

Responses

🟢200OK

application/json

Body

traceId

string

Traceability code

required

traceId can help locate problems when problems occur between partners and FR24.

code

string

Status code

required

000000 means success, others mean failure.

message

string

Error code message

required

processingTime

number

Processing time

required

measuring in ms

data

object (Refund response)

All the data returned according to the Request

optional

All the data returned according to the Request.
If code returns failure, data would be empty.

refundOrderNo

string

Refund order number

required

tktOrderNo

string

Ticketing order number

required

refundOrderStatus

string

Refund order status

required

Example

{
  "traceId": "NEWAPI24091915074669607575",
  "code": "000000",
  "message": "ok",
  "processingTime": 2386,
  "data": {
    "refundOrderNo": "17920360528416768",
    "refundOrderStatus": "70",
    "tktOrderNo": "17920313095622656"
  }
}

Modified at 2025-04-17 06:24:00

ReissueRequest

RefundConfirming