Release 2024.04

Examples of messages with complete flows can be downloaded from here.

The response is the OrderViewRS.

New or modified element

To be removed/deprecated

Unique to v2 - Branded Fares

Unique to V1 - Fare Families

Common Sections

HTTP Header

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES
api_key	Your unique key used to authorize access to the API. update source	Alphanumeric	N/A

Language, Version and Name Space

NAME

DESCRIPTION

FORMAT

ALLOWED/POSSIBLE VALUES

NDC SERVICES

Version

The IATA version of the message

Mandatory for Schema

Numeric

Any

All Services

PrimaryLangID

Two character ISO Language Code, for the agent’s preferred language.

This is used for error messages and some other data such as legal waivers.

2 Alphabetical

EN
ES

All Services

(except in the OrderChangeNotification)

xmlns

IATA official website

Mandatory for Schema

Alphanumeric

Any

All Services

Point of Sale

HEADER NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES	NDC SERVICES
<PointOfSale>
Location / CountryCode	The point of sale country code.	2 letter country code	List of countries	All request messages

Document

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES	NDC SERVICES
<Document>
ReferenceVersion	The IATA Schema version.	Numeric	Any	All Services

Party

Sender Section

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES	NDC SERVICES
<Party>
Sender / TravelAgencySender / Name	Agency Name Iberia will always use the Name stored in our system when the Seller/Sender registered to use our NDC.	Alphanumeric	Any	All Request messages and OrderViewRS
Sender / TravelAgencySender / Contacts / Contact Attribute ContactType	Used to indicate to whom to send email confirmation emails and what information to include. More information can be found here	Only as per allowed values	`"itin_only"` or `"itin_and_price"`	All Request messages and OrderViewRS
Sender / TravelAgencySender / Contacts / Contact / EmailContact / Address	Email to contact the Travel Agency Mandatory for schema if 'EmailContact' tag is indicated.	Alphanumeric	Any	All Request messages and OrderViewRS
Sender / TravelAgencySender / Contacts / Contact / PhoneContact / Application	To indicate whether the Travel Agency phone is a fixed line or mobile.	Only as per allowed values	`"BUSINESS"` or `"MOBILE"`	All Request messages and OrderViewRS
Sender / TravelAgencySender / Contacts / Contact / PhoneContact / Number Attribute CountryCode	Phone number to contact the Travel Agency, with CountryCode. <Number CountryCode="+34">666666666</Number>	Numeric	Any valid telephone number with Country code.	All Request messages and OrderViewRS
Sender / TravelAgencySender / Contacts / Contact / Name / Surname	The surname of the person to contact in the Travel Agency. Mandatory for schema if 'Name' tag is indicated.	Alphanumeric	Any	All Request messages and OrderViewRS
Sender / TravelAgencySender / Contacts / Contact / Name / Given	The given name of the person to contact in the Travel Agency	Alphanumeric	Any	All Request messages and OrderViewRS
Sender / TravelAgencySender / IATA_Number	Sender IATA identifier: IATA number (used by IATA accredited Travel Agents) TIDs number (recommended if you are not an IATA Accredited agent) If using the IATA Delegation functionality for Servicing orders, and no CorporateSender information is included in the message, then the Servicing IATA's number is included here.	Numeric	7/8 Numbers	All Request messages and OrderViewRS
Sender / TravelAgencySender / OtherIDs / OtherID	Pseudo IATA (assigned by Iberia) NDC Mandatory	Numeric	7/8 Numbers	All Request messages and OrderViewRS
Sender / TravelAgencySender / AgencyID	Presently, Iberia does not make use of this field. Mandatory for Schema.	Alphanumeric	Any	All Request messages and OrderViewRS
Sender / CorporateSender / ID	ID for the Corporate. These are issued by Iberia and British Airways, and are sometimes referred to as a “JBID”. Not applicable to OrderList. NDC Mandatory	Alphanumeric	Identifier assigned by Iberia.	All Request messages and OrderViewRS
Sender / ORA_Sender / AirlineID	Code of the Offer/Order Responsible Airline sending the message. Used in the OCN message.	Two Alphabetical Letters	IB	OrderChangeNotif
Sender / ORA_Sender / Name	Name of the Offer/Order Responsible Airline sending the message. Used in the OCN message.	Alphabetical	Iberia	OrderChangeNotif

