Change | ReceiveChangeNotify

After processing the change, the result notification is sent to the customer.

Notice:
Product Scope ：FareMarket

POST

url that provided by customer

Parameter

Field Mandatory Type Scope Description
action required String ReceiveChangeNotify
timestamp required Int The ‘timestamp’ field should be a 10-digit Unix timestamp in seconds, used for encryption and data verification.
version optional String API version information, e.g. 3.2.0
request required Object
  orderNum required String AeroHub Order number generated by Commit. Unique ID for bookings for FareMarket
  changeNum required String Rescheduling order number.
  changeType required String Type of rescheduling:
VOLUNTARY: voluntary change
INVOLUNTARY: involuntary change
INFORMATION_UPDATER: information update
OTHER: other reasons
Refer to appendix ‘Change Type List’ for details
  changeReason optional String Resason for rescheduling:
FLIGHT_CHANGE: flight change
FLIGHT_CANCEL: flight cancel
OTHER: other reasons
The field is required when the “changeType” is “INVOLUNTARY”
Refer to appendix ‘Change Reason List’ for details
  customerRemark optional String Customer remarks.
  changeStatus required String Rescheduling order status:
PENDING_QUOTE: pending for quotation
PENDING_CONFIRMATION: pending for confirmation
QUOTE_CONFIRMED: confirmed
PROCESSING: under processing
COMPLETED: completed
REJECTE：rejected
WITHDRAWN：withdrawned
TIMED_OUT：automatically cancelled if not processed for more than 30 minutes after PENDING_CONFIRMATION.
Refer to appendix ‘Change Status List’ for details
  attachmentStatus optional Int Attachment Status:
0: No attachment required
1: Attachment required
  rejectReason optional String Rejection reason.
  totalChangeFee required Float Total rescheduling fee. Without service fee.
  serviceCharge required Float Service fee.
  quotes optional Object[] Quotation details.
    ageType required Int Passenger type:
0: adult
1: child
2: infant
    changeFee optional Float Rescheduling fee per person.
    cabinFee optional Float Cabin difference per person.
  attachments optional Object[] Attachment. The field is required when the “changeType” is “INFORMATION_UPDATER”. The supported file types are as follows, JPG, JPEG, PNG, PDF. Maximum single upload file size: 10M.
    name required String File name with extension.
    url required String Attach url
  passengers required Object[] Passenger information for rescheduling.
    originalPassengers required Object Original passenger information.
      firstName required String Passenger first name. If there is a middle name, connect it with a space like “firstname middlename”.
      lastName required String Passenger last name.
      ageType required Int Passenger type:
0: adult
1: child
2: infant
      birthday optional String Passenger birthday, formatted with “YYYYMMDD”.
      gender optional String Passenger gender:
M: male
F: female
      nationality optional String Passenger nationality, 2-letter country code.
      cardNum optional String Passenger identity number, maximum 15 characters.
      cardExpired optional String The expiration date of the identity card, formatted with “YYYYMMDD”.
    updatedPassengers optional Object Updated passenger information.
      firstName required String Passenger first name. If there is a middle name, connect it with a space like “firstname middlename”.
      lastName required String Passenger last name.
      ageType required Int Passenger type:
0: adult
1: child
2: infant
      birthday optional String Passenger birthday, formatted with “YYYYMMDD”.
      gender optional String Passenger gender:
M: male
F: female
      nationality optional String Passenger nationality, 2-letter country code.
      cardNum optional String Passenger identity number, maximum 15 characters.
      cardExpired optional String The expiration date of the identity card, formatted with “YYYYMMDD”.
  segments optional Object[] Itinerary Information for rescheduling.
    originalSegments required Object[] Original itinerary information.
      tripType required Int Trip type:
1: outbound
2: inbound
      segmentNumber required Int Segment number, starts from 1.
      flightNumber required String Flight number, e.g. CA123.
      depAirport required String Departure airport, IATA 3-letter code.
      arrAirport required String Arrival airport, IATA 3-letter code.
      depTime required String Departure date and time, formatted with “YYYYMMDDHHMM”.(e.g. 201203100315 represents 2012/03/10 03:15)
      arrTime required String Arrival date and time, formatted with “YYYYMMDDHHMM”.（e.g. 201203101305 represents 2012/03/10 13:05)
    updatedSegments required Object[] Updated itinerary information.
      tripType required Int Trip type:
