Airline fields

All below fields are optional, the Required column indicates whether the fields are required to qualify for the airline-specific interchange programs.

On submission, some fields might be truncated by Adyen due to different scheme requirements.

For more information on submitting this data, see Send Travel and Entertainment data for Visa, Mastercard and American Express.

airline

The top-level container object for all airline data.

Field Type Required Description
airline.passenger_name
String (tick)

Passenger name, initials and title name.

  • Format: last name + first name or initials + title
    Example: FLYER / MARY MS.
  • minLength: 1
  • maxLength: 49
airline.computerized_reservation_system String (tick)

The CRS used to make the reservation and purchase the ticket; alphanumeric.

  • minLength: 4
  • maxLength: 4
airline.airline_code String (tick)

IATA 3-digit accounting code (PAX); numeric. It identifies the carrier.

  • Format: IATA 3-digit accounting code (PAX)
    Example.: KLM = 074
  • minLength: 3
  • maxLength: 3
airline.ticket_number String (tick)

The ticket's unique identifier.

  • minLength: 1
  • maxLength: 150
airline.flight_date String (tick)

Flight departure date.

Local time (HH:mm) is optonal.

  • Date format: yyyy-MM-dd
  • Date and time format: yyyy-MM-dd HH:mm
  • minLength: 10
  • maxLength: 16
airline.customer_reference_number String (error)

Reference number; alphanumeric.

  • minLength: 0
  • maxLength: 20
airline.ticket_issue_address String (error)

Address of the place/agency that issued the ticket.

  • minLength: 0
  • maxLength: 16
airline.airline_designator_code String (error)

IATA 2-letter accounting code (PAX); alphabetical. It identifies the carrier.

  • Format: IATA 2-letter airline code
    Example.: KLM = KL
  • minLength: 2
  • maxLength: 2
airline.travel_agency_code String (error)

IATA number, also ARC number or ARC/IATA number. Unique identifier number for travel agencies.

  • minLength: 1
  • maxLength: 8
airline.travel_agency_name String (error)

The name of the travel agency.

  • minLength: 1
  • maxLength: 25
airline.agency_plan_name String (error)

2-letter agency plan identifier; alphabetical.

  • minLength: 2
  • maxLength: 2
airline.agency_invoice_number String (error)

Reference number for the invoice, issued by the agency.

  • minLength: 1
  • maxLength: 6
airline.boarding_fee String (error)

Chargeable amount for boarding the plane.

The transaction amount needs to be represented in minor units according to the following table.

  • minLength: 1
  • maxLength: 18

airline.leg

The second-level container object for leg data. The leg number counter starts at 1 and sequentially increments by 1 unit. Maximum number of supported legs is 10.

Field Type Required Description
airline.leg<legNr>.depart_airport String (tick)

Alphabetical identifier of the departure airport.
This field is required/mandatory if the airline data includes leg details.

  • Format: IATA 3-letter airport code.
    Example: Amsterdam = AMS
  • minLength: 3
  • maxLength: 3
airline.leg<legNr>.flight_number String (tick)

The flight identifier.

  • minLength: 1
  • maxLength: 5
airline.leg<legNr>.carrier_code String (tick)

IATA 2-letter accounting code (PAX); alphabetical. It identifies the carrier.
This field is required/mandatory if the airline data includes leg details.

  • Format: IATA 2-letter airline code
    Example.: KLM = KL
  • minLength: 2
  • maxLength: 2
airline.leg<legNr>.fare_base_code String (tick)

Fare basis code; alphanumeric.

  • minLength: 1
  • maxLength: 7
airline.leg<legNr>.class_of_travel String (tick)

1-letter travel class identifier; alphabetical.

There is no standard; however, the following codes are used rather consistently:

  • F: first class
  • J: business class
  • Y: economy class
  • W: premium economy

Limitations:

  • minLength: 1
  • maxLength: 1
airline.leg<legNr>.stop_over_code String (tick)

1-letter code that indicates whether the passenger is entitled to make a stopover.

Only two types of characters are allowed:

  • O: Stopover allowed
  • X: Stopover not allowed

Limitations:

  • minLength: 1
  • maxLength: 1
airline.leg<legNr>.destination_code String (tick)

Alphabetical identifier of the destination/arrival airport.
This field is required/mandatory if the airline data includes leg details.

  • Format: IATA 3-letter airport code.
    Example: Amsterdam = AMS
  • minLength: 3
  • maxLength: 3
airline.leg<legNr>.date_of_travel

String

(error)

Date and time of travel. ISO 8601-compliant.

  • Format: yyyy-MM-dd HH:mm
  • minLength: 16
  • maxLength: 16
airline.leg<legNr>.depart_tax

String

(error)

Departure tax. Amount charged by a country to an individual upon their leaving. The transaction amount needs to be represented in minor units according to the following table.

  • minLength: 1
  • maxLength: 12

airline.passenger

The second-level container object for passenger data. The passenger number counter starts at 1 and sequentially increments by 1 unit, maximum number of supported passengers is 10.

Field Type Required Description
airline.passenger<passengerNr>.first_name String (error)

Passenger first name/given name. This field is required/mandatory if the airline data includes passenger details.

This field is required/mandatory if the airline data includes leg details.

airline.passenger<passengerNr>.last_name String (error)

Passenger last name/family name. This field is required/mandatory if the airline data includes passenger details.

This field is required/mandatory if the airline data includes leg details.

airline.passenger<passengerNr>.traveller_type String (error)

Passenger type code (PTC).

IATA PTC values are 3-letter alphabetical. Example: ADT, SRC, CNN, INS.

However, several carriers use non-standard codes that can be up to 5 alphanumeric characters.

  • minLength: 3
  • maxLength: 6
airline.passenger<passengerNr>.telephone_number String (error)

Telephone number of the passenger, including country code. This is an alphanumeric field that can include the '+' and '-' signs.

  • minLength: 3
  • maxLength: 30
airline.passenger<passengerNr>.date_of_birth String (error)

Date of birth of the passenger.

  • Date format: yyyy-MM-dd
  • minLength: 10
  • maxLength: 10