Business Requirements Document NDC Payment and Ticketing

Transcription

1 Business Requirements Document NDC Payment and Ticketing 11 June 2014 Document Status: Version 1.5 FINAL Workgroup members or interested parties should send their comments and requests to DDXWG Payment and Ticketing Taskforce and DDXWG Steering Group

2 Revision History Version Date Name Description of Change /01/14 Payment and Ticketing Taskforce /01/14 Payment and Ticketing Taskforce review and updates Pre-draft version Scope, Definitions, Functional Requirements review and updates /01/14 Payment and Ticketing reviews and updates /02/14 John Huang Closed out and addressed comments from other taskforces/sg. Modified scope definitions and diagram. Added new terms and definitions. Modified Principles. Added new functional requirements, message recommendations. Consolidated and added new use cases /02/14 John Huang Continued to update BRD with additional use cases, error condition chart /02/14 John Huang Removed all references to IATA Reso 722, 725, Changed ticketing/emd to document where appropriate; Updated authentication principle and Payment Time Limit definition to align with OM BRD; Completed Error condition chart as it applies to all functions; Imported message model; Added additional clarification and details to Scope section regarding Ticketless carriers 1.0 7/03/14 Andrei Grintchenko Version 1 PADIS Review Draft PDF /04/14 John Huang Updates following PADIS review and comments 1.1a 14/04/14 Andrei Grintchenko Additional updates following PADIS review and comments /04/14 PT Taskforce Review and finalization of the updates following PADIS review and comments /05/14 Andrei Grintchenko Updates following PADIS review calls as agreed and implemented on site /05/14 Andrei Grintchenko Suggested minor edits/ wording alignments following review by IATA payment card expert /11/14 Andrei Grintchenko Edits and formatting, updated terms and definition section (aligned across all NDC BRDs). Final Extraordinary PADIS review version preparation, PDF version. Business Requirements Document - NDC Payment and Ticketing Page 2 of 49

3 Table of Contents 1 Introduction Scope Field of Application Principles References Assumptions Terms and Definitions Functional Requirements Functional Requirement Description Recommended Messages Message Sequence Flows Data Description Non-Functional Requirements Code Lists Appendix A: List of Use Cases Use Case 1: Ticket Issuance Single Airline, Single Passenger, Single Form of Payment Credit Card (No Prior Authorization) Use Case 2: Ticket Issuance Codeshare (Airline Marketed/OA Operated), Multi Pax, Infant-no seat, FOP Gift Card/Miles, Bundled Fare with Ancillary Use Case 3: EMD-S Issuance Single Airline, Ancillary only, Companion, Multiple Form of payment (Cash Card+ Debit Card) Use Case 4: Refund Request Use Case 5: Reissue Request Use Case 6: ET/EMD Void Request Use Case 7: ET/EMD System Cancel Request Error handling chart: Appendix C: List of Attachments Business Requirements Document - NDC Payment and Ticketing Page 3 of 49

4 1 Introduction IATA PSC Resolution 787, passed in October 2012, recognised that the industry will benefit from the introduction of a standard process for airlines to distribute product offers created within their own systems and to manage the resulting orders. This standard Application Programming Interface (API) is called the New Distribution Capability (NDC) API. In September 2013 the BRD and schema for the shopping part of the NDC process (NDC Airline Shopping BRD), ie up to the point when the customer is ready to accept a product offer, was produced and reviewed by the IATA PADIS Committees. To ensure that end-to-end NDC process is covered, business requirements for subsequent components of NDC Order lifecycle must be produced. This document identifies NDC messaging requirements for Payment and Ticketing process, ie after customer product offer acceptance (NDC order management is addressed in NDC Order Management BRD), and readiness to purchase travel products, and up to airline issuance of accountable documents and payment processing. The document is intended to be submitted to PADIS for review and validation under the PADIS process, to enable NDC XML schemas to be produced and published as IATA PADIS release under the governance of PSC Resolution Scope 2.1 Field of Application The full NDC context is shown in the following diagram with the scope of this BRD indicated. This BRD covers the payment and ticketing processes in the NDC lifecycle when an order has been accepted by the customer and confirmed with the airline and is ready to ticket. Business Requirements Document - NDC Payment and Ticketing Page 4 of 49