Participant Section

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES	NDC SERVICES
<Party>
Participants / Participant / TravelAgencyParticipant / Name	Travel Agency Name. This is the Travel Agent who is registered with Iberia and British Airways as managing travel for the above Corporate. A validation check is run against our Sales database.	Alphanumeric	Any	All Request messages, and OrderView when using CorporateSender. All Servicing Request messages (except OrderListRQ), and OrderView when using IATA Delegation.
Participants / Participant / TravelAgencyParticipant / Type	Only when using IATA Delegation functionality. Mandatory for IATA Delegation when CorporateSender is used. This is used to indicate whether the TravelAgencyParticipant is the agency undertaking the Servicing or the agency that created or paid for the order. see example: Party Elements	Only as per allowed values	`"SERVICING_IATA"` or `"RESPONSIBLE_IATA"`	This element is returned in all services except: AirShopping OfferPrice OrderCreate OrderList
Participants / Participant / TravelAgencyParticipant / Contacts / Contact Attribute ContactType	Used to indicate to whom to send email confirmation emails and what information to include	Only as per allowed values	`"itin_only"` or `"itin_and_price"`	All Request messages, and OrderView when using CorporateSender. All Servicing Request messages (except OrderListRQ), and OrderView when using IATA Delegation.
Participants / Participant / TravelAgencyParticipant / Contacts / Contact / EmailContact / Address	Email to contact the Agency	Alphanumeric	Any	All Request messages, and OrderView when using CorporateSender. All Servicing Request messages (except OrderListRQ), and OrderView when using IATA Delegation.
Participants / Participant / TravelAgencyParticipant / Contacts / Contact / PhoneContact / Application	To indicate whether the Travel Agency phone is a fixed line or mobile.	Only as per allowed values	`"BUSINESS"` or `"MOBILE"`	All Request messages, and OrderView when using CorporateSender. All Servicing Request messages (except OrderListRQ), and OrderView when using IATA Delegation.
Participants / Participant / TravelAgencyParticipant / Contacts / Contact / PhoneContact / Number	Phone number to contact the Travel Agency	Numeric	Any	All Request messages, and OrderView when using CorporateSender. All Servicing Request messages (except OrderListRQ), and OrderView when using IATA Delegation.
Participants / Participant / TravelAgencyParticipant / Contacts / Contact / Name / Surname	The surname of the person to contact in the Travel Agency. Mandatory for schema if 'Name' tag is indicated.	Alphanumeric	Any	All Request messages, and OrderView when using CorporateSender. All Servicing Request messages (except OrderListRQ), and OrderView when using IATA Delegation.
Participants / Participant / TravelAgencyParticipant / Contacts / Contact / Name / Given	The given name of the person to contact in the Travel Agency	Alphanumeric	Any	All Request messages, and OrderView when using CorporateSender. All Servicing Request messages (except OrderListRQ), and OrderView when using IATA Delegation.
Participants / Participant / TravelAgencyParticipant Attribute SequenceNumber	Sequence number related to the Participants, irrespective of their type (TravelAgency, Aggregator, etc…), sent in the request. The order of the sequence number must follow the order in which the parties are connecting to our API. With the highest number being the party whose API key is being used to connect to us, and the lowest number (1) being the party in contact with the travelling passenger. See example 5 below.	Numeric		All messages when there are more than one Participant.
Participants / Participant / TravelAgencyParticipant / IATA_Number	The Travel Agency’s unique identifier: IATA number (if you have one) TIDs number (recommended if you do not have an IATA) If using the IATA Delegation functionality for Servicing orders: If no CorporateSender information is included in the message, then the Responsible IATA's number must be included here. If CorporateSender information is included in the message, then the Servicing IATA’s number and the Responsible IATA's number must both be included here with their SequenceNumber and their applicable Type. The Servicing IATA must have the lowest SequenceNumber and the Responsible IATA must be the next number in the sequence. In both cases. See examples below	7/8 Numeric	The identifier registered with Iberia.	All Request messages, and OrderView when using CorporateSender. All Servicing Request messages (except OrderListRQ), and OrderView when using IATA Delegation.
Participants / Participant / TravelAgencyParticipant / AgencyID	Iberia do not presently use this field, although it is mandatory as per the schema.	Alphanumeric	Any	All Request messages.
Participants / Participant / AggregatorParticipant Attribute SequenceNumber	Sequence number related to the Participants irrespective of their type (TravelAgency, Aggregator, etc…), sent in the request. The order of the sequence number must follow the order in which the parties are connecting to our API. With the highest number being the party whose API key is being used to connect to us, and the lowest number (1) being the party in contact with the travelling passenger. See example 5 below.	Numeric		All Request messages.
Participants / Participant / AggregatorParticipant / AggregatorID	The unique identifier of the Aggregator. This can be any of the following: IATA number (if you have one) TIDs number (recommended if you do not have an IATA) Pseudo IATA(assigned by Iberia and British Airways)	7/8 Numeric	The identifier registered with Iberia.	This element is returned in all services except: OrderViewRS
Participants / Participant / AggregatorParticipant / Name	The name of the Aggregator as stored in our database associated to the AggregatorID. following:	Alphanumeric	The name registered with Iberia.	This element is ONLY used and returned in the: OrderChangeNotification

Recipient Section - (only for OCN message)

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES	NDC SERVICES
<Party>
Recipient / TravelAgencyRecipient / IATA_Number	Used in the OCN message to identify the IATA of the TravelAgency/Seller to whom this message is being directed.	7/8 Numeric	N/A	OrderChangeNotification
Recipient / TravelAgencyRecipient / AgencyID	Used in the OCN message to include the name, as per our database, of TravelAgency/Seller to whom this message is being directed.	Alphanumeric	N/A	OrderChangeNotification

In addition to the Common Sections, this service is called with the following data:

Query

Query - Common

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES
<Query> (Common)
OrderID	Order ID previously generated	Alphanumeric	Any

Query - AcceptRepricedOrder

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES
<Query / AcceptRepricedOrder>
ResponseID	The ID of the response from which the new offer is being accepted and applied to the Order on hold	Alphanumeric	Any

Query - PassengerServicing

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES
<Query / PassengerServicing> (Update contact info flows, name, e-mail, phone, frequent flyer info…)
New Attribute PassengerID	The unique identifier of the Passenger whose information is being updated.	Alphanumeric	The PassengerID obtained from the previous OrderViewRS having previously retrieved the Order.
New / ContactInfoRef	Contact info reference, which contact info (email & phone) filled in below will update original contact info.	Alphanumeric	Any
New / Individual / Given	Name of the passenger to change	Alphanumeric	Any
New / Individual / Surname	Surname of the passenger to change (Agency can specify separated by a special character "@" first and second surname → Ex: De la Morena@López)	Alphanumeric	Any
New / LoyaltyProgramAccount / Airline / AirlineDesignator	Airline ID associated to frequent flyer number	Alphanumeric	Any
New / LoyaltyProgramAccount / AccountNumber	Frequent Flyer or On Business number account	Alphanumeric	Any
New / ActionType	Action type Name correction flow Contact info (email & phone) correction flow Add/Update Frequent Flyer Number Add/Update On Business Number	Alphabetical	Add Remove
Previous Attribute PassengerID	Passenger ID, which info will be updated PassengerID attribute value can be indicated in PassengerID attribute from AirShopping request.	Alphanumeric Alphanumeric	Type of Passengers Value indicated in PassengerID attribute from AirShopping request
Previous / Individual / GivenName	Old passenger given name, not mandatory, but if informed and does not match, an error will be shown	Alphanumeric	Any
Previous / Individual / Surname	Old passenger surname, not mandatory, but if informed and does not match, an error will be shown	Alphanumeric	Any
Previous / ContactInfoRef	Old contact info reference	Alphanumeric	Any
Previous / ActionType	Action type	Alphabetical	Add Remove

Query - OrderServicing

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES
<Query / OrderServicing> (Add ancillaries, delete paxes, partial refund and voluntary flight change flows…)
AcceptOffer / Offer Attribute OfferID	Identification of the service Offer SeatAvailability ResponseID / ServiceList ResponseID / New Offer Identification (Voluntary Change Flow) Add ancillaries flow Voluntary Change flow Delete Passengers flow Partial Refund flow	Alphanumeric	Any
AcceptOffer / Offer Attribute Owner	Airline identification Add ancillaries flow Voluntary Change flow Delete Passengers flow Partial Refund flow	Alphabetical	IB
AcceptOffer / Offer Attribute ResponseID	Response Identification Add ancillaries flow Voluntary Change flow Delete Passengers flow Partial Refund flow	Alphanumeric	Any
AcceptOffer / Offer / OfferItem Attribute OfferItemID	Offer item identification of the new service to add Add ancillaries flow Voluntary Change flow Delete Passengers flow Partial Refund flow	Alphanumeric	Any
AcceptOffer / Offer / OfferItem / PassengerRefs	Reference for the passengers Add ancillaries flow Voluntary Change flow Delete Passengers flow Partial Refund flow	Alphanumeric	Type of Passengers
AcceptOffer / Offer / OfferItem / SeatSelection / Row	Row for the seat Add ancillaries flow	Numeric	Any
AcceptOffer / Offer / OfferItem / SeatSelection / Column	Column for the seat Add ancillaries flow	Alphabetical	Any
Delete / OrderItemID	OrderItem identification to be deleted. When cancelling flights with Ancillaries or other associated services it is only necessary to include the OrderItemIDs of the flights, as all associated services will automatically be cancelled with the flights.	Alphanumeric	Any

