{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Cancellation and refund","meta":[{"name":"robots","content":"noindex"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"cancellation-and-refund","__idx":0},"children":["Cancellation and refund"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These operations cover the cancellation of air tickets."," ","The following are the 3 cancellation scenarios:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/webhooks/booking-lifecycle/air-booking-lifecycle/cancellation-lifecycle#canceling-voidable-tickets"},"children":["Canceling voidable tickets"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/webhooks/booking-lifecycle/air-booking-lifecycle/cancellation-lifecycle#canceling-refundable-tickets"},"children":["Canceling refundable tickets"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/webhooks/booking-lifecycle/air-booking-lifecycle/cancellation-lifecycle#canceling-non-refundable-tickets"},"children":["Canceling non-refundable tickets"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhook used:"]}," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/docs/openapi/webhookeventapi/webhooks/paths/pnr_v3/post"},"children":["PNR_V3"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"canceling-voidable-tickets","__idx":1},"children":["Canceling voidable tickets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The event below is triggered when a voidable ticket is canceled by the traveler:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"25%","data-label":"Operation"},"children":["Operation "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"Event trigger"},"children":["Event trigger "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Context"},"children":["Context"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TICKET_VOIDED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When a ticket is voided, typically within 24 hours of issuance."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An air ticket is considered voided if it's canceled during the voidable period (usually within 24 hours after ticketing)."," ","Unlike refunds, voids typically incur no penalties and the full amount is refunded."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}," A traveler realizes they booked the wrong dates 2 hours after ticketing."," ","They cancel the ticket before the void window expires. The full charge is reversed to the payment method used with no penalties applied."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"canceling-refundable-tickets","__idx":2},"children":["Canceling refundable tickets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The event below is triggered when a refundable ticket is canceled by the traveler:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"25%","data-label":"Operation"},"children":["Operation "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"Event trigger"},"children":["Event trigger "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Context"},"children":["Context"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TICKET_REFUNDED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When a ticket is canceled after the void window has expired but it's still within the refundable time limit."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The refund amount depends on the airline's fare rules."," ","For refundable fares, the full fare is refunded after deducting any cancellation penalty by the airline."," ","The event is triggered when the refund request is submitted to the airline and the ticket status changes to refunded,"," ","not when the funds reach the traveler's bank account (which may take 7 to 14 business days)."," ","An ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVOICE_GENERATED"]}," event is generated with the refund details."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}," A traveler cancels a $850 refundable ticket 3 days after booking."," ","The airline charges a $150 cancellation penalty. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TICKET_REFUNDED"]}," event is triggered and the net refund is $700."," ","An ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVOICE_GENERATED"]}," event follows with the credit note."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"canceling-non-refundable-tickets","__idx":3},"children":["Canceling non-refundable tickets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The event below is triggered when a non-refundable ticket is canceled by the traveler:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"25%","data-label":"Operation"},"children":["Operation "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"Event trigger"},"children":["Event trigger "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Context"},"children":["Context"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TICKET_REFUNDED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When a non-refundable ticket is canceled."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For non-refundable fares the full fare may be forfeited as a penalty."," ","An ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVOICE_GENERATED"]}," event follows with the penalty amount or a cancellation fee containing the entire fare of the booking."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}," A traveler cancels a $850 non-refundable ticket. The airline deducts the entire $850 as a cancellation fee."," ","The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TICKET_REFUNDED"]}," event is sent with refund amount of $0 and cancellation fee as $850."," ","An ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INVOICE_GENERATED"]}," event follows with the details about the cancellation fee."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cancellation-and-refund-flow-diagram","__idx":4},"children":["Cancellation and refund flow diagram"]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"flowchart LR\n subgraph cancellation[\"Cancellation and refund\"]\n A([\"Traveler cancels
after ticketing\"]) --> B{\"Within void
period?\"}\n\n B -->|\"Yes
(typically within 24hrs)\"| C[\"TICKET_VOIDED
―――――――――――
Ticket voided.
No penalties applied.
Full amount refunded.\"]\n\n B -->|\"No\"| D{\"Fare type?\"}\n\n D -->|\"Refundable\"| E[\"TICKET_REFUNDED
―――――――――――
Fare refunded
after deducting any applicable penalties.\"]\n\n D -->|\"Non-refundable\"| F[\"TICKET_REFUNDED
―――――――――――
The total fare is deducted as a penalty.
The refund amount will be 0.
The penalty will contain the entire fare.\"]\n\n E --> G[\"INVOICE_GENERATED
―――――――――――
Credit note / refund
adjustment invoice.\"]\n\n F --> G\n end\n\n style A fill:#f0f0f0,stroke:#999\n style C fill:#F44336,color:#fff\n style E fill:#F44336,color:#fff\n style F fill:#F44336,color:#fff\n style G fill:#FF9800,color:#fff\n","diagramHtml":"

Cancellation and refund

Yes
(typically within 24hrs)

No

Refundable

Non-refundable

Traveler cancels
after ticketing

Within void
period?

TICKET_VOIDED
―――――――――――
Ticket voided.
No penalties applied.
Full amount refunded.

Fare type?

TICKET_REFUNDED
―――――――――――
Fare refunded
after deducting any applicable penalties.

TICKET_REFUNDED
―――――――――――
The total fare is deducted as a penalty.
The refund amount will be 0.
The penalty will contain the entire fare.

INVOICE_GENERATED
―――――――――――
Credit note / refund
adjustment invoice.

"},"children":["flowchart LR\n subgraph cancellation[\"Cancellation and refund\"]\n A([\"Traveler cancels
after ticketing\"]) --> B{\"Within void
period?\"}\n\n B -->|\"Yes
(typically within 24hrs)\"| C[\"TICKET_VOIDED
―――――――――――
Ticket voided.
No penalties applied.
Full amount refunded.\"]\n\n B -->|\"No\"| D{\"Fare type?\"}\n\n D -->|\"Refundable\"| E[\"TICKET_REFUNDED
―――――――――――
Fare refunded
after deducting any applicable penalties.\"]\n\n D -->|\"Non-refundable\"| F[\"TICKET_REFUNDED
―――――――――――
The total fare is deducted as a penalty.
The refund amount will be 0.
The penalty will contain the entire fare.\"]\n\n E --> G[\"INVOICE_GENERATED
―――――――――――
Credit note / refund
adjustment invoice.\"]\n\n F --> G\n end\n\n style A fill:#f0f0f0,stroke:#999\n style C fill:#F44336,color:#fff\n style E fill:#F44336,color:#fff\n style F fill:#F44336,color:#fff\n style G fill:#FF9800,color:#fff\n"]}]},"headings":[{"value":"Cancellation and refund","id":"cancellation-and-refund","depth":1},{"value":"Canceling voidable tickets","id":"canceling-voidable-tickets","depth":2},{"value":"Canceling refundable tickets","id":"canceling-refundable-tickets","depth":2},{"value":"Canceling non-refundable tickets","id":"canceling-non-refundable-tickets","depth":2},{"value":"Cancellation and refund flow diagram","id":"cancellation-and-refund-flow-diagram","depth":2}],"frontmatter":{"seo":{"title":"Cancellation and refund"}},"lastModified":"2026-03-11T17:17:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/webhooks/booking-lifecycle/air-booking-lifecycle/cancellation-lifecycle","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}