Airline data

Send airline data for US domestic transactions.

If your business operates under specific travel-related Merchant Category Codes (MCCs), you can provide enhanced scheme data (ESD) to optimize your interchange rates. Airline data consists of industry-specific details, such as ticket numbers and passenger names.

You get benefits for transactions, depending on the scheme:

Visa: prevent downgrades to higher commercial standard rates.
Mastercard: ensure that your transactions qualify for the interchange rates specific to your industry.

Requirements

In addition to the requirements that apply to sending ESD, take into account the following additional limitations for sending airline data.

Requirement	Description
Limitations	Your business must operate under an eligible MCC. You can send airline data for both commercial and consumer cards.

Eligible MCCs for sending airline data

You can send airline data if you have one of the following MCCs:

MCC	Description	Scheme
3000-3350	Airlines	Mastercard, Visa
4511	Airlines and air carriers	Mastercard, Visa

For the following MCC, you can send airline data in limited cases:

MCC	Description	Scheme and limitation
4722	Travel agencies and tour operators	Mastercard: You automatically get a discount for consumer card payments. For commercial cards, you can instead submit level 2/3 data for the interchange fee discount. Visa: The rules depend on whether the card is present (in-person payment) or the card is not present (online payment). Card present: For both consumer and commercial cards, you must send airline data to get a discount. Card not present: You do not have to send airline data to get a discount. You cannot send level 2/3 data for any Visa commercial card transaction.

How it works

You include airline data in the enhancedSchemeData.airline object. The object has the same fields in each request that supports it.

Review the fields to send and the requirements that apply to your MCC.
Include the airline data in one of the following requests. The request to use depends on your capture setting:
- Automatic capture and Delayed automatic capture: the /payments request.
- Manual capture (Single partial capture and Multiple partial capture): the /payments/{paymentPspReference}/captures request.
Check that you get a successful response.

Send airline data

Include the airline data fields in the enhancedSchemeData.airline object of your /payments or /payments/{paymentPspReference}/captures request.

Field	Description	Value
airline.passengerName String	The name, initials, and title of the passenger. If you send more than 20 characters, Adyen truncates the name.	Format: Last name + first name or initials + title 1-20 characters Must not start with a space, or contain only spaces or zeros Example: FLYER / MARY MS
airline.code String	The accounting code that identifies the carrier.	Format: IATA 3-digit accounting code (PAX) Must not start with a space, or contain only spaces or zeros Example: 074 for KLM.
airline.ticket.number String	The unique identifier of the ticket.	Format: 1-15 characters Must not start with a space, or contain only spaces or zeros
airline.ticket.issueDate String	The date when the issuer gave the ticket to the passenger.	Format: ISO 8601 date: `yyyy-MM-dd`
airline.legs.departureAirportCode String	The code of the departure airport.	Format: IATA 3-letter airport code ASCII Must not start with a space, or contain only spaces or zeros Example: AMS for Amsterdam.
airline.legs.destinationAirportCode String	The code of the destination airport.	Format: IATA 3-letter airport code ASCII Must not start with a space, or contain only spaces or zeros Example: AMS for Amsterdam.
airline.legs.carrierCode String	The code that identifies the carrier.	Format: IATA 2-letter accounting code (PAX) Must not start with a space, or contain only spaces or zeros Example: KL for KLM.
airline.legs.flightNumber String	The identifier of the flight.	Format: 1-5 characters Must not start with a space, or contain only spaces or zeros
airline.legs.classOfTravel String	A one-letter identifier for the travel class.	Possible values include: F: first class J: business class Y: economy class W: premium economy Format: 1 ASCII character Must not be a zero
airline.legs.dateOfTravel String	The date and time of travel, in the local time of the departure airport.	Format: `yyyy-MM-ddTHH:mm`
airline.passengers.firstName String	The first name of the passenger.	Format: ASCII
airline.passengers.lastName String	The last name of the passenger.	Format: ASCII
airline.customerReferenceNumber String	Your alphanumeric reference number for the customer. If you send more than 20 characters, Adyen truncates the number.	Format: ASCII Maximum 20 characters Must not start with a space or contain only spaces
airline.computerizedReservationSystem String	The computer reservation system (CRS) that you use to make the reservation and buy the ticket.	Format: 4 ASCII characters
airline.designatorCode String	The code that identifies the carrier.	Format: IATA 2-letter accounting code (PAX) ASCII Must not start with a space or contain only spaces Example: KL for KLM.
airline.documentType String	A code that identifies the type of item bought. The description of this code can appear on card statements.	Format: 2 ASCII characters Example: 01 for a passenger ticket.
airline.boardingFee Integer	The amount charged to board the plane.	Format: Numeric, in minor units 1-11 characters Example: 2000 means USD 20.00.
airline.flightDate String	The departure date of the flight, in the local time of the departure airport. The time is optional.	Format: Date only: `yyyy-MM-dd` Date and time: `yyyy-MM-ddTHH:mm`
airline.ticket.issueAddress String	The address of the organization that issued the ticket.	Format: Maximum 16 characters
airline.travelAgency.code String	The unique identifier from IATA or ARC for the travel agency that issues the ticket.	Format: ASCII 1-8 characters Must not start with a space, or contain only spaces or zeros
airline.travelAgency.name String	The name of the travel agency.	Format: ASCII 1-25 characters Must not start with a space, or contain only spaces or zeros
airline.agency.planName String	The two-letter identifier of the agency plan.	Format: 2 ASCII characters
airline.agency.invoiceNumber String	The reference number of the invoice that the agency issues.	Format: 1-6 ASCII characters
airline.legs.fareBasisCode String	The fare basis code.	Format: 1-15 alphanumeric characters Must not start with a space, or contain only spaces or zeros
airline.legs.stopOverCode String	A one-letter code that indicates whether the passenger can make a stopover.	Possible values: O: the passenger can make a stopover. X: the passenger cannot make a stopover. A space: not specified. Format: 1 ASCII character
airline.legs.departureTax Integer	The amount of departure tax charged.	Format: Numeric, in minor units 1-11 characters Must not contain only zeros
airline.passengers.travellerType String	The IATA passenger type code (PTC).	Format: 3-6 ASCII characters
airline.passengers.phoneNumber String	The phone number of the passenger, with the country code.	Format: ASCII 3-30 characters Can include the + and - signs
airline.passengers.dateOfBirth String	The date of birth of the passenger.	Format: `yyyy-MM-dd`

Select the endpoint for the corresponding request example:

Test sending airline data

Use the following test card to make test payments with airline data:

Card Number	Card Type	Expiry Date	CVV
5555 5555 5555 4444	Mastercard	03/2030	737
4444 3333 2222 1111	Visa	03/2030	737