Query - Payments

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES
<Query / Payments / Payment> (Add ancillaries and voluntary flight change flows…)
Type	Payment Methods can vary depending on market and type of seller. Please check here.	Alphabetical	CA (Cash) CC (Credit Card) MS (Voucher) SF (Service Fee)
-- This refers to Cash payment method --
Method / Cash Attribute CashInd	Cash payment method.	Alphabetical	true
Amount Attribute Code	Total amount of the offer. Code refers to currency code for payment.	Numeric	Any
Payer / ContactInfoRefs	Reference for the payer info, that must be associated correctly in the XML below. In Cash Payment Method is OPTIONAL	Alphanumeric	Any valid reference associated in the XML below.
-- This refers to Credit Card method – If Secure Payment applies additional info needed is defined below in 3DS INFO --
Method / PaymentCard Attribute refs	NDC Mandatory for 3DS and/or installments payment. This is used to reference the associated 3DS info in PaymentCardSecureInfo ObjectKey, and/or the installment payment info in PaymentFormMetadata MetadataKey. If both 3DS and installment payments are being used for the same Order, then the two references are included here together separated by a space. Example: <PaymentCard refs="KEY_3DS KEY_QUOTAS">	Alphanumeric	Any
Method / PaymentCard / CardType	Type of credit card	Alphanumeric	1-6 characters
Method / PaymentCard / SeriesCode	Series Code of credit card	Numeric	1-8 characters
Method / PaymentCard / CardHolderName	Card Holder Name	Alphanumeric	0-50 characters
Method / PaymentCard / CardHolderBillingAddress / Street	Street of the billing address of the cardholder. NDC Mandatory that at least one field has to be filled in inside "CardHolderBillingAddress" tag.	Alphanumeric	If tag is indicated once, only first 40 characters will be considered If tag is indicated twice, only first 80 characters will be considered
Method / PaymentCard / CardHolderBillingAddress / CityName	City of the Billing Address of cardholder NDC Mandatory that at least one field has to be filled in inside "CardHolderBillingAddress" tag.	Alphanumeric	Only first 50 characters will be considered
Method / PaymentCard / CardHolderBillingAddress / StateProv	State Prov. of the Billing Address of cardholder NDC Mandatory that at least one field has to be filled in inside "CardHolderBillingAddress" tag.	Alphanumeric	1-40 characters
Method / PaymentCard / CardHolderBillingAddress / PostalCode	Postal Code of the Billing Address of cardholder NDC Mandatory that at least one field has to be filled in inside "CardHolderBillingAddress" tag.	Alphanumeric	2-10 characters
Method / PaymentCard / CardHolderBillingAddress / CountryCode	Country Code of the Billing Address of cardholder NDC Mandatory that at least one field has to be filled in inside "CardHolderBillingAddress" tag.	Alphabetical	2 characters
Method / PaymentCard / CardNumber	Number of credit card	Numeric	1-9 characters
Method / PaymentCard / EffectiveExpireDate / Expiration	Effective expiration date of the credit card	Numeric	4 characters
Amount Attribute Code	Total amount of the offer. Code refers to currency code for payment.	Numeric	Any
Payer / ContactInfoRefs	Reference for the payer info, that must be associated correctly in the XML below.	Alphanumeric	Any valid reference associated in the XML below.
-- This refers to Voucher payment method --
Method / Voucher	Voucher payment method.	Alphabetical	true
Method / Voucher / Number	Number of the voucher	Alphanumeric	any
Amount Attribute Code	Total amount of the offer. Code refers to currency code for payment.	Numeric	Any
Payer / ContactInfoRefs	Reference for the payer info, that must be associated correctly in the XML below.	Alphanumeric	Any valid reference associated in the XML below.
-- This refers to Service Fee method --
Method / Other / Remarks Attribute refs	References for all passengers of the order	Alphanumeric	any
Method / Other / Remarks / Remark	Service Fee payment method Mandatory for schema if "Remarks" tag is indicated	Alphabetical	ServiceFee
Amount Attribute Code	Total amount of the Service Fee Code refers to currency code for payment.	Numeric	Any

OrderChangeMetadata

NAME
DESCRIPTION
FORMAT
ALLOWED/POSSIBLE VALUES
<OrderChangeMetadata / Other / OtherMetadata / PaymentFormMetadatas> ↔ 3DS INFO (Add ancillaries and voluntary flight change flows…)
PaymentFormMetadata

Attribute
MetadataKey

For 3DS info, this key is mandatory and can be filled in with any value.
For installments payment info, this key have to match with installments reference in PaymentCard Refs.
Alphanumeric
Any
PaymentFormMetadta / Text
Installments payment info
Alphanumeric
installments/n
where n=number of installments.
Valid example: installments/3
PaymentFormMetadata / AugmentationPoint / AugPoint

Attribute
Owner
Airline code associated to 3DS Payment, in this case IB.
Alphabetical
IB
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment

Attribute
xsi:schemaLocation
Reference to IATA 3DS new schema info xsd for Secure Payment.
Alphanumeric
3-D Secure Payment
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment

Attribute
xmlns
Reference to IATA 3DS new schema info for Secure Payment.
Alphanumeric
3-D Secure Payment
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment

Attribute
xmlns:xsi
Reference to IATA 3DS new schema info for Secure Payment.
Alphanumeric
3-D Secure Payment
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo

Attribute
ObjectKey
This Attribute is used to reference the applicable PaymentCard in the Payments section of this message.
Alphanumeric
Any
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentMethodCriteria / PaymentCardCriteria / SecurePayerAuthenticationVersion / CardEnrollmentVersionText
The version of 3D-Secure for which the card is enrolled.

Alphanumeric
This field must contain the specific 3DS version used for authentication:
1.0.2
2.1.0
2.2.0
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentMethodCriteria / PaymentCardCriteria / SecurePayerAuthenticationVersion / SupportedVersionText
The version of 3D-Secure supported.