5 The scope covered by this BRD for NDC Shopping is: In Scope: Issuance of an Accountable Document by an airline (ie electronic ticket, EMD, etc.) Acceptance of payment data. Ticket/document display Ticket/document history display Ticket/document exchange/reissue Ticket/document refund Ticket/document void Ticket/document cancel Payment types in scope: cash, various payment cards, airline currency (* Refer to terms and definition on cash and cash for payment types supported) Out of Scope: The remaining proposed standards resulting from the NDC project are out of scope of this document, ie: Airline Profile distribution and usage. Airline Order lifecycle management prior to acceptance of the product offer. Agency back office reporting and settlement process. Revenue accounting process for airline and all involved parties. Ticketing driven by third party providers (ie Aggregators) 1 Ticketless carrier support (* While message naming conventions were developed to be flexible and accommodate carriers that use alternatives to ET and EMD (ie: Ticketless reservations), at the time of authoring this version of the BRD, there is no participating ticketless carrier that can validate and confirm the contents of this BRD can fully support ticketless carrier requirements) Payment types: Cash collected directly by airline, Paypal and Bill Me Later as integrated forms of payment into the purchase path, or when the customer must log into Paypal separately to complete the transaction, Electronic Funds Transfer (all bank transfers, SEPA (direct debit. * These forms of payment are out of scope for this version of the BRD and will be included in a future revision. Requirements to integrate with existing processes/ standards 2.2 Principles Seller requests to issue accountable documents (ie ticket/ EMD) Airlines will authenticate the entity sending the NDC message and trust that the identity of upstream entities included in the request message has been authenticated by each entity in turn up the chain to the originator. Parties using the API shall ensure their own compliance with all applicable laws and regulations. Parties using the API shall be responsible for maintaining data confidentiality and be compliant with all applicable privacy laws and regulations. Parties using the API shall be responsible for PCI compliance. It is not in the scope of this document to suggest any particular PCI compliance strategy, methodology or tools, and it is assumed that any party using the API will establish its own compliance strategy using methodology and tools it finds most appropriate. 1 It is recognized that third party (ie Aggregator driven) ticketing on behalf of airlines may be in place in transitional (hybrid) scenarios, and NDC messages maybe used to support it, if applicable and suitable and on bilateral agreements. However, requirements for third party ticketing are outside the scope of NDC. Business Requirements Document - NDC Payment and Ticketing Page 5 of 49

6 3 References IATA PSC Resolutions: o 787 o 728 A NDC Airline Shopping BRD NDC Order Management BRD PADIS XML 14.1 or other releases current at the time PADIS Codeset 14.1 or other releases current at the time 4 Assumptions Related to the scope of ticketing and payment there are no differences to the process steps whether it is a single, multiple passenger or group booking. 5 Terms and Definitions Term and Definitions identified in this document and in other NDC Business Requirements Documents (ie. Airline Shopping, etc.) are maintained in a separate document NDC Terms and Definitions, owned by DDXWG Steering Group. Terms and definitions are included in this document as an excerpt from NDC Terms and Definitions v.1.2 for easier reading and referencing. Term Definition BRD Reference Accountable Document Acknowledgement Affinity Shopping Aggregator Airline Airline currency Validated official document (such as any type of an airline ticket, or a Standard Traffic Document (STD) or payment voucher) that has a value and must be accounted for. Acknowledges the receipt of a message but does not imply acceptance of the message content A wide search defining a range of criteria including specific interest, destination attributes and defined budget plus date and destination ranges. The business function of distributing a Seller s shopping request to multiple Airlines and aggregating the subsequent responses. Supplies product offers in response to receiving a request from a Seller. Airline refers to itself and any subcontracted entity providing a service to the airline Miles, vouchers, residual value EMD, airline issued gift/cash card Order Management Order Management Airline Shopping Airline Shopping; Payment and Ticketing Airline Shopping; Payment and Ticketing Payment and Ticketing Business Requirements Document - NDC Payment and Ticketing Page 6 of 49

7 Ancillary Services or Optional Services Anonymous Shopping Ancillary Services are defined in PSC Resolution 787 as anything outside of product attributes (optional or discounted). Ancillary Services may be bundled in the product offer, or offered as additional, a la cart services. For the purposes of this document the term Ancillary Services is sometimes used interchangeably with the term Optional Services. No traveller personal data in the shopping request Airline Shopping; Interline Ancillary Shopping; Payment and Ticketing Airline Shopping API Application Programming Interface Airline Shopping; Payment and Ticketing Attribute Shopping Authentication Bilateral Interface Agreement Bilateral Time Limit Booking Time Limit A search specifying one or more attributes to get more focused results (eg equipment types, Seat types and characteristics, baggage allowance, meals, etc. The process by which a system identifies an individual or a business entity to make sure that the user or the business entity is who they claim to be, based on attributes that are sent in a message. A documented agreement made between the sender and receiver as the basis of the data exchange between systems This agreement defines a number of features which are mandatory or optional within the specification (time outs, message order processing, reject processing) A generic structure for time limits, that is subject to bilateral agreements between parties. Booking time limit is the amount of time within which the booking transaction must be completed (does not include ticketing). NOTE: This definition in Airline Shopping is superseded with the revised definition of Offer Time Limit (revised) as provided in Order Management BRD Airline Shopping Airline Shopping; Payment and Ticketing Interline Ancillary Shopping Airline Shopping (requires a change) and Order Management Airline Shopping (requires change) Cabin A compartment where passenger seats are installed Interline Ancillary Shopping Campaign Identifier Campaign ID is a tracking code used by the airline s advertising analytics system to monitor and optimize the paid advertising by the airline across interactive marketing channels. By including the Campaign ID with shopping requests the online media publisher (MSE, OTA, affiliate partner, booking widget, etc.) can help guide the airline so that the airlines personalization of Order Management Business Requirements Document - NDC Payment and Ticketing Page 7 of 49

8 Card payment* Cash payment offers can align with any paid advertising that may be present on the publisher s display. Various forms of payment that include: credit card (includes UATP), debit card (PIN based or signature based), pre-paid debit/bank/gift card, cash card where the Airline is the merchant. Refer to IATA Resolution 728 Attachment A for full details on card types and codes. Any payment that is collected by the agent and settled between the Airline and the agent. Refer to IATA Resolution 728 Attachment A for full details on card types and codes. Payment and Ticketing Payment and Ticketing CBT Corporate Booking Tool Airline Shopping Check/Cheque* Commercial Agreement ID Corporate ID Personal or bank issued order for transfer of money. Refer to IATA Resolution 728 Attachment A. Code or ID referenced by ORA or POA in message exchange which refers to a previously created bilateral agreement. A SPA is an example. An ID provided by an airline to uniquely identify a corporate location for which a commercial arrangement exists. Payment and Ticketing Interline Ancillary Shopping Order Management, plus change to Airline Shopping Deposit Time Limit Time by which a deposit must be paid for an Order. Airline Shopping (requires change) and Order Management Distribution Channel Provider An entity that has the capability to interface with an airline s dynamic shopping API enabling distribution of airline product offers across one or multiple channels. For the purposes of this document it is assumed that such provider shall use industry standard NDC XML messages to communicate with airlines dynamic shopping API, and may act as a content aggregator. Airline Shopping FQTV Frequent Traveler Airline Shopping Group Booking Inventory Guarantee Time Limit An Order made under a group name without individual passenger names at the point of creation The time that inventory for a specified product offer is guaranteed as available. The inventory held must be converted into a completed order before the time limit expires otherwise the guarantee is lost. Held Inventory is referenced by an Inventory Guarantee identifier (equivalent in business terms to the legacy ITAREQ Conversation ID ). In the context of Interline Ancillary Shopping, this term is defined as the time window (or Order Management Order Management; Interline Ancillary Shopping Business Requirements Document - NDC Payment and Ticketing Page 8 of 49

9 Inventory Guarantee Identifier Leg Marketing Carrier Meta Search deep link Meta Search shallow link MSE ( Meta search Engines) final date) identified by the ORA or POA where inventory will be held prior to booking. An unique identifier issued by an Airline to reference that inventory for a specified offer will be guaranteed as available for a period The operation between a departure station and the next arrival station The carrier that sells with its own code as part of a code share agreement on a flight that is actually operated by another carrier. A link to an airline's or OTA's itinerary purchase page enabling the user to purchase a specific itinerary offer. A link to an airline's or OTA's shopping results page listing multiple flight options for a pre-specified city pair and dates, as well as upsell / cross-sell products MSE redirect their users to an airline or Online Travel Agent for the creation of an Airline Order. A MSE is not involved in servicing the resulting order - this is done by the OTA or Airline. Order Management Interline Ancillary Shopping Interline Ancillary Shopping Airline Shopping Airline Shopping Order Management Multi Leg Flight A flight comprised of more than one leg Interline Ancillary Shopping Naming Time Limit Time by which an Order, must be completed with individual passenger names. Order Management OAL Other AirLine Airline Shopping Offer ID Offer item Offer ID facilitates the tracking and verification of individually priced offer(s) selected from the shopping response. Only the Offer IDs of the ORA (Offer Responsible Airline) are returned in shopping responses. Offer ID is unique to each individually priced offer in the shopping response even if the offer price is zero. OfferID may be specific to individual passengers in the offer, and may be associated with a segment or a journey. The set of Offer IDs returned in a response are referenced by a Shopping Response ID. One or more products that has one price, eg a product bundle Airline Shopping; Payment and Ticketing Order Management Business Requirements Document - NDC Payment and Ticketing Page 9 of 49

10 Offer Responsible Airline (ORA) Offer Time Limit Offer Time Limit (revised) Operating Carrier Order Offer Responsible Airline: The airline responsible for returning a combined offer, including participating airline offers, to the requesting entity Offer Time Limit is the amount of time within which offers in a shopping response maybe reserved. Upon expiring, a new shopping request must be sent. NOTE: This definition in Airline Shopping is superseded with the revised definition of Offer Time Limit (revised) as provided in Order Management BRD The time within which offers must be converted into completed Orders. On expiry a new shopping transaction is required. This definition supersedes both Offer and Booking Time Limit definitions in the Shopping BRD. Offer Time Limit is mandatory. The carrier that holds the Air Operator s Certificate for the aircraft used for that flight An Order is a uniquely identified record of the agreement of one party with another to receive products and services under specified terms and conditions. Order supports the sale of a flexible range of airline products and services that are not necessarily journey based (eg subscription services). A PNR, super PNR and ticket are all today s versions of airline implementations of aspects of an Order. An Order will contain 1 or more Order Items each with an identifier that is unique within an Airline s Order Management system. An Order may support nonhomogeneity, ie each passenger in an Order may hold different sets of order items at different prices. Airline Shopping; Interline Ancillary Shopping; Payment and Ticketing Airline Shopping (requires change) Order Management; Interline Ancillary Shopping; Payment and Ticketing Interline Ancillary Shopping Order Management; Payment and Ticketing Order item A selected Offer item. Order Management Order Management Order Management is the process of taking, amending, tracking and fulfilling requests for an airline s products and services. Order Management OSI Other Service Information Airline Shopping OTA Online Travel Agency Airline Shopping Participating Offer Airline (POA) Participating Offer Airline: An airline other than the Offer Responsible Airline involved in a product offer Airline Shopping; Interline Ancillary Shopping; Payment and Ticketing Payment Time The deadline by which a commitment to pay must be Order Management; Business Requirements Document - NDC Payment and Ticketing Page 10 of 49

11 Limit Personalised Shopping made for the items in the order. This includes ticketless transactions and other accountable documents (ie EMD. Payment Time Limit and Ticket Time Limit may be the same in most cases; however, Payment Time Limit expands to include ticketless transactions and other accountable documents. Payment Time Limit is mandatory. Traveller consents to include personal data in the shopping request Interline Ancillary Shopping; Payment and Ticketing Airline Shopping PNR Passenger Name Record Airline Shopping; Payment and Ticketing Price Guarantee Time Limit Product Bundle Referrer Identity Seller Service Item Period for which an Offer price is guaranteed. On expiry an Offer may be re-priced up to the point an accountable document is issued. A Price Guarantee cannot extend beyond the Offer Time Limit unless the Order has been created. Where several products are offered for sale as one product. NOTE: This definition has evolved in Order Management BRD, and has the same meaning as Offer Item Identifies to the aggregator or the airline, the specific commercial contract under which a particular message should be tracked; for example, is the message related to (A) the x cents per click for traffic from Indonesia or (B) the y % per ticket for each booking that originates from Japan. Creates shopping requests to Airlines on behalf of a customer and displays the subsequent product responses for review An airline service item is a product or a service that can be separately delivered and uniquely described by an airline. It is referenced by an ID that is unique within an airline. A service may be sold separately in a single offer/ order item or sold bundled with other service items in a single offer/order item (eg a return price consisting of inbound and outbound services). Airline Shopping (requires change) and Order Management Airline Shopping Order Management Airline Shopping; Payment and Ticketing Order Management Service Time Limit Settlement Time limit for EMD creation. May be different from Payment Time Limit Third parties that provide settlement services between agent and airlines. Could include ARC, BSP, TCH, Interline Ancillary Shopping Payment and Ticketing Business Requirements Document - NDC Payment and Ticketing Page 11 of 49

12 providers MoneyDirect, eenet, etc. Shopping Shopping Basket Shopping Response ID A process whereby a Seller is able to request offers from the airlines (ie flight and ancillaries) based on its desired search criteria and receive offers corresponding to its request. There are various types of shopping, including, for example, Personalized/ Anonymous and Attribute/ Affinity shopping types as defined in this document. A Shopping Basket is e-commerce software that allows visitors to an internet site to select items for eventual purchase Shopping Response ID facilitates the tracking of what was offered and is an identifier unique to the source airline for a set of product offers returned in response to a shopping request. Shopping Response ID may be comprised of an Offer ID corresponding to an individual flight and/or ancillary service product offer that make up the offer. See Appendix D for scenarios illustrating use of this identifier. Airline Shopping Airline Shopping Airline Shopping SSR Special Service Request Airline Shopping Ticket Time Limit Ticketing Ticket Time Limit is the amount of time which the booking maybe held until it must be ticketed or other accountable documents issued (eg EMD). The process of issuing any type of an accountable document to fulfil an airline order. Airline Shopping Payment and Ticketing TMC Travel Management Company Airline Shopping XML Extensible Markup Language Airline Shopping Business Requirements Document - NDC Payment and Ticketing Page 12 of 49

13 6 Functional Requirements 6.1 Functional Requirement Description Ticketing Request Ref # Category Ticketing Requirements Description 1.1 Airline Document IssueRequest 1.2 Airline Document Issue Response Request to include: Order Id, Order Item ID, PNR reference, Agency id, aggregator id, commission info (rate, type, amount), Promotional code, contact address(s), Passenger name and type, FOP information (unmasked, encryption required to comply with PCI requirements) (* Refer to data dictionary for optional vs. mandatory fields) Response to include: FOP information (Card payment data needs to be masked to comply with PCI requirements), fare amounts (base, total, equivalent), number of additional services, airline indexing field, booking agent id, carrier fee data, commission info (rate, type, amount), consumed at issuance indicator, coupon info (number, itinerary sequence nbr, status, value, segment id), ticket/doc nbr, ticketing mode indicator, total flt value coupons, tour code, true origin/destination city codes, validating airline designator and waiver code, customer file ref, customer id, date of issue, excess baggage info, fare basis/tkt designator, unstructured fare calc info, structured fare component info, fee owner airline designator, frequent flier info, invoice nbr, net reporting indicator, in connection doc/cpn and qualifier, issuing agent id, issuing agency/airline, ticket/doc indicators (non-commissionable, non endorsable, non interlineable, non-refundable, non reissuable/exchangeable, penalty restriction), nonrefundable/no value/penalty info,, total number of ticket or documents issued, original issue info, FOIDs, passenger name, type code, specific data, present to/at info, present credit/debit card ind, AirDocIssueRQServi ce operation to request an Airline to issue documents such as: flight (ET) and/or ancillary (EMD) AirDocDisplayRS Service operation Airline Ticket Response Business Requirements Document - NDC Payment and Ticketing Page 13 of 49

14 Ref # Category Ticketing Requirements Description pricing info, product characteristic info, promotional code, rate of exchange, RFIC/RFISC, refund calc indicator, ticketing iso country code, reissued flown flt coupon data, response comments, servicing airline/system provider, sold airline info, statistical code, stopover code, tax/fee/charge info, tax on commission on indicator, tax on EMD qualifier, tax/fee/charge data at coupon level, order id, offer id, PNR reference(s), endorsements/restrictions, document type, errors (Transaction and Order/PAX Order Item ID/FOP levels), transaction status (Pending, Completed) 1.3 Airline document display request 1.4 Airline document display response Request to include: Order Id, Order Item, Requestor id, aggregator id, requestor iso country code, ticket document number, PNR reference, FF number, Credit card number, FOID, Passenger name, Airline carrier code Flight date, Origin and Destination, and flight number There should be a flag in the message that allows the ability to filter the results to return: (ET only, EMD only, or all) Response to include: FOP information, fare amounts (base, total, equivalent), booking agent id, carrier fee data, commission info, consumed at issuance indicator, coupon info (number, itinerary sequence nbr, status, value, segment id), customer file ref, customer id, date of issue, excess baggage info, fare basis/tkt designator, unstructured fare calc info, structured fare component info, fee owner airline designator, frequent flier info, invoice nbr, net reporting indicator, in connection doc/cpn and qualifier, issuing agent id, issuing agency/airline, ticket/doc indicators (non-commissionable, non endorsable, non interlineable, non-refundable, non reissuable/exchangeable, penalty restriction), nonrefundable/no value/penalty info, number of booklets issued, nbr of tkt/doc nbrs, original issue info, FOIDs, passenger name, type code, specific data, PNR reference(s), present to/at info, present credit/debit card ind, pricing info, product AirDocDisplayRQ AirDocDisplayRS Business Requirements Document - NDC Payment and Ticketing Page 14 of 49

15 Ref # Category Ticketing Requirements Description characteristic info, promotional code, rate of exchange, RFIC/RFISC, refund calc indicator, ticketing iso country code, reissued flown flt coupon data, response comments, servicing airline/system provider, sold airline info, statistical code, stopover code, tax/fee/charge info, tax on commission on indicator, tax on EMD qualifier, tax/fee/charge data at coupon level, ticket/doc nbr, ticketing mode indicator, total flt value coupons, tour code, true origin/destination city codes, validating airline designator and waiver code, order id, order item, offer id, endorsements/restrictions, document type, errors (Transaction level). Returns: Similar name list response A similar name list might be returned if the requestor uses FF number or CC number to request the display. If a person has more than one ticket/doc with that FF number, then a list of tkt/docs are returned with minimal info to help the requestor determine which one they really want to look at. The similar name list response would use a subset of the display response but no new data items than what is listed for the display response. 1.5 Airline document exchange/reissu e request Request requirements: Request to include: New order Id, Requestor id, aggregator id, requestor iso country code, agency commission, PNR reference, Passenger name and type, FOP information (FOP type), doc nbrs and coupons to be exchanged, AirDocExchangeRQ 1.6 Airline document exchange/reissu e response Response to include: number of additional services, airline indexing field, FOP information, fare amounts (base, total, equivalent), booking agent id, carrier fee data, commission info, consumed at issuance indicator, coupon info (number, itinerary sequence nbr, status, value, segment id), customer file ref, customer id, date of issue, excess baggage info, associated fare basis/tkt designator, unstructured fare calc info, structured fare component info, fee owner airline designator, frequent flier info, invoice nbr, issued in exchange for info (doc nbr, coupon nbr, coupon media), net reporting indicator, in connection doc/cpn and qualifier, issuing agent id, issuing agency/airline, ticket/doc indicators (noncommissionable, non endorsable, non interlineable, non-refundable, non reissuable/exchangeable, penalty restriction), non-refundable/no AirDocDisplayRS Business Requirements Document - NDC Payment and Ticketing Page 15 of 49

16 Ref # Category Ticketing Requirements Description value/penalty info, number of booklets issued, nbr of tkt/doc nbrs, original issue info, FOIDs, passenger name, type code, specific data, PNR reference(s), present to/at info, present credit/debit card ind, pricing info, product characteristic info, promotional code, rate of exchange, RFIC/RFISC, refund calc indicator, ticketing iso country code, reissued flown flt coupon data, response comments, servicing airline/system provider, sold airline info, statistical code, stopover code, tax/fee/charge info, tax on commission on indicator, tax on EMD qualifier, tax/fee/charge data at coupon level, ticket/doc nbr, ticketing mode indicator, total flt value coupons, tour code, true origin/destination city codes, validating airline designator and waiver code, order id, offer id, endorsements/restrictions, document type, errors (Transaction and Order/PAX levels). 1.7 Airline document refund request Request includes: Requestor id, aggregator id, Order id, doc nbr, coupon nbrs, number of ticket/doc nbrs, waiver code AirDocRefundRQ 1.8 Airline document refund response Response includes: Response to include: number of additional services, FOP information, fare amounts (base, total, equivalent), booking agent id, commission info, coupon info (number, status, value, segment id), customer id, date of issue, excess baggage info, associated fare basis/tkt designator, unstructured fare calc info, fee owner airline designator, invoice nbr, issued in exchange for info (doc nbr, coupon nbr, coupon media), net reporting indicator, in connection doc/cpn and qualifier, issuing agent id, issuing agency/airline, non-refundable/no value/penalty info, number of booklets issued, original issue info, FOIDs, passenger name, PNR reference(s), present to/at info, pricing info, product characteristic info, promotional code, RFIC/RFISC, refund calc indicator, refund tax/fee charge info, refund tkt/doc total amount, ticketing iso country code, response comments, servicing airline/system provider, settlement authorization code, sold airline info, statistical code, stopover code, tax/fee/charge info, tax on commission on indicator, tax on EMD qualifier, ticket/doc nbr, ticketing mode indicator, ticket issuance originator code, total flt value coupons, tour code, true origin/destination city codes, validating airline designator and waiver code, order id, offer id, endorsements/restrictions, AirDocRefundRS Business Requirements Document - NDC Payment and Ticketing Page 16 of 49

17 Ref # Category Ticketing Requirements Description document type, errors (Transaction and Order/PAX levels). Airline document history Request Requestor id, aggregator id, doc nbr AirDocHistoryRQ Airline document history response 1.9 Airline document void request 1.10 Airline document void response 1.11 Airline document system cancel request 1.12 Airline document system cancel response 1.13 Airline request for customer data Additional services info, number of services, validating airline, checked in airline info, coupon number, coupon status, previous coupon status, date of service, flown airine info, issued in exchange info, passenger name, reason for issuance code, reason for issuance subcode, settlement authorization code, sold airline info, ticket document nbr, transaction agent id, transacton pseudo city code, transaction date and time, waiver code Request includes: Requestor id, aggregator id, Order id, doc nbr, number of ticket/doc nbrs Response includes: Order id, doc nbr, settlement authorization code Request includes: Requestor id, aggregator id, Order id, order item id, document number, if know Response includes: Order id, order item id, doc nbr Request by an airline for additional data from the customer, including: - One or a combination of customer credentials allowing the airline to authenticate the customer, eg Loyalty scheme membership id and partial password for payment by airline currency, url link to 3D Secure provider, security questions (eg mother s maiden name). Note it is assumed that the customer will not be passing their complete password via the Seller but that AirDocHistoryRS VoidAirlineDocRQ VoidAirlineDocRS AirDocCancelRQ AirDocCancelRS CustomerInputRQ Business Requirements Document - NDC Payment and Ticketing Page 17 of 49

18 Ref # Category Ticketing Requirements Description the airline request will be for a randomly generated subset (eg 2 nd, 4 th & penultimate characters) - Additional customer product delivery data eg limo pickup point If the customer provided data in a preceding Request/Response transaction was invalid then the airline may repeat the request for data, requiring that an error condition can be included in the request (eg password invalid, please try again, you have exceeded the number of allowed tries, please contact our call centre ) 1.14 Customer data response Customer data, eg - Password characters - Verification cryptogram generated by 3D Secure process response texts with their associated requests CustomerInputRS 6.2 Recommended Messages AirDocIssueRQ Request an Airline to issue flight (ET) and/or ancillary (EMD) document(s). Response is AirDocDisplayRS AirDocDisplayRQ Request an Airline to return flight (ET) and/or ancillary (EMD) document details AirDocDisplayRS Response from Airline with flight (ET) and/or ancillary (EMD) document details Request an Airline to exchange/reissue flight (ET) and/or AirDocExchangeRQ ancillary (EMD) document(s). Response is AirDocDisplayRS AirDocRefundRQ AirDocRefundRS AirDocVoidRQ AirDocVoidRS AirDocCancelRQ AirDocCancelRS Request an Airline to refund, part refund (or void if not reported) flight (ET) and/or ancillary (EMD) document(s) Response from Airline with refunded or part refunded (or voided) flight (ET) and/or ancillary (EMD) document details Request an Airline to void flight (ET) and/or ancillary (EMD) document(s) Response from Airline with voided flight (ET) and/or ancillary (EMD) document details Request an Airline to cancel flight (ET) and/or ancillary (EMD) document(s) Response from Airline with cancelled flight (ET) and/or ancillary (EMD) document details Business Requirements Document - NDC Payment and Ticketing Page 18 of 49

19 AirDocHistoryRQ AirDocHistoryRS CustomerInputRQ/RS Request an Airline to return history of flight (ET) and/or ancillary (EMD) document details. Response from Airline with history of flight (ET) and/or ancillary (EMD) document details. Requested in the Order Management BRD, and required to support Payment and Ticketing requirements. Allows an intermediate message pair to be inserted allowing additional information to be collected from the customer, eg authentication of scheme membership, 3D-Secure, customer product fulfillment data such as limo pickup point. 6.3 Message Sequence Flows NOTE: Message Sequence Flow diagrams are provided for illustration purposes only. These diagrams are not intended to recommend any particular business process workflow and do not cover all possible scenarios and workflows as there can be an infinite number of possible constructions. Workflows will depend on the business process users will implement, and may be different from one implementation to another. Message pairs are atomic. Business Requirements Document - NDC Payment and Ticketing Page 19 of 49

20 6.3.1 Order and Ticket a Flight Product with 3D Secure 2 Separately Order and Ticket a Flight Product, with 3D Secure Seller/Agregator Airline 1. AirShoppingRS Offer IDs from preceding shopping process 1.1 Request Order creation of selected offers, include minimum order completion details 2. OrderChangeRQ Selected Offer IDs, passenger details 3. OrderViewRS Order ID and details 2.1. Airline checks offer still valid & availability, creates a flight order. Returns view of Order 3.1. Order confirmation sent to customer. Copy of the Order may be stored locally Agency commits to pay and requests ticket issue with form of payment before Payment Time Limit expires. 4. AirDocIssueRQ Order ID, form of payment, commission 5. CustomInputRQ 3D-Secure request 4.1. Airline checks Order within Payment Time Limit, re-prices Order and if within tolerance, it authenticates the form of payment: - if on Agent merchant then check accreditation status - If on Airline merchant and if Airline requires additional 3D Secure authorisation for online agents, then Airline accesses its card authentication service for a 3D Secure url which it passes back to seller 5.1 online agency displays 3D Secure request to customer to complete. Returns 3D Secure verification cryptogram (or error) 6. CustomInputRQ 3D Secure cryptogram 6.1. Airline passes 3D Secure cryptogram to authentication service and requests payment authorisation. If authorised the Airline issues accountable documents and updates Order. Returns accountable document data & ref 7. AirDocDisplayRS accountable document details & refs 7.1. Ticket receipt sent to customer. Copy of the ticket data may be stored locally Airline closes sales report and processes settlement 2 3D Secure is used as an illustration for one potential methodology of securing Credit Card transactions. It must be noted, that an Airline, or any other 3 rd party implementer, may have its own strategy on credit card data processing. While 3D Secure is identified as one potential methodology, an airline may choose to use any other methodology, as would be aligned with its strategy and it would see fit. Business Requirements Document - NDC Payment and Ticketing Page 20 of 49

21 6.3.2 Ticket a Flight Product with cash and miles form of payment Issue Ticket on a Flight Order using cash and miles forms of payment Seller/Agregator Airline 1. OrderViewRS Order ID and details 1.1. Order confirmation sent to customer. Copy of the Order may be stored locally Order is wholly or partly payable in airline loyalty points. Customer provides their airline membership scheme details to the Seller who requests ticket issue with cash and miles forms of payment. 2. AirDocIssueRQ Order ID, customer loyalty scheme identity, form of payment, commission 2.1. Airline checks Order within Payment Time Limit, re-prices Order and if within tolerance, it authenticates the form of payment (if Agent merchant then check ticket authority, if Airline merchant then authenticate payment card). 2.2 Airline requires authentication of the customer s scheme membership and generates a request for a random part of the customer s password 3. CustomInputRQ Password request 3.1 Seller passes the partial password request to the customer and enters his response. 4. CustomInputRQ Partial password 7. AirDocDisplayRS accountable document details & refs 5.1. Airline validates password response, checks the customer s account holds sufficient miles and then issues accountable documents, updates Order and deducts the miles from the customer account. Returns accountable document data & ref. If password not correct may repeat password request for a limited number of times 7.1. Ticket receipt sent to customer. Copy of the ticket data may be stored locally Airline closes sales report and processes settlement Business Requirements Document - NDC Payment and Ticketing Page 21 of 49

22 6.3.3 Separately Cancel an Order and Request a Refund Separately Cancel an Order and Request a Refund Seller/Agregator Airline 0.1. Customer asks Seller to cancel and refund an order item. Seller checks what refund rules are applicable 1. OrderRulesRQ Order ID, order item 1.1. Airline checks what refund rules apply to the order item and returns what change fees apply and the refundable amount, if any 2. OrderRulesRS Order ID and details 2.1. Seller requests cancellation of the order item 3. OrderChangeRQ (if part order) or OrderCancelRQ (if whole order) Order ID, order item 3.1 Airline cancels order item and returns an updated view of order or if whole order cancelled then return cancel confirmation. Return applicable change fees and value of the refundable amount, if any 4. OrderViewRS (part order) or OrderCancelRS (whole order) Updated order details 4.1. Seller requests refund for the cancelled order item 5. AirDocRefundRQ Order ID, order item, accountable document number 5.1 Airline checks Agency s accreditation status, that the Order item is cancelled and that the document is valid & unused and then applies refund rules. The document status is changed to Refunded against the original form of payment net of change fees. Settlement Auth Code is obtained. 6. AirDocRefundRS Updated document details, SAC 6.1 Seller sends confirmation of the change to the Order and refund due to the customer 6.2 Airline closes sales report and refunds through settlement process if agency merchant or directly to card holder account if airline merchant Business Requirements Document - NDC Payment and Ticketing Page 22 of 49

23 6.3.4 Combined Order Cancellation and Refund Combined Cancelation of an Order and Refund Seller/Agregator Airline 0.1. Customer asks Seller to cancel and refund an order item. Seller checks what refund rules are applicable 1. OrderRulesRQ Order ID, order item 1.1. Airline checks what refund rules apply to the order item and returns what change fees apply and the refundable amount, if any 2. OrderRulesRS Order ID and details 2.1. Seller requests cancellation of an order item and refund 3. OrderChangeRQ (if part order) or OrderCancelRQ (if whole order) Order ID, order item, accountable document number 3.1 Airline checks Agency s accreditation status and that the document is valid & unused and then applies refund rules. The document status is changed to Refunded against the original form of payment net of change fees. Settlement Auth Code is obtained. Airline cancels order item and returns an updated view of order or if whole order cancelled then return cancel confirmation, together with updated document details. 4. OrderViewRS (part order) or OrderCancelRS (whole order) Updated order details, updated document details, SAC 4.1 Seller sends confirmation of the change to the Order and refund due to the customer 4.2 Airline closes sales report and refunds through settlement process if agency merchant or directly to card holder account if airline merchant Business Requirements Document - NDC Payment and Ticketing Page 23 of 49

24 6.3.5 Separately Change an Order and Request Ticket Reissue Separately Change Itinerary on an Order and request Ticket Reissue Seller/Agregator Airline 0.1 Request new product options for specified order items 1. ItinReshopRQ Order ID, order item 1.1. Return new Offers, including for ancillaries impacted by the change & additional price to pay (new total price plus change fees less original value) 2. ItinReshopRS Order & new Offer IDs, 2.1. Customer reviews offers and requests order to be amended for selected offers 3. OrderChangeRQ Order and selected Offer IDs 3.1. Airline checks offer and price and checks fare rules for change fees. Airline makes changes to order and returns updated view, including outstanding amount to pay 4. OrderViewRS Updated Order 4.1 Seller submits payment and requests reissue of accountable docs 5. AirDocExchangeRQ Order ID, form of payment 5.1 Airline checks offer price still valid and within payment time limit. Airline checks Agency s accreditation status and authorises payment for the additional collection, changes status on the old documents to Exchanged and issues new documents against the new form of payment. 6. AirDocDisplayRS Order ID, new accountable docs 6.1. Updated Order confirmation and new document references sent to customer. Copy of the Order may be stored locally. Business Requirements Document - NDC Payment and Ticketing Page 24 of 49

25 6.3.6 Combined Order Change and Ticket Re-issue Combined Change to an Order and Ticket Reissue Seller/Agregator Airline 0.1 Request new product options for specified order items 1. ItinReshopRQ Order ID, order item 1.1. Return new Offers, including for ancillaries impacted by the change & additional price to pay (new total price plus change fees less original value) 2. ItinReshopRS Order & new Offer IDs, 2.1. Customer reviews offers and requests order to be amended for selected offers with new accountable documents issued and submits payment 3. OrderChangeRQ Order and selected Offer IDs, form of payment 3.1 Airline checks offer price still valid and within payment time limit. Airline checks Agency s accreditation status and authorises payment for the additional collection, changes status on the old documents to Exchanged and issues new documents against the new form of payment. Airline makes changes to order and returns updated view 4. OrderViewRS Updated Order, new accountable docs 4.1. Updated Order confirmation and new document references sent to customer. Copy of the Order may be stored locally. Business Requirements Document - NDC Payment and Ticketing Page 25 of 49

26 7 Data Description Please refer to Appendix NDC Payment and Ticketing - Data Dictionary Appendix v1.0 - DRAFT for PADIS REVIEW, maintained as a separate document, due to size. 8 Non-Functional Requirements Feature Definition Requirement Shopping Standard based and interoperable messaging protocol Send Only Receive only Request/Response exchange Diagnostics/Routing Reliability Messaging protocol must be based on industry standards to enable interoperability Also called Push MEP is simple one-way messaging where a message is sent with no expectation of a response. Also called Pull MEP is a message pattern where a non-addressable sender supports the ability to explicitly obtain messages from another application. This can be used for exchanges that are of pull type only Message pattern consists of one or more request/response pairs. The correlation between a request and a response is well defined. In this MEP the response maybe deferred and the requesting application may or may not block application processing until a response is received Authentication, diagnostic, logging & routing information should be included in the message header and not the payload Protocol capability to support assured and single delivery to the receiving application with no message loss Applicable n/a n/a Applicable Applicable Applicable Business Requirements Document - NDC Payment and Ticketing Page 26 of 49

27 Feature Definition Requirement Shopping Message acknowledgement/ delivery report Fault management Priority handling Data confidentiality Message exchange protocol acknowledgement provides guaranteed delivery in a sense that if there is any communication failure or any remote system unavailability, the message is transparently repeated until the application has received it. This is referred to as reliability feature necessary for business critical messages. Message loss may happen using application acknowledgement only in cases like application or system problems. It may however be complementary to reliability mechanism. Additionally there is also a notion of end to end delivery report that can be used to request a delivery notification form the end user generated by its messaging agent. This may be used for cases that a proof of delivery is required by the sender. Capability to report permanent or transient problems or errors in message exchange and return this information to the sending application Capability to assign priority to messages and process accordingly separate between processing and delivery related priority handling. Assurance that data remain secret except for those entities that have been authorized to access this data. (i.e. encryption/decryption). Identify any data elements that are subject to specific confidentiality requirements. For example payment card data or personal data may be subject to PCI compliance requirements. n/a Applicable Applicable Applicable to passenger personal data Business Requirements Document - NDC Payment and Ticketing Page 27 of 49

28 Feature Definition Requirement Shopping Requester Authentication Message integrity Capability to confirm the identity claimed by a sender or entity Capability to ensure that data are preserved in its original form and not altered Supported in all Request messages. To include the identity of the source of the request (the identity of the selling entity, the staff member making the request and the Point of Sale channel ) and any intermediaries that the request has passed through. Applicable to the message body Capability to target multiple recipients Multi part Messages Support for attachment (for rich documents (image, large files etc.) Ability to send a message to more than one recipient or applications Communications do not support the transmission of messages in multiple parts. Ability to have digital attachments (to allow simpler management of attachments and optimized transport) Applicable, eg to multiple directly connected airlines plus one or more aggregators Applicable Attachments must not appear in the message only links to them Message Compression Capability to compress (to save bandwidth) Applicable Support for specific protocols Please indicate what messaging protocols you expect the industry will use to exchange the messages. May need to support either or both SOAP and REST Business Requirements Document - NDC Payment and Ticketing Page 28 of 49