---
title: "Airline data"
description: "Send airline data for US domestic transactions."
url: "https://docs.adyen.com/payment-methods/cards/enhanced-scheme-data/airline"
source_url: "https://docs.adyen.com/payment-methods/cards/enhanced-scheme-data/airline.md"
canonical: "https://docs.adyen.com/payment-methods/cards/enhanced-scheme-data/airline"
last_modified: "2023-04-06T11:15:00+02:00"
language: "en"
---

# Airline data

Send airline data for US domestic transactions.

[View source](/payment-methods/cards/enhanced-scheme-data/airline.md)

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](/payment-methods/cards/enhanced-scheme-data#requirements), take into account the following additional limitations for sending airline data.

| Requirement     | Description                                                                                                                                  |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Limitations** | * Your business must operate under an [eligible MCC](#airline-data-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](/payment-methods/cards/enhanced-scheme-data#l2-l3) 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](/point-of-sale/add-data#additional-data-elements).
  * 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

In your payment or capture requests, include the airline-specific data fields. The recommended request depends on your [capture setting](/online-payments/capture#types-of-capture).

* **Automatic capture** and **Delayed automatic capture**: in the [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments) request, include airline data in the [additionalData.airline](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataAirline-airline-ticket_number) object.
* **Manual capture** (**Single partial capture** and **Multiple partial capture**): in the [/payments/{paymentPspReference}/captures](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments/\(paymentPspReference\)/captures) request, include airline data in the [enhancedSchemeData.airline](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments/\(paymentPspReference\)/captures#request-enhancedSchemeData-airline) object.

## Send airline data

1. Include airline data in the payment or capture request.

   * For the [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments) request: use the [additionalData.airline](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments#request-additionalData-AdditionalDataAirline-airline-ticket_number) object.
   * For the [/payments/{paymentPspReference}/captures](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments/\(paymentPspReference\)/captures) request: use the [enhancedSchemeData.airline](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments/\(paymentPspReference\)/captures#request-enhancedSchemeData-airline) object.\
     The following table lists the airline data fields that are required and optional to provide in your requests, depending on the type of request.

   | Payment request fields            | Capture request fields                           | Required                                                                                    |
   | --------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------- |
   | `airline_code`                    | `code`                                           | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
   | `ticket_number`                   | `ticket.number`                                  | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
   | `passenger_name`                  | `passengers.firstName` and `passengers.lastName` | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
   | `leg[itemNr].carrier_code`        | `legs.carrierCode`                               | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
   | `leg[itemNr].class_of_travel`     | `legs.classOfTravel`                             | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
   | `leg[itemNr].destination_code`    | `legs.destinationAirportCode`                    | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
   | `leg[itemNr].date_of_travel`      | `legs.dateOfTravel`                              | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
   | `leg[itemNr].depart_airport`      | `legs.depatureAirportCode`                       | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
   | `leg[itemNr].flight_number`       | `legs.flightNumber`                              | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
   | `issue_date`                      | `ticket.issueDate`                               | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
   | `leg[itemNr].stop_over_code`      | `legs.stopOverCode`                              |                                                                                             |
   | `leg[itemNr].fare_base_code`      | `legs.fareBasisCode`                             |                                                                                             |
   | `leg[itemNr].depart_tax`          | `legs.departureTax`                              |                                                                                             |
   | `computerized_reservation_system` | `computerizedReservationSystem`                  |                                                                                             |
   | `travel_agency_name`              | `travelAgency.name`                              |                                                                                             |
   | `travel_agency_code`              | `travelAgency.code`                              |                                                                                             |

   Select the endpoint for the corresponding request example:

   ### Tab: `/payments` endpoint

   **Example payment request with airline data**

   ```bash
   curl https://checkout-test.adyen.com/v72/payments \
   -H 'x-API-key: ADYEN_API_KEY' \
   -H 'idempotency-key: YOUR_IDEMPOTENCY_KEY' \
   -H 'content-type: application/json' \
   -X POST
   -d '{
     "amount": {
       "currency": "USD",
       "value": 20000
     },
     "reference": "YOUR_ORDER_NUMBER",
     "paymentMethod":{
       "type":"scheme",
       "cvc": "737",
       "expiryMonth": "03",
       "expiryYear": "2030",
       "holderName": "John Smith",
       "number": "4444333322221111"
     },
     "returnUrl": "https://your-company.example.com/...",
     "merchantAccount": "ADYEN_MERCHANT_ACCOUNT",
     "additionalData": {
        "airline.passenger_name":"John Smith",
        "airline.ticket_number":"AIRLINE_TICKET_NUMBER",
        "airline.airline_code":"074",
        "airline.flight_date":"2023-03-22 11:00",
        "airline.travel_agency_code":"12345678",
        "airline.travel_agency_name":"TRAVEL_AGENCY_NAME",
        "airline.document_type":"01",
        "airline.ticket_issue_address":"Amsterdam",
        "airline.leg1.carrier_code":"KL",
        "airline.leg1.class_of_travel":"F",
        "airline.leg1.depart_airport":"AMS",
        "airline.leg1.destination_code":"CDG",
        "airline.leg1.stop_over_code":"X",
        "airline.leg1.fare_base_code":"F",
        "airline.leg1.flight_number":"1234",
        "airline.leg1.date_of_travel":"2023-03-22 11:00",
        "airline.leg1.depart_tax":"100",
        "airline.leg2.carrier_code":"AF",
        "airline.leg2.class_of_travel":"Y",
        "airline.leg2.depart_airport":"CDG",
        "airline.leg2.destination_code":"AMS",
        "airline.leg2.stop_over_code":"X",
        "airline.leg2.fare_base_code":"Y",
        "airline.leg2.flight_number":"4321",
        "airline.computerized_reservation_system":"SABR",
        "airline.leg2.date_of_travel":"2023-03-24 16:00",
        "airline.leg2.depart_tax":"100"
     }
   }'
   ```

   ### Tab: `/captures` endpoint

   **Example capture request with airline data**

   ```bash
   curl https://checkout-test.adyen.com/v72/payments/WNS7WQ756L2GWR82/captures \
   -H 'x-API-key: ADYEN_API_KEY' \
   -H 'idempotency-key: YOUR_IDEMPOTENCY_KEY' \
   -H 'content-type: application/json' \
   -X POST
   -d '{
      "merchantAccount":"ADYEN_MERCHANT_ACCOUNT",
      "amount":{
         "currency":"USD",
         "value":20000
      },
      "originalReference":"NC6HT9CRT65ZGN82",
      "enhancedSchemeData": {
         "airline": {
            "passengers": [
               {
                  "firstName": "John",
                  "lastName": "Smith"
               }
            ],
            "ticket": {
               "number": "AIRLINE_TICKET_NUMBER",
               "issueDate": "2023-03-22"
            },
            "code": "074",
            "travelAgency": {
               "code": "12345678",
               "name": "TRAVEL_AGENCY_NAME"
            },
            "legs": [
               {
                  "carrierCode": "KL",
                  "classOfTravel": "F",
                  "departureAirportCode": "AMS",
                  "destinationAirportCode": "CDG",
                  "stopOverCode": "X",
                  "fareBasisCode": "F",
                  "flightNumber": "1234",
                  "dateOfTravel": "2023-03-22 11:00",
                  "departureTax": "100"
               },
               {
                  "carrierCode": "AF",
                  "classOfTravel": "Y",
                  "departureAirportCode": "CDG",
                  "destinationAirportCode": "AMS",
                  "stopOverCode": "X",
                  "fareBasisCode": "Y",
                  "flightNumber": "4321",
                  "dateOfTravel": "2023-03-24 16:00",
                  "departureTax": "100"
               }
            ],
            "computerizedReservationSystem": "SABR"
         }
      }
   }'
   ```

## 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 |

## See also

* [Cards](/payment-methods/cards)
* [Enhanced scheme data](/payment-methods/cards/enhanced-scheme-data)
* [Webhooks](/development-resources/webhooks)
