Overview
The OrderChange API provides the capability for sellers to confirm the change of date/time of an existing itinerary for a given ticketed Booking Reference/PNR with or without payment. The API will amend the Itinerary and reissue tickets.
OrderChange API provides the capability for sellers to confirm an unticketed order (hold booking) for both Online and Offline sellers. Furthermore, it will provide the capability to add Date of birth and Gender information for the passenger (for hold booking confirmation).
OrderChange API provides the capability to reserve both free and paid seat(s) post order creation.
NDC Schema: OrderChange RQ & OrderChange RS v 21.3
Pre-condition(s)
- Requestors (Travel Agency, Meta-Search, TMC) must have an agreement with Virgin Atlantic
- The Requestor must have already created Booking via NDC Channel
In Scope
Request
-
One Way, Return, Multi-city and Open-Jaw trip search
-
Quoted OfferID and OfferItemIDs
-
PaxRefID
-
OrderID and BookingID
-
GDS BookingID (VS PNR) in place of OrderID
-
Payment information with 3DS2 authenticated information for Online sellers
-
Payment information without 3DS2 authenticated information for Offline sellers
-
Passenger’s Date of Birth/Gender
-
Selected seat details
-
India GST details
-
Passenger APIS details
-
Alacarte OfferItem from ServiceListRS (Free of charge services)
Response
-
OrderID with a Booking/ PNR with Pax/ Individual details
-
Price Differential Info
-
e-Ticket document per Pax, EMD per Paid Seat and original ticket number
-
Confirmation Email - sent email address provided at time of booking creation
-
Confirmation Email on successful seat reservation
-
Passenger details with APIS information
-
India GST details
Out of Scope
- Multiple/ Split Form of Payments
- Group Booking
- Redemption
- AFOP (Bank transfer, wallet)
- Airline initiated 3DS2 authentication
Endpoints
Sandbox Environment
This is a complete replica of production and a test environment where developers can build against our NDC APIs and validate their code for build of new features, ahead of certification and go-live. This environment should also be used for debugging
Preview Environment
This environment will have the same capability features as Sandbox but in addition we may deploy breaking changes or new features in advance of release to Sandbox and Production in order to give developers early visibility.
https://ndcdeveloper.virginatlantic.com/SalesAndRevenueManagement/OrderShopping/OfferManagement/v1/OrderChange
https://ndcdeveloper.virginatlantic.com/preview/SalesAndRevenueManagement/OrderShopping/OfferManagement/v1/OrderChange
Business Rules
Passenger Type
Supported Passenger Type Codes (PTC) are following:
PTC Code (ENUM) |
Name |
Age |
PaxID |
ADT |
Adult |
16 years or over |
ADULT_1 |
CHD |
Child |
2 to 12 years |
CHILD_1 |
GBE |
Young Adult |
12 to 16 years |
YOUNG_1 |
INF |
Infant |
Less than 2 years |
INFANT_1 |
Uniquely request PaxID based on PTC (refer PaxID column).
Service cannot be called for Unaccompanied Minor [PTC: CHD, GBE] for travelling alone
ID <-> RefID Syntax/Format
ID <-> RefID attribute request/response formats are shown as follows:
ID |
RefID |
Syntax |
Example |
PaxJourneyID |
PaxJourneyRefID |
"JOUR"+<number counter> |
JOUR1 |
PaxSegmentID |
PaxSegmentRefID |
"SEG"+<number counter> |
SEG1 |
PaxID |
PaxRefID, PassengerRefs |
Refer PaxID based on PTC |
ADULT_1 |
PriceClassID |
PriceClassRefID |
"PC"+<number counter> |
PC1 |
ServiceID |
ServiceRefID |
"SV"+<number counter> |
SV1 |
BaggageAllowanceID |
BaggageAllowanceRefID |
"BAGA"+<number counter> |
BAGA1 |
ServiceDefinitionID (for BaggageAllowance) |
ServiceDefinitionRefID |
"BAGSRV"+<number counter> |
BAGSRV1 |
Currency (PoC)
Tickets will be reissued in the same currency in which the original ticket was issued.
Offer
The requested OfferID must be from the previous Order Reshop response (in response to OrderQuote) otherwise an error will be returned. The OfferID[s] is valid for 20 minutes, within the time-limit OrderChange request must be triggered otherwise the offer will be deleted from the system and an error will be returned upon requesting this offer.
OfferItem
One or more OfferItem(s) are included in a Priced Offer and each OfferItem is unique with detailed fare and tax breakdown per PTC.
Party Authentication
The service checks if the agent calling the service has the rights. If the agent does not have such authority, then the service will not process and will return an error. A booking can only be retrieved and serviced by the same agent that created the booking.
Billing Address - Payment failed
For US & CA countries – Address information is validated (Street, City, Zip-code, State). If given Address is Invalid – Error code: 317 & 708 is returned.
Payment Cards
Supported Payment Card Types
Credit Card Issuers |
Vendor Code |
Visa |
VI |
MasterCard |
CA |
American Express |
AX |
Diners |
DC |
3DS2 Payment Authorization Rules
Before proceeding for payment authorization, we will be validating received ECI values and authentication status.
Card Type |
ECI Values |
Authentication Status |
Remarks/Results |
Visa, American Express, Diners Club, and Discover |
05 |
Y- Customer authenticated. |
The issuer has authenticated the cardholder by verifying the password or other identity information.
Proceed with the authorization request |
06 |
A- An authentication attempt occurred but could not be completed. |
Attempted to authenticate the cardholder, but either the cardholder or issuer was not participating.
Proceed with the authorization request |
07 |
N- Customer not authenticated. |
Authentication failed. Partners should not send authentication results. Merchant should not submit authorization request.
Transaction will be stopped with error message |
07 |
U- Unable to perform authentication |
Unable to Authenticate or Card Not Eligible for Attempts (such as a Commercial or anonymous Prepaid card).
Transaction will be stopped with error message |
Master |
02 |
Y- Customer authenticated |
The issuer has authenticated the cardholder by verifying the password or other identity information.
Proceed with the authorization request |
01 |
A- An authentication attempt occurred but could not be completed. |
Attempted to authenticate the cardholder, but either the cardholder or issuer was not participating.
Proceed with the authorization request |
00 |
N- Customer not authenticated |
Authentication failed. Partners should not send authentication results. Merchant should not submit authorization request.
Transaction will be stopped with error message |
00 |
U- Unable to perform authentication |
Unable to Authenticate or Card Not Eligible for Attempts (such as a Commercial or anonymous Prepaid card).
Transaction will be stopped with error message |
- For successfully authenticated transactions, the following mandatory field values must be sent with Order request:
- CAVV, ECI, EnrollmentStatus and CustomerAuthStatus
Seat Fulfilment Rules
Seat assignment will fail if:
- 1. When the price changes at the time of seat reservation
- 2. If the requested seat is already reserved or blocked
- 3. If the requested seat number does not exist in the retrieved seat map
- 4. Payment authorisation failure for paid seat assignment request
- 5. If seat purchase is for a single flight segment and at least one requested seat can’t be booked
Warning returned for:
- 1. Seat purchase is requested for more than one flight segments and for some reason seats can’t be booked on at least one flight segment
GDS PNR
PNR created in a GDS (with VS Flight segment) should be used to in place of OrderID. Only the VS booking reference can be used in OrderChange RQ. If the booking doesn’t have VS ticket (932), the booking will not be returned, and seat assign will fail.
India GST
Good and Service Tax (GST) will be accepted for agents based out of India and will be added to the PAX details in the PNR. Applicable only if at least one segment originates from Indian city.
Services (SSR)
Available services that are returned from ServiceList API (as Offers) can be requested to be added for each passenger along with flight and seat in the OrderChangeRQ.
Feedback for this page? How was your experience? Please click
here