Alphanumeric
This field must contain the specific 3DS version used for authentication:
1.0.2
2.1.0
2.2.0
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion1 / PayerAuthenticationResponseText
Contains the information that conveys the result of the 3D Secure authentication transaction. Applicable for 3D Secure Version 1.x.x. This tag is NDC mandatory for version 1.x.x and if is not included, an error will be returned.
This field is the authentication response for the 3-D Secure transaction. It is used to determine whether or not the customer has been authenticated by the card issuer. It must be included in the final authorization request. Example: eJzVWFmzosgSfudXdPQ8Gt1sbkzYRhQ7KCjI/sYOsimgoL/+lp7Tp5c5t2d67tMw8yv/WqiluJXS8WyyVFEQT28qz
Alphanumeric
Any
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / AuthenticationMerchantName
Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x
This field is related to name of the merchant assigned by the Acquirer or Payment System.
Alphanumeric
Maximum → 40 characters
Any
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / AuthenticationValue
Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x
This field is related to 3DS authentication value returned. It is a cryptographic value generated by the ACS to provide a way, during authorisation processing, for the authorisation system to validate the integrity of the authentication result. The AV algorithm is defined by each Payment System.
Alphanumeric
Maximum → 28 characters
Any
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / DirectoryServerTrxID
Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x
This field is related to DS (Directory Server) transaction ID returned. Universally unique transaction identifier assigned by the Directory Server (DS) to identify a single transaction.
Alphanumeric
Maximum → 36 characters
Any
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / ElectronicCommerceInd
Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x
This field is related to 3DS ECI (electronic commerce indicator). Payment System-specific value provided by the ACS or DS to indicate the results of the attempt to authenticate the Cardholder.
This tag is NDC mandatory for version 2.x.x and if is not included, an error will be returned.
Some ECI values and the meaning of this is the following:
01 → Authentication could not be completed but a proof of authentication attempt was provided SLI = 1 → MasterCard
02 → Cardholder was successfully authenticated (SLI = 2) → MasterCard
05 → This value means that the cardholder was authenticated by the issuer by verifying the cardholder’s password or identity information. The value is returned by the ACS in the Payer Authentication Response message when the cardholder successfully passed 3-D Secure payment authentication → Visa
06 → This value means that the merchant attempted to authenticate the cardholder, but either the cardholder or issuer was not participating. The value should be returned by the ACS in the Authentication Response message for an Attempt Response. Additionally, merchants may use an ECI 6 in the authorization request when a Verify Enrollment of N is received from the Visa Directory Server → Visa
07 → This value is set by the merchant when the payment transaction was conducted over a secure channel (for example, SSL/TLS), but payment authentication was not performed, or when the issuer responded that authentication could not be performed. An ECI 7 applies when either the Verify Enrollment or the Payer Authentication Response contains a U for Unable to Authenticate → Visa
Numeric
Two characters
Any
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / ProgramProtocolText
Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x
This field is related to Program Protocol.
Alphanumeric
Any
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / TrxStatusReasonText
Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x
This field provides information on why the Transaction Status field has the specified value
Alphanumeric
Two characters
Any
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / TrxStatusText
Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x
This field indicates whether a transaction qualifies as an authenticated transaction or account verification.
Alphabetic
One character
Any
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecureProgram / EnrollmentStatusText
Contains all information for the result of 3D-Secure authentication process. Applicable for 3DS.
3D Secure Program Enrollment Status. Examples → CardNotEnrolled, CardEnrolled, CardMayBeEnrolled, Unknown
Alphabetical
Any
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecureProgram / SecurePaymentProgramName
Contains all information for the result of 3D-Secure authentication process. Applicable for 3DS.
Name of the secure payment program. Example → Verified by Visa.
Alphanumeric
Any
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SellerOwnCardInd
Contains all information for the result of 3D-Secure authentication process. Applicable for 3DS.
When TRUE, indicates the seller is using their own card. If FALSE, customer card is being used.
Boolean

true/false

DataLists

PassengerList

