SubmitCancellation

Cancellation | SubmitCancellation

Initiates a formal request to cancel a booking and calculate potential refund amounts. This is the first step in the cancellation request lifecycle.Only bookings in “Confirmed” or “Ticketed” status are eligible for cancellation requests.

When applyType = QUOTATION, the response will synchronously return the quotation result if available. The quotation result structure is aligned with ReceiveCancellationNotify for easier client-side integration.

Notice:
Product Scope: FareMarket and TechHub

POST

/flight/cancellation

Parameter

Request_Example:

{
    "request": {
        "orderNum": "2028200311520366592",
        "cancellationCategory": "VOLUNTARY_CANCELLATION",
        "applyType": "QUOTATION",
        "segments": [
            {
                "depAirport": "LAS",
                "arrAirport": "LAX",
                "flightNumber": "AA1399"
            }
        ],
        "passengers": [
            {
                "firstName": "HUGO",
                "lastName": "OLIVEIRA",
                "birthday": "19900713"
            }
        ]
    },
      "key": "n93mPT7WzN6cLKC5",
      "signature": "YhQ2EoBQOfOnf/EOnuuuK5i+K+ncydeQhjFpoxYiEMo=",
      "timestamp": 1685116518,
    "action": "SubmitCancellation"
}

Response

Success-Response - TICKET:

{
  "status": 0,
  "msg": "Success",
  "cancellationNum": "R20240409152629973"
}

Success-Response - QUOTATION:

{
  "status": 0,
  "msg": "Success",
  "cancellationNum": "R20240409152629973",
  "cancellationCategory": "VOLUNTARY_CANCELLATION",
  "cancellationStatus": "VALID_QUOTE",
  "endTime": "20260317123045",
  "uneligibleDetail": "",
  "currency": "USD",
  "amount": 500.0,
  "refundAmount": 494.0,
  "serviceFee": 6.0,
  "refundCategory": "ORIGINAL_PAYMENT",
  "creditVoucher": [
    {
      "currency": "USD",
      "amount": 100.0,
      "detail": "Voucher No.12345, valid for 1 year"
    }
  ],
  "passengers": [
    {
      "firstName": "John",
      "lastName": "Doe",
      "birthday": "19900101",
      "pnr": "ABC123",
      "ticketNumber": "1234567890",
      "amount": 250.0,
      "refundAmount": 247.0,
      "serviceFee": 3.0
    },
    {
      "firstName": "Jane",
      "lastName": "Smith",
      "birthday": "19850515",
      "pnr": "XYZ456",
      "ticketNumber": "0987654321",
      "amount": 250.0,
      "refundAmount": 247.0,
      "serviceFee": 3.0
    }
  ],
  "customerRemark": "Requesting full refund due to cancellation",
}

Status Code

Error-Response

{
    "status": 1000,
    "msg": "General system error"
}