1: outbound
2: inbound
      segmentNumber required Int Segment number, starts from 1.
      flightNumber required String Flight number, e.g. CA123.
      depAirport required String Departure airport, IATA 3-letter code.
      arrAirport required String Arrival airport, IATA 3-letter code.
      departureDate required String Departure date, formatted with “YYYYMMDD”.
      depTime optional String Departure date and time, formatted with “YYYYMMDDHHMM”.(e.g. 201203100315 represents 2012/03/10 03:15)
      arrTime optional String Arrival date and time, formatted with “YYYYMMDDHHMM”.(e.g. 201203101305 represents 2012/03/10 13:05)
  tickets optional Object[] Ticket number list. It will have return data only when the “ChangeStatus” is “COMPLETED”, and only the updated ticket information will be returned.
    firstName required String Passenger first name. If there is a middle name, connect it with a space like “firstname middlename”.
    lastName required String Passenger last name.
    tripType required Int Trip type:
1: outbound
2: inbound
    segmentNumber required Int Segment number.
    flightNumber required String Flight number.
    ticketNumber optional String Ticket number returns from airline.
    pnr optional String PNR returns from airline.

Request_Example:

{
    "action": "ReceiveChangeNotify",
    "timestamp": 1740392074,
    "version": "3.2.0",
    "request": {
        "orderNum": "2018536338294464512",
        "changeNum": "C20260203164524245",
        "changeType": "VOLUNTARY",
        "changeReason": "",
        "customerRemark": "请直接拒单",
        "changeStatus": "REJECTE",
        "attachmentStatus": 0,
        "rejectReason": "Non-changeable",
        "totalChangeFee": 0,
        "serviceCharge": 0,
        "currency": "USD",
        "quotes": [],
        "attachments": [
            {
                "url": "https:\/\/cdn.letsflytech.com\/upload\/2024100416\/ac985a0729e272868468e03b9e7ba69e.png",
                "name": "11.png"
            },
            {
                "url": "https:\/\/cdn.letsflytech.com\/upload\/2024100416\/84d6a032e44b6c95c6410391bf9e993a.png",
                "name": "22.png"
            },
            {
                "url": "https:\/\/cdn.letsflytech.com\/upload\/2024100416\/5a723d98cfcd80391db47bfa1f4be75c.png",
                "name": "33.png"
            },
            {
                "url": "https:\/\/cdn.letsflytech.com\/upload\/2024100416\/3fd538385f3c7249f45a35791dc7e233.png",
                "name": "44.png"
            }
        ],
        "passengers": {
            "originalPassengers": [
                {
                    "firstName": "QAZ",
                    "lastName": "QWE",
                    "ageType": 0,
                    "birthday": "19900103",
                    "gender": "F",
                    "nationality": "FR",
                    "cardNum": "QAZXCV",
                    "cardExpired": "2029-03-21"
                }
            ],
            "updatedPassengers": []
        },
        "segments": {
            "originalSegments": [
                {
                    "tripType": 1,
                    "segmentNumber": 1,
                    "flightNumber": "PC2000",
                    "depAirport": "SAW",
                    "arrAirport": "AYT",
                    "departureDate": "20240329",
                    "depTime": "20240329 060500",
                    "arrTime": "20240329 072000"
                }
            ],
            "updatedSegments": [
                {
                    "tripType": 1,
                    "segmentNumber": 1,
                    "flightNumber": "PC2000",
                    "depAirport": "SAW",
                    "arrAirport": "BJS",
                    "departureDate": "20241029",
                    "depTime": "",
                    "arrTime": ""
                },
                {
                    "tripType": 1,
                    "segmentNumber": 2,
                    "flightNumber": "PC2000",
                    "depAirport": "BJS",
                    "arrAirport": "AYT",
                    "departureDate": "20241129",
                    "depTime": "",
                    "arrTime": ""
                }
            ]
        },
        "tickets": [{
            "firstName": "QAZ",
            "lastName": "QWE",
            "tripType": 1,
            "segmentNumber": 1,
            "flightNumber": "PC2000",
            "ticketNumber": "AOEXWS",
            "pnr": "AOEXWS"
        }]
    }
}

Response

Field Type Description
status Int 0 for success, others for failure, refer to status error appendix for details
msg String Return message, maximum 64 char
changeNum String Rescheduling order number.

Success-Response:

{
    "status": 0,
    "msg": "success",
    "changeNum": "C20240409152629973"
}

Status Code

Name Description
1000 General system error
1001 Request parameters or part of parameters missing
1002 Invalid Action
1003 API request timeout, please request again
1004 Invalid request parameter
1005 Service system error
1101 Authentication fail, wrong signature

Error-Response

{
    "status": 1000,
    "msg": "General system error"
}
Author：admin  Create time：2026-02-04 11:17
Last editor：admin  Update time：2026-02-04 13:52