NAME	DESCRIPTION	FORMAT	ALLOWED/ POSSIBLE VALUES	NDC SERVICES
<DataLists / PassengerList>
Passenger Attribute PassengerID	A unique ID for each passenger.	Alphanumeric (Maximum → 20 characters)	This attribute can be filled with any value, but first character cannot be a number digit or a special character.	AirShoppingRQ/RS OfferPriceRQ/RS SeatAvailabilityRS ServiceListRS OrderCreateRQ OrderViewRS OrderChangeRQ OrderReshopRQ/RS
Passenger / PTC	Passenger Type Code	3 Alphabetical	Type of Passengers	AirShoppingRQ/RS OfferPriceRQ/RS SeatAvailabilityRS ServiceListRS OrderCreateRQ OrderReshopRQ OrderChangeRQ OrderViewRS
Passenger / BirthDate	Birthdate of the passenger Mandatory for secure flights for all passengers. Mandatory for CHD and INF Passengers	Date (yyyy-mm-dd)	Date depends of the PTC	OrderChangeRQ
Passenger / BirthDate		Date (yyyy-mm-dd)	Date depends of the PTC	OrderCreateRQ OrderViewRS
Passenger / Individual Attribute IndividualID	ID of the passenger (within this specific message), for internal use only. Must be unique for each passenger in the message and can be referenced in Query / DataLists / ContactList / ContactInformation / IndividualRef	Alphanumeric (Maximum → 20 characters)	This attribute can be filled with any value, but first character cannot be a number digit or a special character.	OrderChangeRQ
Passenger / Individual Attribute IndividualID		Alphanumeric (Maximum → 20 characters)		OrderCreateRQ
Passenger / Individual / Gender	Gender of the passenger. In secure flight: Mandatory for infant passengers Mandatory for all other passengers if the title is not indicated Mandatory for secure flights and infant passengers in the OrderCreate message.	Alphabetical	Male Female Unspecified	OrderCreateRQ OrderViewRS OrderChangeRQ
Passenger / Individual / NameTitle	Title of the passenger NDC supports followings fields (MR, MRS, MS, MISS). If another value is introduced no error is shown, it is ignored unless the Secure Flight is involved. In secure flight: Optional for infant passengers Mandatory for all other passengers if the gender is not indicated. NDC Mandatory for secure flights	Alphabetical	MR MRS MS MSS MISS	OrderCreateRQ OrderViewRS OrderChangeRQ
Passenger / Individual / GivenName	Name of the passenger (which includes all given names, including first and second names).	Alphabetical	Any	OfferPriceRQ/RS SeatAvailabilityRS ServiceListRS OrderCreateRQ OrderViewRS OrderChangeRQ
Passenger / Individual / Surname	Surname of the passenger. If the name and surnames exceed the maximum number of characters allowed, the original name will be displayed, without trimming. If agency has specified separated by a special character "@" first and second surname, it will be displayed as introduced with separator → e.g.: De la Morena@López) Mandatory for schema if 'GivenName' tag is indicated.	Alphabetical	Any	OfferPriceRQ/RS SeatAvailabilityRS ServiceListRS OrderCreateRQ OrderViewRS OrderChangeRQ
Passenger / Individual / SurnameSuffix	Can be used to indicate that the individual holds a position, educational degree, accreditation, office, or honor. Can be used to distinguish between two passengers with exactly the same NameTitle, GivenName and Surname (i.e. John Smith, and John Smith Jr.) Mandatory if NameTitle, GivenName and Surname are the same for two passengers.	Alphabetical	Any JR SR	OrderCreateRQ OrderViewRS OrderChangeRQ
Passenger / LoyaltyProgramAccount / Airline / AirlineDesignator	Frequent Flyer Airline ID Mandatory if 'LoyaltyProgramAccount' tag is indicated	Alphanumeric	Any	OfferPriceRQ/RS SeatAvailabilityRS ServiceListRS OrderCreateRQ OrderViewRS
Passenger / LoyaltyProgramAccount / AccountNumber	Frequent Flyer number On Business number Mandatory if 'LoyaltyProgramAccount' tag is indicated in OrderCreate or OrderChange	Alphanumeric Alphanumeric	Any Any	OfferPriceRQ/RS SeatAvailabilityRS ServiceListRS OrderCreateRQ OrderViewRS
Passenger / FOID / FOID_Number	Number for the document Mandatory for schema if 'FOID' tag is indicated.	Alphanumeric	PP (Passport): Any sequence of alpha numeric characters, also "-" and "." characters are accepted. Valid examples: 1234-ABC, G.12345 NI (National ID): Only alpha numeric characters are allowed Valid examples: X1234567S 123456789012A	OrderChangeRQ
Passenger / FOID / FOID_Number		Alphanumeric		OrderCreateRQ OrderViewRS
Passenger / FOID / FOID_Type	Type of the passenger ID Info Mandatory for schema if 'FOID' tag is indicated.	2 Alphanumeric	PP (Passport) - Not valid for Spanish Resident and Large Family discounts NI (National ID)	OrderChangeRQ
Passenger / FOID / FOID_Type		2 Alphanumeric		OrderCreateRQ OrderViewRS
Passenger / InfantRef	Indicates the infant in lap associated to this adult. If this tag is not indicated in the OrderCreateRQ, the infant in lap will be associated to the first adult in the Order automatically. Recommended to ensure infant in lap is with correct adult.	Alphanumeric	Reference to infant PassengerID tag	OrderCreateRQ OrderViewRS
Passenger / IdentityDocument / IdentityDocumentNumber	If Type of document is: F1 - this will be the Spanish Resident certificate number (Optional if Spanish DNI/NIE is sent. Validated only if sent without Spanish DNI/NIE) AI - this will be the Large Family certificate number F - this should be the relevant fiscal information for the country. The information should be sent using the following two or three elements separated by obliques "/": Document Type Document Number/ID Company Name (optional) examples: "RUC/12345678X/BIG COMPANY" “CUIL/9393933333 This fiscal information will be included on the tickets as required by local laws. If any unacceptable information is sent and not included in the reservation/tickets, a warning message will be returned in the OrderViewRS. Mandatory for schema if 'IdentityDocument' tag is indicated NDC Mandatory for POS: PE, EC, AR and GT (FiscalID). For Infant passengers is not mandatory, so case that this document doesn’t come it will be assign the fiscal documentation from one of the Adults passengers.	Alphanumeric	12 characters maximum for residence document 20 characters maximum for large family document 70 characters maximum for FiscalId	OrderChangeRQ
Passenger / IdentityDocument / IdentityDocumentNumber		Alphanumeric		OrderCreateRQ OrderViewRS
Passenger / IdentityDocument / IdentityDocumentType	Type of document Mandatory for schema if 'IdentityDocument' tag is indicated NDC Mandatory for POS: PE, EC, AR and GT (FiscalID)	2 Alphanumeric	F1 (Resident Discount) AI (Additional information, Large Family Discount) F (FiscalId) Any other document	OrderChangeRQ
Passenger / IdentityDocument / IdentityDocumentType		2 Alphanumeric		OrderCreateRQ OrderViewRS
Passenger / ContactInfoRef	Reference for passenger contact info	Alphanumeric	Any	OrderChangeRQ
Passenger / ContactInfoRef	Reference for passenger contact info	Alphanumeric	Any	OrderCreateRQ OrderViewRS
Passenger / Remark / Remark	In OrderCreate it is used to communicate the: Municipality of residence / Community code for large family <Remark> <!--Resident Discount Location Code--> <Remark>RESIDENT-380380</Remark> </Remark> <Remark> <!--Large Family Discount Community Code--> <Remark>LARGEFAMILY-380380</Remark> </Remark> In OrderView is is used to communicate the: Type of discount applied and the Municipality/Community code for the passenger Verified or not verified resident discount for passenger <Remark> <Remark>RESIDENT-380380</Remark> </Remark> <Remark> <Remark>LARGEFAMILY-380380</Remark> </Remark> <Remark> <Remark>UNVERIFIED RESIDENT STATUS</Remark> </Remark> Mandatory for schema if 'IdentityDocument' tag is indicated.	Alphanumeric	RESIDENT-Code of Location LARGEFAMILY-Code of Community INE - Relación de municipios y códigos por provincias	OrderChangeRQ
Passenger / Remark / Remark		Alphanumeric		OrderCreateRQ OrderViewRS

ContactList

NAME
DESCRIPTION
FORMAT
ALLOWED/POSSIBLE VALUES
NDC SERVICES
<DataLists / ContactList>
ContactInformation

