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