{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/flights/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","span","sitelink","img"]},"type":"markdown"},"seo":{"title":"Ancillary and EMD Guide","description":"Create AI-native travel products with Travelport's powerful, flexible APIs.","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":"ancillary-and-emd-guide","__idx":0},"children":["Ancillary and EMD Guide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ancillaries are any paid optional services filed by airlines and travel providers as available for selected air segments. Available ancillaries vary by airline and segment, but can include baggage, paid seats, pet/animal transportation, unaccompanied minors, and so on."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Although paid seats are an ancillary, they use different requests and are discussed in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/guides/seats-and-ancillaries/seats-guide"},"children":["Seats Guide"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"basic-concepts","__idx":1},"children":["Basic Concepts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An ",{"$$mdtype":"Tag","name":"span","attributes":{"class":"highlighted-doc-text"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ancillary"]}]}," is any paid optional service filed for a flight. Industry examples include paid baggage, carbon offsets, and non-baggage services such as pet transport and unaccompanied minors."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key points:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ancillaries are airline-specific."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ancillary offers returned are specific to a traveler and to a segment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An ancillary is paid for separately from the fare, and an ",{"$$mdtype":"Tag","name":"span","attributes":{"class":"highlighted-doc-text"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["electronic miscellaneous document (EMD)"]}]}," is issued for that payment."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Paid seats are a type of ancillary, and are detailed in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/guides/seats-and-ancillaries/seats-guide"},"children":["Seats Guide"]}," because they use different requests than detailed here for non-seat ancillaries."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Bundled Fares"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If an ancillary is combined with an air offer, that offer is called a bundled fare and is returned in the Search API response. No additional"," ","price is charged for an ancillary in a"," ","bundled fare. An ancillary bundle can be a"," ","combination of ancillaries, or an ancillary"," ","and a seat assignment. At this time bundled fares are supported only for NDC in Search and AirPrice (i.e., they cannot yet be booked), and only for UA dynamic bundled fares."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ancillary-support","__idx":2},"children":["Ancillary Support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The TripServices APIs currently support the following ancillaries in the workflows as noted below for NDC and GDS. For seats support, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/guides/seats-and-ancillaries/seats-guide"},"children":["Seats Guide"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/guides/booking-and-reservations/flights-booking-guide#ndc-instant-pay-workflow-book-and-ticket-in-same-workbench"},"children":["NDC Instant Pay workflow"]}," (book and issue ticket in the same session) does not support booking ancillaries."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For GDS and NDC differences in the TripServices APIs, see the support tables for ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/guides/seats-and-ancillaries/seats-guide#seats-support"},"children":["seats"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/guides/seats-and-ancillaries/ancillaries-and-emd-guide#ancillary-support"},"children":["ancillaries"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/guides/fare-rules-guide#fare-rules-support-and-formats"},"children":["fare rules"]},", and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/guides/exchange-refund-and-void-guide"},"children":["exchanges/refunds"]},", and the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/ndc/ndc-guide#ndc-and-gds-functionality-comparison-chart"},"children":["NDC and GDS Functionality Comparison"]},"."," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","For differences within NDC by individual carriers, see ",{"$$mdtype":"Tag","name":"Link","attributes":{"to":"https://travelportprod.service-now.com/mytravelport_support?id=kb_article_view&table=kb_knowledge&sys_kb_id=fd2d342347cd521051f0bc8f016d43ad&searchTerm=NDC%20Capabilities%20by%20airline","target":"_blank","rel":"noopener noreferrer"},"children":[" NDC capabilities by airline through TripServices API "]}," in the Travelport Knowledge Base. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/ndc/ndc-guide#knowledge-base-ndc-resources"},"children":["Knowledge Base NDC Resources"]}," if you need login assistance."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To add ancillaries or seats to a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/guides/booking-and-reservations/flights-booking-guide#booking-workflow-summary"},"children":["multi-offer booking"]},", send the Ancillary Shop or Seat Map request, then send one book request for each offer, in any order. Supported in the initial booking workflow only for free seats; supported for an existing booking for ancillaries and free and paid seats. GDS only; multi-offers not supported for NDC."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"class":"doc-table md md","className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"class":"table-row-bg-top","data-label":"Ancillary type"},"children":["Ancillary type"]},{"$$mdtype":"Tag","name":"th","attributes":{"class":"table-row-bg-top","colSpan":2,"data-label":"Ancillary Shop after AirPrice (must repeat in workbench)"},"children":["Ancillary Shop after AirPrice (must repeat in workbench)"]},{"$$mdtype":"Tag","name":"th","attributes":{"class":"table-row-bg-top","colSpan":2,"data-label":"Ancillary Shop and Book (initial booking workflow)"},"children":["Ancillary Shop and Book (initial booking workflow)"]},{"$$mdtype":"Tag","name":"th","attributes":{"class":"table-row-bg-top","colSpan":2,"data-label":"Ancillary Shop and Book (existing reservation)"},"children":["Ancillary Shop and Book (existing reservation)"]},{"$$mdtype":"Tag","name":"th","attributes":{"class":"table-row-bg-top","colSpan":2,"data-label":"Cancel ancillary"},"children":["Cancel ancillary"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{"class":"table-row-bg-green"},"children":["GDS"]},{"$$mdtype":"Tag","name":"td","attributes":{"class":"table-row-bg-green"},"children":["NDC"]},{"$$mdtype":"Tag","name":"td","attributes":{"class":"table-row-bg-green"},"children":["GDS"]},{"$$mdtype":"Tag","name":"td","attributes":{"class":"table-row-bg-green"},"children":["NDC"]},{"$$mdtype":"Tag","name":"td","attributes":{"class":"table-row-bg-green"},"children":["GDS"]},{"$$mdtype":"Tag","name":"td","attributes":{"class":"table-row-bg-green"},"children":["NDC"]},{"$$mdtype":"Tag","name":"td","attributes":{"class":"table-row-bg-green"},"children":["GDS"]},{"$$mdtype":"Tag","name":"td","attributes":{"class":"table-row-bg-green"},"children":["NDC"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Paid baggage"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"(uses different request from GDS)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Carbon offset"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/a"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Non-baggage paid ancillaries"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["(e.g., pets, meals, lounge access, wifi)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yes"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ancillary-payment-and-emds","__idx":3},"children":["Ancillary Payment and EMDs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payment for any ancillary, including paid seats (see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/guides/seats-and-ancillaries/seats-guide"},"children":["Seats Guide"]},"), is issued through an EMD (electronic miscellaneous document) and is separate from the payment for the flight/s. EMDs can be either EMD-A (EMD is associated to a ticket) or EMD-S (standalone EMD). The TripServices APIs support only EMD-A."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For GDS ancillaries, you can pay for an ancillary only after booking that ancillary. This allows the carrier to confirm the ancillary prior to payment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["NDC carriers vary as to when they require ancillary payment. Some NDC carriers require ancillary payment in the initial booking session while others allow you to book the ancillary without payment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For detailed NDC support by carrier, see the Knowledge Base article ",{"$$mdtype":"Tag","name":"Link","attributes":{"to":"https://travelportprod.service-now.com/mytravelport_support?id=kb_article_view&table=kb_knowledge&sys_kb_id=fd2d342347cd521051f0bc8f016d43ad&searchTerm=NDC%20Capabilities%20by%20airline","target":"_blank","rel":"noopener noreferrer"},"children":["NDC capabilities by airline through TripServices API"]}," (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/ndc/ndc-guide#knowledge-base-ndc-resources"},"children":["Knowledge Base NDC Resources"]}," if you need login assistance)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["NDC carriers issue their own EMDs. After the EMD is issued, there are some differences in EMD handling between GDS and NDC in the TripServices APIs:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For GDS, use the EMD display and void requests to retrieve or void an EMD."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For NDC, use a Reservation Retrieve to retrieve EMD details. To void an EMD, you must also void the associated NDC itinerary; see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/guides/exchange-refund-and-void-guide"},"children":["Exchange, Refund, and Void Guide"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"canceling-ancillaries","__idx":4},"children":["Canceling Ancillaries"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the Ancillary Cancel request to cancel baggage and/or paid seats for both GDS and NDC, and to cancel non-baggage ancillaries for NDC. Canceling non-baggage ancillaries for GDS is not supported."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only one paid seat per workbench session can be canceled. To cancel multiple seats, send one cancel request, commit the workbench, and start a new workbench to cancel the next seat. For paid bags, you can send multiple cancel requests in a post-commit workbench session."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"workflow-summary","__idx":5},"children":["Workflow Summary"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ancillary-shop-after-pricing-workflow","__idx":6},"children":["Ancillary Shop after Pricing Workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For select ancillaries as noted above in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#ancillary-support"},"children":["Ancillary Support"]},", you can send an Ancillary Shop request after AirPrice without a workbench session. You'll need to repeat the Ancillary Shop request in a later workbench before you can book an ancillary."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"class":"doc-table md md","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":{"data-label":"Ancillary Workflow Step"},"children":["Ancillary Workflow Step"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description and Notes"},"children":["Description and Notes"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API Reference"},"children":["API Reference"]}]}]},{"$$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":["Search for flights"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Searches for flights."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search API Reference"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Price the itinerary"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Price a selected itinerary from the Search response.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Required before sending an ancillary shop request outside a booking workbench."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AirPrice API Reference"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ancillary shop request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop for available ancillaries."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ancillary Shop API Reference"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ancillary-workflow-for-existing-booking","__idx":7},"children":["Ancillary Workflow for Existing Booking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow these steps to add a supported ancillary to an existing booking (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#ancillary-support"},"children":["Ancillary Support"]}," above). For free and paid seats, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/guides/seats-and-ancillaries/seats-guide"},"children":["Seats Guide"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"class":"doc-table md md","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":{"data-label":"Ancillary Booking Workflow Step"},"children":["Ancillary Booking Workflow Step"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description and Notes"},"children":["Description and Notes"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API Reference"},"children":["API Reference"]}]}]},{"$$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":["Create workbench for existing reservation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns a system-generated identifier for the workbench that must be sent in subsequent requests for that workbench."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Post-Commit Workbench API Reference"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ancillary shop request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shop for available ancillaries."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ancillary Shop API Reference"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ancillary price request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Price selected ancillary.",{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Required for NDC. Not supported for GDS."]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ancillary Price API Reference"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ancillary book request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add selected ancillary to workbench."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ancillary Book API Reference"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["5"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add form of payment (FOP) for ancillary (optional, supported in same workbench only for specific NDC carriers)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For specific NDC carriers, you can choose to pay and issue the EMD for the ancillary in the same workbench in which you shop and book the ancillary."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send the details for the form of payment (FOP) to be used to pay for the ancillary. The response returns a system-generated identifier for the FOP that must be sent in the Add Payment request next."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment and EMD Workflow for Seats and Ancillaries"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For all GDS and some NDC carriers, you must commit the booking workbench to confirm the seat or ancillary, and then create a new workbench to send payment and issue the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#ancillary-payment-and-emds"},"children":["EMD"]},". Payment and EMD in the same workbench as booking is supported only for specific NDC carriers. For ancillary requirements by NDC carrier, see ",{"$$mdtype":"Tag","name":"Link","attributes":{"to":"https://travelportprod.service-now.com/mytravelport_support?id=kb_article_view&table=kb_knowledge&sys_kb_id=fd2d342347cd521051f0bc8f016d43ad&searchTerm=NDC%20Capabilities%20by%20airline","target":"_blank","rel":"noopener noreferrer"},"children":[" NDC capabilities by airline through TripServices API"]}," in the Travelport Knowledge Base. (If you need login assistance, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/ndc/ndc-guide#knowledge-base-ndc-resources"},"children":["Knowledge Base NDC Resources"]},".)"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add Form of Payment API Reference"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["6"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add payment for ancillary (optional, supported in same workbench only for specific NDC carriers)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If you sent FOP per the preceding step, send the IDs for the offer/s to pay for and the FOP to use."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add Payment API Reference"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["7"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Commit the workbench"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Final step in the workflow."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Depending on payment, one of the following occurs:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If no payment was sent, the commit updates the held booking with the ancillary"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If FOP and payment for the ancillary were sent, the commit updates the held booking with the ancillary and issues an EMD for the ancillary."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If FOP and payment for the ancillary ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["and"]}," the air offer were sent, the commit issues the ticket and an EMD for the ancillary."]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Workbench Commit API Reference"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"workflow-diagrams","__idx":8},"children":["Workflow Diagrams"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Paying for an ancillary and issuing an EMD in the same workbench as shopping and booking the ancillary is supported only for NDC. For GDS, you must first commit the workbench to confirm the paid seats before you can pay for the ancillary and issue the EMD in a separate workbench."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["FOP and Payment requirements for NDC vary by carrier per ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#ancillary-support"},"children":["Ancillary Support"]}," above."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each box in the diagram represents one API call in the workflow."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"ancillaries-workflow-add-ancillary-to-existing-reservation","__idx":9},"children":["Ancillaries workflow: Add ancillary to existing reservation"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","align":"center","diagramType":"mermaid","diagramSource":"flowchart TD\n A[\"Create post-commit\\nworkbench\"]\n B[\"Ancillary shop\"]\n C[\"Ancillary price\\n(required for NDC,\\nnot supported for GDS)\"]\n D[\"Ancillary book\"]\n E[\"Add form of payment\\nfor ancillary\\n(optional, NDC only)\"]\n F[\"Add payment\\nfor ancillary\\n(optional, NDC only)\"]\n G[\"Commit workbench\\n(issues EMD if payment sent;\\nNDC only)\"]\n\n A --> B --> C --> D --> E --> F --> G\n\n","diagramHtml":"

Create post-commit
workbench

Ancillary shop

Ancillary price
(required for NDC,
not supported for GDS)

Ancillary book

Add form of payment
for ancillary
(optional, NDC only)

Add payment
for ancillary
(optional, NDC only)

Commit workbench
(issues EMD if payment sent;
NDC only)

","diagramHtmlDark":"

Create post-commit
workbench

Ancillary shop

Ancillary price
(required for NDC,
not supported for GDS)

Ancillary book

Add form of payment
for ancillary
(optional, NDC only)

Add payment
for ancillary
(optional, NDC only)

Commit workbench
(issues EMD if payment sent;
NDC only)

"},"children":["flowchart TD\n A[\"Create post-commit\\nworkbench\"]\n B[\"Ancillary shop\"]\n C[\"Ancillary price\\n(required for NDC,\\nnot supported for GDS)\"]\n D[\"Ancillary book\"]\n E[\"Add form of payment\\nfor ancillary\\n(optional, NDC only)\"]\n F[\"Add payment\\nfor ancillary\\n(optional, NDC only)\"]\n G[\"Commit workbench\\n(issues EMD if payment sent;\\nNDC only)\"]\n\n A --> B --> C --> D --> E --> F --> G\n\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"add-fop-and-payment-optional","__idx":10},"children":["Add FOP and Payment (optional)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As part of the workflow, you can send form of payment (if not already in the reservation) and payment for the ancillary offer. If you are also ready to ticket the booking, send payment for both the ancillary offer and the air offer. Reference both the offer and the FOP in the request. See the Add Payment API Reference for endpoint and payload details."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example adds payment for both an offer (\"id\": \"offer_1\",) and an ancillary (\"id\": \"an_o1\")."]},{"$$mdtype":"Tag","name":"details","attributes":{"className":"example-box"},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Show Example Add Payment Request for offer and ancillary"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"Payment\": {\n \"id\": \"payment_1\",\n \"Identifier\": {\n \"authority\": \"Travelport\",\n \"value\": \"A0656EFF-FAF4-456F-B061-0161008D6A5E\"\n },\n \"Amount\": {\n \"code\": \"AUD\",\n \"minorUnit\": 2,\n \"currencySource\": \"Charged\",\n \"approximateInd\": true,\n \"value\": 63.1\n },\n \"FormOfPaymentIdentifier\": {\n \"id\": \"formOfPayment_5\",\n \"FormOfPaymentRef\": \"formOfPayment_5\",\n \"Identifier\": {\n \"authority\": \"Travelport\",\n \"value\": \"A0656EFF-FAF4-456F-B061-0161008D6FOP\"\n }\n },\n \"OfferIdentifier\": [\n {\n \"id\": \"offer_1\",\n \"offerRef\": \"offer_1\",\n \"Identifier\": {\n \"authority\": \"Travelport\",\n \"value\": \"07664bb3-37a0-4c63-a2ef-ed71b5f48d49\"\n }\n },\n {\n \"id\": \"an_o1\",\n \"Identifier\": {\n \"authority\": \"Travelport\",\n \"value\": \"3427d42c-a72d-49ff-b29e-7bb8faa28a47\"\n }\n }\n ]\n }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"commit","__idx":11},"children":["Commit"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As the last step in the flow, commit the workbench."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For an initial booking, the commit creates a reservation with the ancillary details. If FOP and payment for the ancillary were also sent, an EMD for the ancillary is issued."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For an existing reservation, the commit causes one of the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If no payment was sent, the commit updates the held booking with the ancillary."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If FOP and payment for the ancillary were sent, the commit updates the held booking with the ancillary and issues an EMD for the ancillary."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If FOP and payment for the ancillary ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["and"]}," the air offer were sent, the commit issues the ticket and an EMD for the ancillary."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The commit response returns the following ancillary-specific details in these objects:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Product: Product and ancillary identifiers, and the seat assignment if the ancillary is a paid seat."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Document: The Document object includes both the ticket number and the EMD number, if issued."]}]},{"$$mdtype":"Tag","name":"details","attributes":{"className":"example-box"},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Show Example Commit Response excerpt"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following excerpts from the commit response show the ancillary details in Product, and the ticket and EMD numbers and charged amounts in Document."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"...\n \"Product\": [\n {\n \"@type\": \"ProductAncillary\",\n \"id\": \"product_seat_2\",\n \"Identifier\": {\n \"authority\": \"Travelport\",\n \"value\": \"b20e57ff-855a-403d-b746-aae16b1e26f4\"\n },\n \"Ancillary\": {\n \"@type\": \"AncillaryAirSeat\",\n \"FlightRef\": [\n \"Flight_01\"\n ],\n \"SeatAssignment\": {\n \"Seat\": \"018A\"\n }\n }\n }\n ]\n }\n ],\n...\n \"Document\": [\n {\n \"@type\": \"DocumentTicket\",\n \"Number\": \"2203768856641\",\n \"TravelerIdentifierRef\": {\n \"id\": \"travelerRefId_1\",\n \"value\": \"877fed2a-0704-42ee-b98b-145fbaff9ed8\"\n },\n \"Amount\": {\n \"Total\": 1016.8\n }\n },\n {\n \"@type\": \"DocumentEMD\",\n \"Number\": \"2202901087112\",\n \"TravelerIdentifierRef\": {\n \"id\": \"travelerRefId_1\",\n \"value\": \"877fed2a-0704-42ee-b98b-145fbaff9ed8\"\n },\n \"Amount\": {\n \"Total\": 49.3\n },\n \"EMDDescription\": {\n \"value\": \"SEAT ASSIGNMENT\"\n }\n }\n ]\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-and-response-layout-diagrams","__idx":12},"children":["Request and Response Layout Diagrams"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following overview diagrams illustrates the basic structure of the requests and responses for ancillary shop and price. These diagrams don't include every object that might be returned, and diagrams may not reflect minor updates."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ancillary-shop","__idx":13},"children":["Ancillary Shop"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following diagram illustrates the general structure of the Ancillary Shop request and response, including most high-level objects."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/ancillaryshop-reqrsp.760b976b0a9469235ce1c54c83dbef36aca8c1a0f89b39932d1c51affd5e621f.e0696170.jpg","withLightbox":false},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ancillary-price","__idx":14},"children":["Ancillary Price"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following diagram illustrates the general structure of the Ancillary Price request and response, including most high-level objects."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/ancillaryprice-reqrsp.88fd6b1daa16ce95792842da6d16f9e3d495276c87dc2e2b0e489a7cef759f0d.e0696170.jpg","withLightbox":false},"children":[]}]},"headings":[{"value":"Ancillary and EMD Guide","id":"ancillary-and-emd-guide","depth":1},{"value":"Basic Concepts","id":"basic-concepts","depth":2},{"value":"Ancillary Support","id":"ancillary-support","depth":2},{"value":"Ancillary Payment and EMDs","id":"ancillary-payment-and-emds","depth":2},{"value":"Canceling Ancillaries","id":"canceling-ancillaries","depth":2},{"value":"Workflow Summary","id":"workflow-summary","depth":2},{"value":"Ancillary Shop after Pricing Workflow","id":"ancillary-shop-after-pricing-workflow","depth":3},{"value":"Ancillary Workflow for Existing Booking","id":"ancillary-workflow-for-existing-booking","depth":3},{"value":"Workflow Diagrams","id":"workflow-diagrams","depth":3},{"value":"Ancillaries workflow: Add ancillary to existing reservation","id":"ancillaries-workflow-add-ancillary-to-existing-reservation","depth":4},{"value":"Add FOP and Payment (optional)","id":"add-fop-and-payment-optional","depth":3},{"value":"Commit","id":"commit","depth":3},{"value":"Request and Response Layout Diagrams","id":"request-and-response-layout-diagrams","depth":2},{"value":"Ancillary Shop","id":"ancillary-shop","depth":3},{"value":"Ancillary Price","id":"ancillary-price","depth":3}],"frontmatter":{"seo":{"title":"Ancillary and EMD Guide"}},"lastModified":"2026-05-27T15:34:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/flights/guides/seats-and-ancillaries/ancillaries-and-emd-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}