Attribute
ContactID
Id of the contact information
Alphanumeric
Any
OrderCreateRQ
OrderChangeRQ
OrderViewRS
OrderReshopRS
ContactInformation / ContactProvided / ContactType
Identifier of field that agencies can include to specify the information to include in confirmation mails.
itin_only (omits the pricing
itin_and_price (which is the default value)
not_send_mail
Alphabetic
itin_only (omits the pricing
itin_and_price (which is the default value)
not_send_mail
OrderCreateRQ
OrderChangeRQ
OrderViewRS
OrderReshopRS
ContactInformation / ContactNotProvided
It's allowed to refuse to provide contact information for IATA agencies --> The passenger contact must include tag <ContactNotProvided/>
The agency's contact details (if any) are assigned to passengers who refuse.
If no passenger provides their contact details and not all refuse --> Error "You must indicate if the passengers have refused to provide their contact details"
If any passenger provides contact details --> It's optional to refuse
If all passengers refuse and no Agency Contact is provided --> Error
Refuse Tag for Non IATA Agencies --> Warning and no assignment is done
Empty
Empty
OrderCreateRQ
ContactInformation / ContactProvided / EmailAddress / EmailAddressValue
Email address of the contact
Alphanumeric
Any
OrderCreateRQ
OrderChangeRQ
OrderViewRS
OrderReshopRS
ContactInformation / ContactProvided / Phone / Label
Identify type of phone number.
If the phone number is from an emergency contact, you must write at the OrderCreateRQ: <label>EMERGENCY</label>
Alphabetic
Any
OrderCreateRQ
OrderChangeRQ
OrderViewRS
OrderReshopRS
ContactInformation / ContactProvided / Phone / CountryDialingCode
Country Code associated to phone number if it is filled
Alphanumeric
Ej: (+34)
OrderCreateRQ
OrderChangeRQ
OrderViewRS
OrderReshopRS
ContactInformation / ContactProvided / Phone / PhoneNumber
Phone number of the contact
Numeric
Any
OrderCreateRQ
OrderChangeRQ
OrderViewRS
OrderReshopRS
ContactInformation / Individual / GivenName
Concatenated Name of emergency contact
Alphabetic
Any
OrderCreateRQ
OrderChangeRQ
OrderViewRS
OrderReshopRS
ContactInformation / Individual / Surname
Concatenated Surname of emergency contact
Alphabetic
Any
OrderCreateRQ
OrderChangeRQ
OrderViewRS
OrderReshopRS

FlightSegmentList

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES	NDC SERVICES
<DataLists / FlightSegmentList>
FlightSegment Attribute SegmentKey	SegmentKey = ID of the segment <FlightSegment SegmentKey="IB340620231106">	Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment Attribute SecureFlight	True (If it is a secure flight) Attribute omitted if not SecureFlight	Alphabetical	True	OfferPriceRS OrderViewRS OrderReshopRS (Fare)
FlightSegment / Departure / AirportCode	IATA 3 character code for the departure city/airport/station	3 Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / Departure / Date	Date of departure	Date	yyyy-MM-dd	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / Departure / Time	Time of departure	Hour	HH:mm	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / Departure / AirportName	Name of the departure city/airport/station	Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment Departure / Terminal / Name	Name of the departure terminal at city/airport/station	Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / Arrival / AirportCode	IATA 3 character code for the arrival city/airport/station	3 Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / Arrival / Date	Date of departure	Date	yyyy-MM-dd	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / Arrival / Time	Time of arrival	Hour	HH:mm	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / Arrival / ChangeOfDay	Change of day between departure and arrival	1 Numeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / Arrival / AirportName	Name of the arrival city/airport/station	Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / Arrival / Terminal / Name	Name of the arrival terminal at city/airport/station	Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / MarketingCarrier / AirlineID	ID of the airline that markets the flight	Alphabetical	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / MarketingCarrier / Name	Name of the airline that markets the flight	Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / MarketingCarrier / FlightNumber	Number of the flight	Numeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / OperatingCarrier / AirlineID	ID of the airline that operates the flight	Alphabetical	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / OperatingCarrier / Name	Name of the airline that operates the flight	Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / OperatingCarrier / FlightNumber	Number of the flight	Numeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / OperatingCarrier / Disclosures / Description / Text	Description of the airline	Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / Equipment / AircraftCode	Code of the aircraft that operates the flight	Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
FlightSegment / Equipment / Name	Name of the aircraft that operates the flight	Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
<DataLists / FlightSegmentList / FlightSegment/FlightDetail / FlightDuration>
Value	Duration of the flight, period of time (PT) indicated in hours and minutes.	Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
<DataLists / FlightSegmentList / FlightSegment/FlightDetail / Stops>
StopQuantity	Number of technical stops	Numeric	>= 0	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
StopLocations	List of the technical stops	List	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
<DataLists / FlightSegmentList / FlightSegment/FlightDetail / Stops / StopLocations / StopLocation>
AirportCode	Code of the airport	Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
Name	Name of the airport	Alphanumeric	Any	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
ArrivalDate	Arrival date	Date	yyyy-MM-dd	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
ArrivalTime	Arrival time	Time	hh:mm	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
DepartureDate	Departure date	Date	yyyy-MM-dd	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
DepartureTime	Departure time	Time	hh:mm	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS
GroundTime	Duration of the stop	Alphanumeric	ISO 8601 duration format (EX: PT2H40M)	AirshoppingRS OfferPriceRS ServiceListRS SeatAvailabilityRS OrderViewRS OrderReshopRS

InstructionsList

InstructionList

NAME
DESCRIPTION
FORMAT
ALLOWED/POSSIBLE VALUES
NDC SERVICES
<DataLists / InstructionsList>
Instruction

Attribute
ListKey
Id for the instruction to select sport equipment

Alphanumeric

Any

OrderCreateRQ
OrderRetrieveRQ
OrderViewRS
Instruction / FreeFormTextInstruction

Attribute
refs
Reference for passenger and segments associated to selected sport equipment
Alphanumeric
PassengerID and SegmentID
Valid example: “ADULT_01 IB303420231016“
OrderCreateRQ
OrderRetrieveRQ
OrderViewRS
Instruction / FreeFormTextInstruction / Remark
Selected sport equipment code
Alphanumeric
BIKE: BAGGAGE/SP/0EC
SKII: BAGGAGE/SP/0DD
GOLF: BAGGAGE/SP/0D4
SURF: BAGGAGE/SP/0D8
SCUB: BAGGAGE/SP/0EE
FISH: BAGGAGE/SP/0D6
OrderCreateRQ
OrderRetrieveRQ
OrderViewRS

Metadata

Forms of Payment

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES	NDC SERVICES
<Metadata / Other / OtherMetadata / PaymentFormMetadatas>
PaymentFormMetadata Attribute refs	Reference from<PaymentCard ObjectKey>	Alphanumeric	Any	OfferPriceRS
PaymentFormMetadata Attribute MetadataKey	For 3DS info, this key is mandatory and can be filled in with any value: “KEY_3DS” For installments payment info, this key needs to match with installments reference in PaymentCard Refs: “KEY_QUOTAS”	Alphanumeric	Any	OfferPriceRS OrderCreate & OrderChange for payment in installments
PaymentFormMetadata Attribute MetadataKey	For all payments made by Credit Card. “KEY_AUTHORIZATION_CODE_1”	Alphanumeric	Any	OrderCreate & OrderChange - Payment
PaymentFormMetadata / Text	Installments payment info. Number of installments and interest rate applied by card issuer. Examples: <Text>installments/1/0.00</Text> <Text>installments/3/1.23</Text> <Text>installments/9/variable</Text>	Alphanumeric	installments/n/X.XX where n=number of installments. where X.XX=interests rate in % Valid example: installments/3/0.00	OfferPriceRS OrderCreate & OrderChange for payment in installments
PaymentFormMetadata / Text	Authorization code payment info. Example: <Text>Authorization/2XS56F</Text>	Alphanumeric	Any	OrderCreate & OrderChange - Payment
PaymentFormMetadata / AugmentationPoint / AugPoint Attribute Owner	Airline code associated to 3DS Payment, in this case IB.	Alphabetical	IB	OrderCreate & OrderChange - Payment
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment Attribute xsi:schemaLocation	Reference to IATA 3DS new schema info xsd for Secure Payment.	Alphanumeric	3-D Secure Payment	OrderCreate & OrderChange - Payment
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment Attribute xmlns	Reference to IATA 3DS new schema info for Secure Payment.	Alphanumeric	3-D Secure Payment	OrderCreate & OrderChange - Payment Mandatory if 'AugPoint ' tag is indicated
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment Attribute xmlns:xsi	Reference to IATA 3DS new schema info for Secure Payment.	Alphanumeric	3-D Secure Payment	OrderCreate & OrderChange - Payment Mandatory if 'AugPoint ' tag is indicated
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo Attribute ObjectKey	This Attribute is used to reference the applicable PaymentCard in the Payments section of this message.	Alphanumeric	Any	OrderCreate & OrderChange - Payment
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentMethodCriteria / PaymentCardCriteria / SecurePayerAuthenticationVersion / CardEnrollmentVersionText	The version of 3D-Secure for which the card is enrolled.	Alphanumeric	This field must contain the specific 3DS version used for authentication: 1.0.2 2.1.0 2.2.0	OrderCreate & OrderChange - Payment NDC Mandatory
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentMethodCriteria / PaymentCardCriteria / SecurePayerAuthenticationVersion / SupportedVersionText	Version of 3D-Secure supported. This tag is mandatory for schema.	Alphanumeric	This field must contain the specific 3DS version used for authentication: 1.0.2 2.1.0 2.2.0	OrderCreate & OrderChange - Payment Mandatory if 'PaymentCardSecureInfo' tag is indicated
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion1 / PayerAuthenticationResponseText	Contains the indicators and fields that convey the result of the 3D Secure authentication transaction. Applicable for 3D Secure Version 1.x.x This tag is NDC mandatory for version 1.x.x and if is not included, an error will be returned. This field is the authentication response for the 3-D Secure transaction. It is used to determine whether or not the customer has been authenticated by the card issuer. It must be included in the final authorization request. Example: eJzVWFmzosgSfudXdPQ8Gt1sbkzYRhQ7KCjI/sYOsimgoL/+lp7Tp5c5t2d67tMw8yv/WqiluJXS8WyyVFEQT28qz	Alphanumeric	Any	OrderCreate & OrderChange - Payment NDC Mandatory for 3DS version 1.x.x
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / AuthenticationMerchantName	Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x This field is related to name of the merchant assigned by the Acquirer or Payment System.	Alphanumeric Maximum → 40 characters	Any	OrderCreate & OrderChange - Payment
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / AuthenticationValue	Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x This field is related to 3DS authentication value returned. It is a cryptographic value generated by the ACS to provide a way, during authorisation processing, for the authorisation system to validate the integrity of the authentication result. The AV algorithm is defined by each Payment System.	Alphanumeric Maximum → 28 characters	Any	OrderCreate & OrderChange - Payment
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / DirectoryServerTrxID	Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x This field is related to DS (Directory Server) transaction ID returned. Universally unique transaction identifier assigned by the Directory Server (DS) to identify a single transaction.	Alphanumeric Maximum → 36 characters	Any	OrderCreate & OrderChange - Payment
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / ElectronicCommerceInd	Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x This field is related to 3DS ECI (electronic commerce indicator). Payment System-specific value provided by the ACS or DS to indicate the results of the attempt to authenticate the Cardholder. This tag is NDC mandatory for version 2.x.x and if is not included, an error will be returned. Some ECI values and the meaning of this is the following: 01 → Authentication could not be completed but a proof of authentication attempt was provided SLI = 1 → MasterCard 02 → Cardholder was successfully authenticated (SLI = 2) → MasterCard 05 → This value means that the cardholder was authenticated by the issuer by verifying the cardholder’s password or identity information. The value is returned by the ACS in the Payer Authentication Response message when the cardholder successfully passed 3-D Secure payment authentication → Visa 06 → This value means that the merchant attempted to authenticate the cardholder, but either the cardholder or issuer was not participating. The value should be returned by the ACS in the Authentication Response message for an Attempt Response. Additionally, merchants may use an ECI 6 in the authorization request when a Verify Enrollment of N is received from the Visa Directory Server → Visa 07 → This value is set by the merchant when the payment transaction was conducted over a secure channel (for example, SSL/TLS), but payment authentication was not performed, or when the issuer responded that authentication could not be performed. An ECI 7 applies when either the Verify Enrollment or the Payer Authentication Response contains a U for Unable to Authenticate → Visa	Numeric Two characters	Any	OrderCreate & OrderChange - Payment NDC Mandatory for 3DS version 2.x.x
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / ProgramProtocolText	Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x This field is related to Program Protocol.	Alphanumeric	Any	OrderCreate & OrderChange - Payment
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / TrxStatusReasonText	Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x This field provides information on why the Transaction Status field has the specified value	Alphanumeric Two characters	Any	OrderCreate & OrderChange - Payment
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecurePaymentVersion2 / TrxStatusText	Contains all information for the result of 3D-Secure authentication process. Applicable for 3D Secure Version 2.x.x This field indicates whether a transaction qualifies as an authenticated transaction or account verification.	Alphabetic One character	Any	OrderCreate & OrderChange - Payment
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecureProgram / EnrollmentStatusText	Contains all information for the result of 3D-Secure authentication process. Applicable for 3DS. 3D Secure Program Enrollment Status. Examples → CardNotEnrolled, CardEnrolled, CardMayBeEnrolled, Unknown	Alphabetic	Any	OrderCreate & OrderChange - Payment
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SecureProgram / SecurePaymentProgramName	Contains all information for the result of 3D-Secure authentication process. Applicable for 3DS. Name of the secure payment program. Example → Verified by Visa.	Alphanumeric	Any	OrderCreate & OrderChange - Payment
PaymentFormMetadata / AugmentationPoint / AugPoint / Backport_IberiaSecurePayment / PaymentCardSecureInfo / PaymentFunctions / PaymentProcessingDetails / PaymentMethod / PaymentCard / SellerOwnCardInd	Contains all information for the result of 3D-Secure authentication process. Applicable for 3DS. When TRUE, indicates the seller is using their own card. If FALSE, customer card is being used.	Boolean	true/false	OrderCreate & OrderChange - Payment

Example OrderChangeRQ:

XML Sample

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.iata.org/IATA/EDIST/2017.2">
	<soapenv:Header/>
	<soapenv:Body>
		<OrderChangeRQ Version="5.000" PrimaryLangID="es" xmlns="http://www.iata.org/IATA/EDIST/2017.2">
			<PointOfSale>
				<Location>
					<CountryCode>ES</CountryCode>
				</Location>
			</PointOfSale>
			<Document>
				<ReferenceVersion>5.000</ReferenceVersion>
			</Document>
			<Party>
				<Sender>
					<TravelAgencySender>
						<IATA_Number>78288254</IATA_Number>
						<AgencyID>firstAgency</AgencyID>
					</TravelAgencySender>
				</Sender>
				<Participants>
					<Participant>
						<AggregatorParticipant SequenceNumber="1">
							<AggregatorID>00000022</AggregatorID>
						</AggregatorParticipant>
					</Participant>
				</Participants>
			</Party>
			<Query>
				<OrderID>IB5908506ad86443e48f241f318a18bb26OC</OrderID>
				<PassengerServicing>
					<New PassengerID="ADULT_02">
						<ActionType>Add</ActionType>
					</New>
				</PassengerServicing>
			</Query>
			<DataLists>
				<PassengerList>
					<Passenger PassengerID="ADULT_01">
						<PTC>ADT</PTC>
						<Birthdate>1965-12-20</Birthdate>
						<Individual IndividualID="IND_ADULT_01">
							<Gender>Male</Gender>
							<NameTitle>MR</NameTitle>
							<GivenName>JANE</GivenName>
							<Surname>SMITH</Surname>
						</Individual>
						<FOID>
							<FOID_Number>30000529L</FOID_Number>
							<FOID_Type>NI</FOID_Type>
						</FOID>
						<ContactInfoRef>ADULT_01_CONTACT</ContactInfoRef>
					</Passenger>
					<Passenger PassengerID="ADULT_02">
						<PTC>ADT</PTC>
						<Birthdate>1955-04-01</Birthdate>
						<Individual IndividualID="IND_ADULT_02">
							<Gender>Female</Gender>
							<NameTitle>MRS</NameTitle>
							<GivenName>BAMBI</GivenName>
							<Surname>DISNEY RESERVAS</Surname>
						</Individual>
						<FOID>
							<FOID_Number>47226285V</FOID_Number>
							<FOID_Type>NI</FOID_Type>
						</FOID>
						<ContactInfoRef>ADULT_01_CONTACT</ContactInfoRef>
					</Passenger>
				</PassengerList>
				<ContactList>
					<ContactInformation ContactID="ADULT_01_CONTACT">
						<ContactType/>
						<ContactProvided>
							<EmailAddress>
								<EmailAddressValue>iteggo.cavalos@iberia.es</EmailAddressValue>
							</EmailAddress>
						</ContactProvided>
						<ContactProvided>
							<Phone>
								<Label>Passenger</Label>
								<PhoneNumber>+34666554433</PhoneNumber>
							</Phone>
							<Phone>
								<Label>Emergency</Label>
								<PhoneNumber>34666554433</PhoneNumber>
							</Phone>
						</ContactProvided>
						<Individual>
							<GivenName>CONTACTO</GivenName>
							<Surname>EMERGENCIA</Surname>
						</Individual>
					</ContactInformation>
					<ContactInformation ContactID="Payer">
						<ContactType>Payer</ContactType>
						<ContactProvided>
							<EmailAddress>
								<EmailAddressValue>accept@accept.com</EmailAddressValue>
							</EmailAddress>
						</ContactProvided>
						<ContactProvided>
							<Phone>
								<PhoneNumber>1273211111</PhoneNumber>
							</Phone>
						</ContactProvided>
						<IndividualRef>IND_ADULT_01</IndividualRef>
					</ContactInformation>
				</ContactList>
				<FlightSegmentList>
					<FlightSegment SegmentKey="IB042320240527">
						<Departure>
							<AirportCode>BIO</AirportCode>
							<Date>2024-05-27</Date>
							<Time>09:15</Time>
							<AirportName>Bilbao</AirportName>
						</Departure>
						<Arrival>
							<AirportCode>MAD</AirportCode>
							<Date>2024-05-27</Date>
							<Time>10:25</Time>
							<ChangeOfDay>0</ChangeOfDay>
							<AirportName>Madrid Adolfo Suarez-Barajas</AirportName>
							<Terminal>
								<Name>4</Name>
							</Terminal>
						</Arrival>
						<MarketingCarrier>
							<AirlineID>IB</AirlineID>
							<Name>Iberia</Name>
							<FlightNumber>0423</FlightNumber>
						</MarketingCarrier>
						<OperatingCarrier>
							<AirlineID>IB</AirlineID>
							<Name>Iberia</Name>
							<FlightNumber>0423</FlightNumber>
							<Disclosures>
								<Description>
									<Text>IB</Text>
								</Description>
							</Disclosures>
						</OperatingCarrier>
						<Equipment>
							<AircraftCode>32A</AircraftCode>
							<Name>Airbus A320 (Sharklets)</Name>
						</Equipment>
						<FlightDetail>
							<FlightDuration>
								<Value>PT1H10M</Value>
							</FlightDuration>
						</FlightDetail>
					</FlightSegment>
					<FlightSegment SegmentKey="IB380420240527">
						<Departure>
							<AirportCode>MAD</AirportCode>
							<Date>2024-05-27</Date>
							<Time>15:40</Time>
							<AirportName>Madrid Adolfo Suarez-Barajas</AirportName>
							<Terminal>
								<Name>4</Name>
							</Terminal>
						</Departure>
						<Arrival>
							<AirportCode>IBZ</AirportCode>
							<Date>2024-05-27</Date>
							<Time>16:55</Time>
							<ChangeOfDay>0</ChangeOfDay>
							<AirportName>Ibiza</AirportName>
						</Arrival>
						<MarketingCarrier>
							<AirlineID>IB</AirlineID>
							<Name>Iberia</Name>
							<FlightNumber>3804</FlightNumber>
						</MarketingCarrier>
						<OperatingCarrier>
							<AirlineID>I2</AirlineID>
							<Name>Iberia Express</Name>
							<Disclosures>
								<Description>
									<Text>I2</Text>
								</Description>
							</Disclosures>
						</OperatingCarrier>
						<Equipment>
							<AircraftCode>32Q</AircraftCode>
							<Name>Airbus A321neo</Name>
						</Equipment>
						<FlightDetail>
							<FlightDuration>
								<Value>PT1H15M</Value>
							</FlightDuration>
						</FlightDetail>
					</FlightSegment>
				</FlightSegmentList>
				<InstructionsList>
					<Instruction ListKey="Instruction_1">
						<FreeFormTextInstruction refs="ADULT_02 IB042320240527 IB380420240527">
							<Remark>BAGGAGE/SP/0DD</Remark>
						</FreeFormTextInstruction>
					</Instruction>
				</InstructionsList>
			</DataLists>
		</OrderChangeRQ>
	</soapenv:Body>
</soapenv:Envelope>

Error messages

For further information about all kind of error messages, please go to the following link:

Errors

Release 2024.04

Examples of messages with complete flows can be downloaded from here.

Sender Section

[data-colorid=dtivtp12ba]{color:#bf2600} html[data-color-mode=dark] [data-colorid=dtivtp12ba]{color:#ff6640}[data-colorid=loja3ssgj3]{color:#ff5630} html[data-color-mode=dark] [data-colorid=loja3ssgj3]{color:#cf2600}Participant Section

Recipient Section - (only for OCN message)

Query - Common

Query - AcceptRepricedOrder

Query - PassengerServicing

Attribute

Attribute

Query - OrderServicing

Attribute

Attribute

Attribute

Attribute

Query - Payments

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Attribute

Example OrderChangeRQ:

Error messages

Participant Section