RefundConfirming

POST

/api/new/refundConfirming.do

Confirmation of Refund Interface. By invoking the refundConfirm interface, FR24 will be notified to process the refund.

It supports two scenarios:

Call this interface to initiate a refund after pricing is completed.

Support directly calling this API to initiate a refund.

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

refundOrderNo

string

Refund order number

optional

Either the refund order number or ticket order number is required

tktOrderNo

string

Ticket order number

optional

Either the refund order number or ticket order number is required

passengers

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

Refund passenger information

optional

It is required when the ticket order number is provided only.

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}]

Refund segment information

optional

Required when the ticket order number is provided only.

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

Example:

remarks

string

Additional notes on the reason for ticket refund

optional

on the reason for ticket refund.

fileId

array [object]

Proof documents

optional

File Id

Example

{
  "authentication": {
    "sign": "{{sign}}",
    "timestamp": "{{timestamp}}"
  },
  "refundOrderNo": "17981694032154624",
  "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": ""
}

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/refundConfirming.do' \
--header 'Accept-Encoding;' \
--header 'appKey;' \
--header 'content-Type: application/json' \
--data-raw '{
    "authentication": {
        "sign": "",
        "timestamp": ""
    },
    "refundOrderNo": "17981694032154624",
    "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": ""
}'

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

required

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": "NEWAPI24091915080394207576",
  "code": "000000",
  "message": "ok",
  "processingTime": 617,
  "data": {
    "refundOrderNo": "17920360528416768",
    "refundOrderStatus": "71",
    "tktOrderNo": "17920313095622656"
  }
}

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

RefundRequest

VoidRequest