{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Booking and ticketing","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":"booking-and-ticketing","__idx":0},"children":["Booking and ticketing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These operations cover the initial booking flow from airline confirmation through payment processing and ticket issuance."]},{"$$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":"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":{"data-label":"Step"},"children":["Step"]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"25%","data-label":"Operation"},"children":["Operation "]},{"$$mdtype":"Tag","name":"th","attributes":{"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":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_CREATED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When the airline confirms the flight reservation."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is the first notification in the booking flow."," ","The airline has accepted the reservation and created a PNR in their system."," ","At this point, the traveler's payment card is authorized. The funds may be held or debited depending on the supplier's policy."," ","The ticketing will happen later in the booking lifecycle."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYMENT_DECLINED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When the payment card is declined before ticket issuance."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment method used for booking has been declined (e.g., due to incorrect card information)."," ","The airline reservation made at step 1 still exists, but no ticket has been issued."," ","The traveler or the agent can manually retry the payment by using a new payment method."," ","Each failed manual retry generates a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYMENT_DECLINED"]}," notification."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Spotnana does not automatically cancel the booking due to payment failure. However,"," ","the airline may independently cancel the unticketed reservation based on its own ticketing deadline policies."," ","If the airline cancels the reservation before it is ticketed, a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FLIGHT_CANCELED"]}," event is generated."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_TICKETED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When an airline ticket is issued for the booking."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment is successful and the booking is ticketed. The traveler now has a confirmed e-ticket."," ","This notification includes the issued ticket number(s)."," ","This operation is also triggered when a new ticket is issued during an exchange."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SPLIT_PNR_CREATED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When a multi-traveler booking is split into separate PNRs."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If a group booking needs to be split so each traveler has their own PNR,"," ","this operation is triggered for each new child PNR created from the split.",{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," For the child PNRs created the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_CREATED"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOOKING_TICKETED"]}," events will be replaced by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SPLIT_PNR_CREATED"]}," event."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"booking-and-ticketing-flow-diagram","__idx":1},"children":["Booking and ticketing flow diagram"]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"flowchart TD\n subgraph booking[\"Booking phase\"]\n A[\"Traveler searches for flights\"] --> B[\"Traveler selects and books a flight\"]\n B --> C{\"Airline confirms
reservation?\"}\n C -->|Yes| D[\"BOOKING_CREATED
―――――――――――
Airline confirms the booking.
Card is authorized and a hold is placed.\"]\n C -->|\"No (rare)\"| Z1[\"No webhook
(booking remains pending)\"]\n end\n\n subgraph ticketing[\"Ticketing and payment phase\"]\n D --> E{\"Payment capture
attempt\"}\n E -->|\"All retries fail\"| F[\"PAYMENT_DECLINED
―――――――――――
Card charge failed.
Booking stays active indefinitely.
Airline may cancel per its own policy.\"]\n F -->|\"Traveler/agent
retries with a
new or the same card\"| E\n E -->|Succeeds| G{\"Ticket
issuance\"}\n G -->|Normal| H[\"BOOKING_TICKETED
―――――――――――
The payment method is charged and a ticket is issued.\"]\n G -->|\"Split PNR\"| I[\"SPLIT_PNR_CREATED
―――――――――――
Child PNR created from
multi-traveler booking split.\"]\n end\n\n style A fill:#f0f0f0,stroke:#999\n style B fill:#f0f0f0,stroke:#999\n style D fill:#4CAF50,color:#fff\n style F fill:#F44336,color:#fff\n style H fill:#4CAF50,color:#fff\n style I fill:#2196F3,color:#fff\n style Z1 fill:#9E9E9E,color:#fff\n","diagramHtml":"

Ticketing and payment phase

Booking phase

Yes

No (rare)

All retries fail

Traveler/agent
retries with a
new or the same card

Succeeds

Normal

Split PNR

Traveler searches for flights

Traveler selects and books a flight

Airline confirms
reservation?

BOOKING_CREATED
―――――――――――
Airline confirms the booking.
Card is authorized and a hold is placed.

No webhook
(booking remains pending)

Payment capture
attempt

PAYMENT_DECLINED
―――――――――――
Card charge failed.
Booking stays active indefinitely.
Airline may cancel per its own policy.

Ticket
issuance

BOOKING_TICKETED
―――――――――――
The payment method is charged and a ticket is issued.

SPLIT_PNR_CREATED
―――――――――――
Child PNR created from
multi-traveler booking split.

"},"children":["flowchart TD\n subgraph booking[\"Booking phase\"]\n A[\"Traveler searches for flights\"] --> B[\"Traveler selects and books a flight\"]\n B --> C{\"Airline confirms
reservation?\"}\n C -->|Yes| D[\"BOOKING_CREATED
―――――――――――
Airline confirms the booking.
Card is authorized and a hold is placed.\"]\n C -->|\"No (rare)\"| Z1[\"No webhook
(booking remains pending)\"]\n end\n\n subgraph ticketing[\"Ticketing and payment phase\"]\n D --> E{\"Payment capture
attempt\"}\n E -->|\"All retries fail\"| F[\"PAYMENT_DECLINED
―――――――――――
Card charge failed.
Booking stays active indefinitely.
Airline may cancel per its own policy.\"]\n F -->|\"Traveler/agent
retries with a
new or the same card\"| E\n E -->|Succeeds| G{\"Ticket
issuance\"}\n G -->|Normal| H[\"BOOKING_TICKETED
―――――――――――
The payment method is charged and a ticket is issued.\"]\n G -->|\"Split PNR\"| I[\"SPLIT_PNR_CREATED
―――――――――――
Child PNR created from
multi-traveler booking split.\"]\n end\n\n style A fill:#f0f0f0,stroke:#999\n style B fill:#f0f0f0,stroke:#999\n style D fill:#4CAF50,color:#fff\n style F fill:#F44336,color:#fff\n style H fill:#4CAF50,color:#fff\n style I fill:#2196F3,color:#fff\n style Z1 fill:#9E9E9E,color:#fff\n"]}]},"headings":[{"value":"Booking and ticketing","id":"booking-and-ticketing","depth":1},{"value":"Booking and ticketing flow diagram","id":"booking-and-ticketing-flow-diagram","depth":2}],"frontmatter":{"seo":{"title":"Booking and ticketing"}},"lastModified":"2026-03-11T17:17:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/webhooks/booking-lifecycle/air-booking-lifecycle/air-booking-ticketing-lifecycle","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}