Cancellation | ConfirmCancellation

Confirm whether the cancellation result is accepted. On the condition that the applyType parameter is set to QUOTATION, the SubmitCancellation API call is successful, and the cancellationStatus in the result retrieved from the GetCancellationDetail API is VALID_QUOTE.

Notice:
Product Scope ：FareMarket, Techhub

POST

/flight/cancellation

Parameter

Field Mandatory Type Scope Description
action required String ConfirmCancellation
key required String API security key applied from AeroHub
signature required String Refer to Guideline to generate.
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
  cancellationNum required String Cancellation number generated by SubmitCancellation
  attachments optional Object[] The field is required when the “cancellationStatus” is “REQ_ASSIST”.
The supported file types are as follows, JPG, JPEG, PNG, PDF.
Note: New attachments will overwrite the existing ones. Therefore, you must upload the complete set of attachments each time you perform an upload operation.
    name required String File name with extension.
    url required String This field uses the url returned by the UploadAttachment interface.

Request_Example:

{
  "action": "ConfirmCancellation",
  "key": "mkk5VmNZYKiGEO26",
  "signature": "uaQb6MG71EAPTdmUoKpP+mlSh//2GRB8zOxCAzWok2w=",
  "timestamp": "1685116516",
  "request": {
    "cancellationNum": "R20240409152629973",
    "attachments": [
        {
            "name": "QA.JPG",
            "url": "http://lffarebox.oss-cn-hongkong.aliyuncs.com/upload%2F2025121811%2F2025121811_0.JPG"
        }
    ]
  }
}

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
cancellationNum String Cancellation number generated by SubmitCancellation

Success-Response:

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

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
1102 Account disabled, please contact with account administrator
3201 The cancellation id does not exist
3202 The current status does not allow submit
3203 Cancellation ID {refund_id} refund has been submitted, please do not reapply

Error-Response

{
    "status": 1000,
    "msg": "General system error"
}
Author：AeroHub  Create time：2024-09-10 13:31
Last editor：admin  Update time：2026-01-22 17:43