Notification | ReceiveCancellationNotify

A webhook/callback mechanism that delivers refund quote results and final outcomes of a cancellation request. Since refund processing involves coordination with airlines and payment gateways, this notification serves as the official confirmation of the transaction’s completion.

Notice:
Product Scope ：FareMarket
Key Trigger Scenarios: Notifications are dispatched when the quotation result becomes available, or when the request reaches a terminal state.
Implementation Requirements: Your endpoint should be idempotent to handle potential duplicate notifications gracefully.Return a 200 OK response to stop the system’s retry mechanism.

POST

Callback URL provided by the customer.

Parameter

Field Mandatory Type Scope Description
action required String ReceiveCancellationNotify
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
  cancellationCategory required String For more details visit: Cancellation Category
  cancellationStatus required String For more details visit: Cancellation Status
  endTime required String The time when the operation is completed, the review completion time/cancellation success time/cancellation rejection time, format: YYYYMMDDHHMMSS
  uneligibleDetail optional String Reason the cancellation request is ineligible.
  currency required String Currency of the refund amounts.
  amount required Float Total booking amount.
  refundAmount required Float Refund amount returned by the airline.
  serviceFee required Float Cancellation service fee charged by AeroHub.
  refundCategory required String For more details visit: Refund Category
  creditVoucher optional Object[] the credit voucher
    currency optional String the currency of credit voucher
    amount optional Float Amount of credit voucher
    detail optional String Credit voucher details（No.，Introduction to use, etc.）
  passengers required Object[] Ticket Information for Cancellation
    firstName required String FirstName，in case of middle name, format is firstName middleName
    lastName required String LastName
    birthday required String Birthday, format: YYYYMMDD
    pnr required String PNR from airline
    ticketNumber required String Ticket Number from airline
  customerRemark optional String Customer remarks
  aeroHubRemark(Deprecated) optional String AeroHub Remarks

Request_Example:

{
  "action": "ReceiveCancellationNotify",
  "request": {
    "amount": 134.74,
    "endTime": "",
    "currency": "USD",
    "passengers": [
      {
        "pnr": "EXOACJ",
        "birthday": "19590509",
        "lastName": "LK",
        "firstName": "Xianming",
        "ticketNumber": "EXOACJ"
      },
      {
        "pnr": "EXOACJ",
        "birthday": "19590509",
        "lastName": "LK",
        "firstName": "Xianming",
        "ticketNumber": "EXOACJ"
      }
    ],
    "serviceFee": 0,
    "refundAmount": 101.08,
    "aeroHubRemark": "",
    "creditVoucher": [
      {
        "amount": 0,
        "detail": "",
        "currency": ""
      }
    ],
    "customerRemark": "",
    "refundCategory": "ORIGINAL_PAYMENT",
    "cancellationNum": "R20260306181809500",
    "uneligibleDetail": "",
    "cancellationStatus": "VALID_QUOTE",
    "cancellationCategory": "CANCELLATION_DUE_TO_ILLNESS"
  },
  "version": "3.2.0",
  "timestamp": 1772792368
}

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 Aerohub

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

Error-Response

{
    "status": 1000,
    "msg": "General system error"
}
Author：AeroHub  Create time：2024-01-24 14:38
Last editor：AeroHub  Update time：2026-03-19 18:20