On This Page {#jumplink-list} [Markdown](/docs/cybs/en-us/airline/developer/all/rest/airline.md) Airline Processing Developer Guide {#airline-about-guide} ========================================================= This section describes how to use this guide and where to find further information. Audience and Purpose : This guide is written for application developers who want to use the `Cybersource` `REST API` to integrate credit card processing with airline data into their order management system. Implementing the `Cybersource` credit card services requires software development skills. You must write code that uses the API request and reply fields to integrate the credit card services into your existing order management system. Conventions : This special statement is used in this document: > IMPORTANT > An *Important* statement contains information essential to successfully completing a task or learning a concept. Related Documentation : Visit the [`Cybersource` documentation hub](https://developer.cybersource.com/docs.md "") to find additional processor-specific versions of this guide and additional technical documentation. Customer Support : For support information about any service, visit the Support Center: Recent Revisions to This Document {#airline-doc-revisions} ========================================================== 26.02.01 -------- `Elavon` : Added support for `Elavon` ancillary purchases. See [Elavon Airline Requests](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-elavon-intro.md ""). 25.09.07 -------- This revision contains only editorial changes and no technical updates. 25.06.02 -------- This revision contains only editorial changes and no technical updates. 25.06.01 -------- This revision contains only editorial changes and no technical updates. 25.05.01 -------- `FDC Nashville Global` : Removed the travelInformation.transit.airline.legs\[\].conjunctionTicket field from the capture required fields list. See [Optional Fields for an Airline Capture](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-fdcglobal-intro/airline-fdcglobal-capture-intro/airline-fdcglobal-capture-opt-fields.md ""). VISA Platform Connect: Specifications and Conditions for Resellers/Partners {#vpc-partner-reseller-disclaimer} ============================================================================================================== The following are specifications and conditions that apply to a Reseller/Partner enabling its merchants through Cybersource for Visa Platform Connect ("VPC") processing. Failure to meet any of the specifications and conditions below is subject to the liability provisions and indemnification obligations under Reseller/Partner's contract with Visa/Cybersource. 1. Before boarding merchants for payment processing on a VPC acquirer's connection, Reseller/Partner and the VPC acquirer must have a contract or other legal agreement that permits Reseller/Partner to enable its merchants to process payments with the acquirer through the dedicated VPC connection and/or traditional connection with such VPC acquirer. 2. Reseller/Partner is responsible for boarding and enabling its merchants in accordance with the terms of the contract or other legal agreement with the relevant VPC acquirer. 3. Reseller/Partner acknowledges and agrees that all considerations and fees associated with chargebacks, interchange downgrades, settlement issues, funding delays, and other processing related activities are strictly between Reseller and the relevant VPC acquirer. 4. Reseller/Partner acknowledges and agrees that the relevant VPC acquirer is responsible for payment processing issues, including but not limited to, transaction declines by network/issuer, decline rates, and interchange qualification, as may be agreed to or outlined in the contract or other legal agreement between Reseller/Partner and such VPC acquirer. DISCLAIMER: NEITHER VISA NOR CYBERSOURCE WILL BE RESPONSIBLE OR LIABLE FOR ANY ERRORS OR OMISSIONS BY THE Visa Platform Connect ACQUIRER IN PROCESSING TRANSACTIONS. NEITHER VISA NOR CYBERSOURCE WILL BE RESPONSIBLE OR LIABLE FOR RESELLER/PARTNER BOARDING MERCHANTS OR ENABLING MERCHANT PROCESSING IN VIOLATION OF THE TERMS AND CONDITIONS IMPOSED BY THE RELEVANT Visa Platform Connect ACQUIRER. Introduction to Airline Processing {#home-merch} ================================================ Airline data processing exceeds basic payment processing by enabling you to process specific travel data. To make use of this capability, you must submit additional information, such as: * Carrier (airline) * Departure date * Destination airport * Purchase date * Originating airport * Ticket class * Travel legs (segments) * Ticket Number {#home-merch_ul_x5d_bnt_nwb} Before you can begin testing and processing airline payments, you must have airline transactions enabled for your merchant account. Contact your `Cybersource` account manager for more information. > IMPORTANT > ` Cybersource ` temporarily disables your account's airline data processing capability and contacts you if your airline data transactions produce batching errors when the information is sent to the processor. If this occurs, your request is not rejected, but you receive one of the above listed fields with the ` N ` value in the response indicating that airline data in the request has been ignored and not sent to the processor. Prerequisite ------------ To begin processing payments through `Cybersource`, you must first set up your payment processing system to be REST compliant. If you have not set up secure communications between your client and server using either **JSON Web Token (JWT)** or **HTTP signature** messaging, see the [*Getting Started with REST Developer Guide*](https://developer.cybersource.com/docs/cybs/en-us/platform/developer/all/rest/rest-getting-started/restgs-intro.md ""). Confirmation Response {#airline-intro-processing} ================================================= When you send a request with airline data, `Cybersource` does not save the airline data. Instead, `Cybersource` sends your airline data to the processor. `Cybersource` enforces only minimal field validation, which can result in a successful response that did not send the airline data to the processor. To confirm that the processor received the airline data, some processors support the processingInformation.enhancedDataEnabled response field to indicate if the airline is received. These are the possible field values: * `N`: the airline data is *not* included in the request to the processor. * `Y`: the airline data is included in the request to the processor. Airline Travel Legs {#airline-intro-legs} ========================================= Some processors require travel legs in the API service request, even for direct flights. This section describes how to successfully include travel legs in an API request. Using Travel Legs ----------------- To include travel legs in an airline transaction, include one or more travel legs in the legs\[\] array. For example, these three travel legs are valid: ``` "travelInformation": { "transit": { "airline": { "legs": [ { "carrierCode": "XX" }, { "carrierCode": "XZ" }, { "carrierCode": "XX" } ] } ``` Travel Leg Limitations ---------------------- Some processors limit the number of travel legs for each trip based on the card type. `Barclays` Airline Requests {#airline-barclays-intro} ===================================================== This section describes the airline payment services you can use when processing with `Barclays`. > IMPORTANT You cannot process a cash advance and airline data in the same transaction. Supported Card Types -------------------- These are the card types that `Barclays` supports: * Maestro (International) * Maestro (UK Domestic) * Mastercard * Visa Travel Legs ----------- Maximum number of travel legs: 99 Numbering for the travel legs: 0 to 98 You must include information for at least the first leg of the trip (leg 0). You must use consecutive numbers for the legs; do not skip a number. If you skip a number, `Cybersource` ignores the legs that follow the skipped number. Capture an Airline Ticket Payment {#airline-barclays-capture-intro} =================================================================== This section describes how to capture an airline payment for a ticket purchase. Before you can capture payment, you must authorize the funds by sending an authorization request. The authorization response includes a request ID in the id field. The request ID is required in the capture request. For more information about how to send an authorization request, see the [Standard Payment Processing](https://developer.cybersource.com/docs/cybs/en-us/payments/developer/ctv/rest/payments/payments-processing-basic-intro.md "") section in the *Payments Developer Guide*. Leg Limitations {#airline-barclays-capture-intro_leg-limit-capture} ------------------------------------------------------------------- `Barclays` limits the maximum number of legs for each trip based on card type. You must include information for the first leg of the trip (leg 0), and you must use consecutive numbers for any additional legs. To do so, replace the `[]` characters in the field name with a sequential number starting with `0`. For example, for a trip with two legs, set the transit\[\] field as transit0 and transit1, for the first and second legs, respectively. If you skip a number, `Cybersource` ignores the legs that follow the skipped number. This table describes the maximum number of legs for each trip based on card type. | Supported Card Types | Maximum Number of Trip Legs | |-------------------------|-----------------------------| | Maestro (International) | 99 | | Maestro (UK Domestic) | 99 | | Mastercard | 99 | | Visa | 99 | [`Barclays` Leg Limitations] Document Type ------------- When capturing an airline payment, you must use the travelInformation.transit.airline.documentType field to specify the purpose of the transaction. For all possible values, see [Airline Document Type Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-doc-codes.md ""). Endpoint {#airline-barclays-capture-intro_d14e147} -------------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments/`*{id}*`/captures`{#airline-barclays-capture-intro_d14e156} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments/`*{id}*`/captures`{#airline-barclays-capture-intro_d14e169} The *{id}* is the transaction ID returned in the authorization response. Required Fields for Capturing an Airline Payment {#airline-barclays-capture-req-fields} ======================================================================================= [clientReferenceInformation.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-code.md "") : [orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : [processingInformation.industryDataType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-industry-data-type.md "") : Set the value to `airline`. travelinformation.agency.name : [travelInformation.transit.airline.legs\[\].class](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-class.md "") : [travelInformation.transit.airline.legs\[\].departureDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-departure-date.md "") : [travelInformation.transit.airline.legs\[\].originatingAirportCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-orig-airport-code.md "") : [travelInformation.transit.airline.passengerName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-pass-name.md "") : [travelInformation.transit.airline.ticketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ticket-num.md "") : Card-Specific Field for Capturing an Airline Payment {#airline-barclays-capture-card-fields} ============================================================================================ Some card types require additional fields. Visa ---- Use this field to capture an airline payment when using a Visa card. airlineData_restrictedTicketIndicator : Optional Fields for Capturing an Airline Payment {#airline-barclays-capture-opt-fields} ======================================================================================= [travelInformation.agency.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-agency-code.md "") : [travelInformation.transit.airline.customerCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-cust-code.md "") : travelInformation.transit.airline.invoiceNumber : [travelInformation.transit.airline.legs\[\].carrierCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-carrier-code.md "") : [travelInformation.transit.airline.legs\[\].class](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-class.md "") : travelInformation.transit.airline.legs\[\].departTaxAmount : [travelInformation.transit.airline.legs\[\].departureDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-departure-date.md "") : [travelInformation.transit.airline.legs\[\].destinationAirportCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-dest-airport-code.md "") : [travelInformation.transit.airline.legs\[\].fareBasis](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-fare-basis.md "") : [travelInformation.transit.airline.legs\[\].originatingAirportCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-orig-airport-code.md "") : [travelInformation.transit.airline.legs\[\].stopoverIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-stop-over-indicator.md "") : [travelInformation.transit.airline.ticketIssuer.address](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ticket-issuer-add.md "") : {#airline-barclays-capture-opt-fields_barclays-rest-opt-fields} Example: Capturing an Airline Payment {#airline-barclays-capture-ex-rest} ========================================================================= Request ``` { "clientReferenceInformation": { "code": "refnum123" }, "processingInformation": { "industryDataType": "airline" }, "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "GBP" } }, "travelInformation": { "agency": { "name": "test-airline" }, "transit": { "airline": { "ticketNumber": "123456789", "passengerName": "John Smith", "legs": [ { "originatingAirportCode": "TST", "class": "A", "departureDate": "092525" } ] } } } } ``` Response ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/captures/6823025890736075903954/voids" }, "self": { "method": "GET", "href": "/pts/v2/captures/6823025890736075903954" } }, "clientReferenceInformation": { "code": "TC50171_3" }, "id": "6823025890736075903954", "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "GBP" } }, "reconciliationId": "67720603YGMSE5JE", "status": "PENDING", "submitTimeUtc": "2025-04-24T02:16:29Z" } ``` Issue a Credit {#airline-barclays-credit-intro} =============================================== This topic describes how to process an airline credit. > IMPORTANT All fields used in the original transaction must be included in your request. Endpoint {#airline-barclays-credit-intro_d14e189} ------------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/credits/`{#airline-barclays-credit-intro_d14e198} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/credits/`{#airline-barclays-credit-intro_d14e208} Required Fields for Airline Credits {#airline-barclays-credit-req-fields} ========================================================================= [clientReferenceInformation.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-code.md "") : [orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : [orderInformation.billTo.address1](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-address1.md "") : orderInformation.billTo.administrationArea : [orderInformation.billTo.country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-country.md "") : [orderInformation.billTo.email](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-email.md "") : [orderInformation.billTo.firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-first-name.md "") : [orderInformation.billTo.lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-last-name.md "") : orderInformation.billTo.externality : [orderInformation.billTo.postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-postal-code.md "") : [paymentInformation.card.expirationMonth](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-exp-mo.md "") : [paymentInformation.card.expirationYear](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-exp-year.md "") : [paymentInformation.card.number](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-number.md "") : [processingInformation.industryDataType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-industry-data-type.md "") : Set the value to `airline`. travelinformation.agency.name : [travelInformation.transit.airline.legs\[\].departureDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-departure-date.md "") : [travelInformation.transit.airline.legs\[\].originatingAirportCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-orig-airport-code.md "") : [travelInformation.transit.airline.passengerName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-pass-name.md "") : [travelInformation.transit.airline.ticketIssuer.address](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ticket-issuer-add.md "") : [travelInformation.transit.airline.ticketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ticket-num.md "") : Card-Specific Field for Airline Credits {#airline-barclays-credit-card-fields} ============================================================================== Some card types require additional fields. Visa ---- Use this field to capture an airline payment when using a Visa card. airlineData_restrictedTicketIndicator : Optional Fields for Airline Credits {#airline-barclays-credit-opt-fields} ========================================================================= [travelInformation.agency.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-agency-code.md "") : [travelInformation.transit.airline.customerCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-cust-code.md "") : travelInformation.transit.airline.invoiceNumber : [travelInformation.transit.airline.legs\[\].carrierCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-carrier-code.md "") : [travelInformation.transit.airline.legs\[\].class](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-class.md "") : travelInformation.transit.airline.legs\[\].departTaxAmount : [travelInformation.transit.airline.legs\[\].departureDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-departure-date.md "") : [travelInformation.transit.airline.legs\[\].destinationAirportCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-dest-airport-code.md "") : [travelInformation.transit.airline.legs\[\].fareBasis](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-fare-basis.md "") : [travelInformation.transit.airline.legs\[\].originatingAirportCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-orig-airport-code.md "") : [travelInformation.transit.airline.legs\[\].stopoverIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-stop-over-indicator.md "") : [travelInformation.transit.airline.ticketIssuer.address](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ticket-issuer-add.md "") : Example: Processing Airline Credits {#airline-barclays-credit-ex-rest} ====================================================================== Request ``` { "clientReferenceInformation": { "code": "12345678" }, "processingInformation": { "industryDataType": "airline" }, "paymentInformation": { "card": { "number": "4111111111111111", "expirationMonth": "01", "expirationYear": "2031" } }, "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "GBP" }, "billTo": { "firstName": "John", "lastName": "Deo", "address1": "1 The Street", "externality": "City", "administrativeArea": "County", "postalCode": "AB12CD", "country": "GB", "email": "test@email.co.uk" } }, "travelInformation": { "agency": { "name": "test-airline" }, "transit": { "airline": { "ticketIssuer": { "address": "123 Happy St" }, "ticketNumber": "123456789", "passengerName": "John Smith", "legs": [ { "originatingAirportCode": "AAA", "departureDate": "03092025" } ] } } } } ``` Response ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/captures/6823025890736075903954/voids" }, "self": { "method": "GET", "href": "/pts/v2/captures/6823025890736075903954" } }, "clientReferenceInformation": { "code": "12345678" }, "id": "6823025890736075903954", "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "GBP" } }, "reconciliationId": "67720603YGMSE5JE", "status": "PENDING", "submitTimeUtc": "2025-04-24T02:16:29Z" } ``` `Elavon` Airline Requests {#airline-elavon-intro} ================================================= This section describes the airline payment services you can use when processing with `Elavon`. Supported Card Types -------------------- This table lists the card types that `Elavon` supports. | Supported Card Types | |----------------------| | Diners Club | | Discover | | JCB Card | | Mastercard | | Visa | [`Elavon` Supported Card Types] Capture a Payment {#airline-elavon-capture-intro} ================================================= This section describes how to capture an airline payment. You can include an airline ticket purchase and any ancillary purchases in the same capture request. Ancillary purchases are any additional services, such as baggage, meals, and paid seats, your customers can purchase. **Prerequisite** : Before you can capture payment, you must authorize the funds by sending an authorization request. The authorization response includes a request ID in the id field. The request ID is required in the capture request. For more information about how to send an authorization request, see the [Standard Payment Processing](https://developer.cybersource.com/docs/cybs/en-us/payments/developer/ctv/rest/payments/payments-processing-basic-intro.md "") section in the *Payments Developer Guide*. Leg Limitations {#airline-elavon-capture-intro_leg-limit-capture} ----------------------------------------------------------------- `Elavon` limits the maximum number of legs for each trip based on card type. This table describes the maximum number of legs for each trip based on card type. | Supported Card Types | Maximum Number of Trip Legs | |----------------------|-----------------------------| | Diners Club | 4 | | Discover | 4 | | Mastercard | 4 | | Visa | 4 | [`Elavon` Leg Limitations] Document Type ------------- When capturing an airline payment, you must use the travelInformation.transit.airline.documentType field to specify the purpose of the transaction. For all possible values, see [Airline Document Type Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-doc-codes.md ""). Endpoint {#airline-elavon-capture-intro_d14e147} ------------------------------------------------ **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments/`*{id}*`/captures`{#airline-elavon-capture-intro_d14e156} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments/`*{id}*`/captures`{#airline-elavon-capture-intro_d14e169} The *{id}* is the transaction ID returned in the authorization response. Required Fields for Capturing an Airline Ticket Payment {#airline-elavon-capture-req-fields} ============================================================================================ [clientReferenceInformation.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-code.md "") : [orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : [processingInformation.industryDataType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-industry-data-type.md "") : Set to `airline`. [travelInformation.agency.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-agency-code.md "") : [travelInformation.agency.name](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-agency-name.md "") : [travelInformation.transit.airline.legs\[\].carrierCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-carrier-code.md "") : [travelInformation.transit.airline.legs\[\].class](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-class.md "") : [travelInformation.transit.airline.legs\[\].departureDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-departure-date.md "") : [travelInformation.transit.airline.legs\[\].destinationAirportCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-dest-airport-code.md "") : [travelInformation.transit.airline.legs\[\].originatingAirportCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-orig-airport-code.md "") : [travelInformation.transit.airline.legs\[\].stopoverIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-stop-over-indicator.md "") : [travelInformation.transit.airline.passengerName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-pass-name.md "") : [travelInformation.transit.airline.restrictedTicketIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-restrict-ticket-ind.md "") : [travelInformation.transit.airline.ticketIssuer.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ticket-issuer-code.md "") : [travelInformation.transit.airline.ticketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ticket-num.md "") : Required Fields for an Ancillary Purchase {#airline-elavon-capture-req-fields_ancillary-fields} ----------------------------------------------------------------------------------------------- Include these fields, in addition to the above fields, if there is an ancillary purchase: [travelInformation.transit.airline.ancillaryInformation.ticketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-ticket-num.md "") : [travelInformation.transit.airline.ancillaryInformation.connectedTicketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-connected-.md "") : [travelInformation.transit.airline.ancillaryInformation.passengerName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-passenger-.md "") : [travelInformation.transit.airline.ancillaryInformation.service\[\].categoryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-ca.md "") : Include one of the possible values listed in the [Ancillary Service Category Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-anc-codes.md "") section. : To send multiple category codes, you must include additional entries of this field in the array. **Card-Specific Field for Capturing an Airline Payment** {#airline-elavon-capture-card-fields} ============================================================================================== Certain card types require additional fields. Diners Club ----------- Use this field in addition to the required fields to capture an airline authorization when using a Diners Club card. [travelInformation.transit.airline.legs\[\].flightNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-flight-number.md "") : Optional Fields for Capturing an Airline Payment {#airline-elavon-capture-opt-fields} ===================================================================================== [travelInformation.transit.airline.ancillaryInformation.feeDescription](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-fee-descri.md "") : [travelInformation.transit.airline.ancillaryInformation.service\[\].categoryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-ca.md "") : For a list of all possible values, see [Ancillary Service Category Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-anc-codes.md ""). [travelInformation.transit.airline.ancillaryInformation.service\[\].feeAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-fe.md "") : [travelInformation.transit.airline.ancillaryInformation.service\[\].feeCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-0.md "") : For a list of all possible values, see [Ancillary Service Category Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-anc-codes.md ""). [travelInformation.transit.airline.ancillaryInformation.service\[\].subCategoryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-su.md "") : [travelInformation.transit.airline.customerCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-cust-code.md "") : [travelInformation.transit.airline.legs\[\].fareBasis](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-fare-basis.md "") : [travelInformation.transit.airline.legs\[\].flightNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-flight-number.md "") : {#airline-elavon-capture-opt-fields_elavon-rest-opt-fields} Example: Capturing an Airline Payment {#airline-elavon-capture-ex-rest} ======================================================================= Request ``` { "clientReferenceInformation": { "code": "TC50171_3" }, "processingInformation": { "industryDataType": "airline" }, "orderInformation": { "amountDetails": { "totalAmount": "350.00", "currency": "USD" } }, "travelInformation": { "agency": { "name": "Test Airline" }, "transit": { "airline": { "ticketIssuer": { "code": "123456789" }, "ticketNumber": "123456798", "restrictedTicketIndicator": null, "passengerName": "John Smith", "legs": [ { "carrierCode": "AA", "originatingAirportCode": "DFW", "class": "First", "stopoverIndicator": "X", "departureDate": "20251231", "destinationAirportCode": "DFW" } ] } } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/captures/7659260363866784003812/voids" }, "self": { "method": "GET", "href": "/pts/v2/captures/7659260363866784003812" } }, "clientReferenceInformation": { "code": "TC50171_3" }, "id": "7659260363866784003812", "orderInformation": { "amountDetails": { "totalAmount": "350.00", "currency": "USD" } }, "reconciliationId": "69854049CJ7QD97N", "status": "PENDING", "submitTimeUtc": "2025-12-16T23:00:36Z" } ``` Example: Capturing an Airline Payment with Ancillary Purchase {#airline-elavon-capture-ancillary-ex-rest} ========================================================================================================= Request ``` { "clientReferenceInformation": { "code": "TC50171_3" }, "processingInformation": { "industryDataType": "airline" }, "orderInformation": { "amountDetails": { "totalAmount": "350.00", "currency": "USD" } }, "travelInformation": { "agency": { "name": "Test Airline" }, "transit": { "airline": { "ticketIssuer": { "code": "123456789" }, "ticketNumber": "123456798", "restrictedTicketIndicator": null, "passengerName": "John Smith", "legs": [ { "carrierCode": "AA", "originatingAirportCode": "DFW", "class": "First", "stopoverIndicator": "X", "departureDate": "20251231", "destinationAirportCode": "DFW" } ] } }, "travelInformation": { "transit": { "airline": { "ancillaryInformation": { "ticketNumber": "123456789", "passengerName": "John Smith", "connectedTicketNumber": "987654321", "service": [ { "categoryCode": "BF" } ] } } } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/captures/7659260363866784003812/voids" }, "self": { "method": "GET", "href": "/pts/v2/captures/7659260363866784003812" } }, "clientReferenceInformation": { "code": "TC50171_3" }, "id": "7659260363866784003812", "orderInformation": { "amountDetails": { "totalAmount": "350.00", "currency": "USD" } }, "reconciliationId": "69854049CJ7QD97N", "status": "PENDING", "submitTimeUtc": "2025-12-16T23:00:36Z" } ``` Refund a Payment {#airline-elavon-refund-intro} =============================================== This section describes how to issue a refund. A refund is follow-on request that returns the payment amount from a completed capture or sale. You must have a capture or sale transaction ID. Endpoint {#airline-elavon-refund-intro_d14e219} ----------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments/`*{id}*`/refunds`{#airline-elavon-refund-intro_d14e227} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments/`*{id}*`/refunds`{#airline-elavon-refund-intro_d14e240} The *{id}* is the transaction ID returned in the capture or sale response. Required Fields for Refunding a Payment {#airline-elavon-refund-req-fields} =========================================================================== [clientReferenceInformation.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-code.md "") : [orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : Required Fields for an Ancillary Purchase ----------------------------------------- Include these fields, in addition to the above fields, if there is an ancillary purchase: [travelInformation.transit.airline.ancillaryInformation.ticketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-ticket-num.md "") : [travelInformation.transit.airline.ancillaryInformation.connectedTicketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-connected-.md "") : [travelInformation.transit.airline.ancillaryInformation.passengerName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-passenger-.md "") : [travelInformation.transit.airline.ancillaryInformation.service\[\].categoryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-ca.md "") : Include one of the possible values listed in the [Ancillary Service Category Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-anc-codes.md "") section. : To send multiple category codes, you must include additional entries of this field in the array. Card-Specific Field for Processing Airline Refund {#airline-elavon-refund-card-fields} ====================================================================================== Certain card types require additional fields. Diners Club ----------- Use this field in addition to the required fields to capture an airline authorization when using a Diners Club card. [travelInformation.transit.airline.legs\[\].flightNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-flight-number.md "") : Optional Fields for Refunding a Payment {#airline-elavon-refund-opt-fields} =========================================================================== [travelInformation.transit.airline.ancillaryInformation.creditReasonIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-credit-rea.md "") : Set to one of these possible values: * `A`: Passenger transport ancillary fee cancellation * `B`: Airline ticket and passenger transport ancillary fee cancellation * `C`: Airline ticket cancellation * `O`: Other * `P`: Partial refund of airline ticket [travelInformation.transit.airline.ancillaryInformation.feeDescription](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-fee-descri.md "") : [travelInformation.transit.airline.ancillaryInformation.service\[\].categoryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-ca.md "") : For a list of all possible values, see [Ancillary Service Category Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-anc-codes.md ""). [travelInformation.transit.airline.ancillaryInformation.service\[\].feeAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-fe.md "") : [travelInformation.transit.airline.ancillaryInformation.service\[\].feeCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-0.md "") : For a list of all possible values, see [Ancillary Service Category Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-anc-codes.md ""). [travelInformation.transit.airline.ancillaryInformation.service\[\].subCategoryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-su.md "") : [travelInformation.transit.airline.clearingCount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-clearing-count.md "") : [travelInformation.transit.airline.clearingSequence](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-clearing-sequence.md "") : [travelInformation.transit.airline.totalClearingAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-total-clearing-amount.md "") : Example: Refunding a Payment {#airline-elavon-refund-ex-rest} ============================================================= Request ``` { "processingInformation": { "industryDataType": "airline" }, "orderInformation": { "amountDetails": { "totalAmount": "102.21" } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/refunds/6805496388936342404953/voids" }, "self": { "method": "GET", "href": "/pts/v2/refunds/6805496388936342404953" } }, "clientReferenceInformation": { "code": "1680549638986" }, "id": "6805496388936342404953", "orderInformation": { "amountDetails": { "currency": "USD" } }, "processorInformation": { "approvalCode": "888888", "responseCode": "100" }, "reconciliationId": "712678686G0ONA52", "refundAmountDetails": { "currency": "USD", "refundAmount": "102.21" }, "status": "PENDING", "submitTimeUtc": "2023-04-03T19:20:39Z" } ``` Example: Refunding a Payment with Ancillary Purchase {#airline-elavon-refund-anc-ex-rest} ========================================================================================= Request ``` { "clientReferenceInformation": { "code": "TC50171_3" }, "orderInformation": { "amountDetails": { "totalAmount": "102.21", "currency": "USD" } }, "travelInformation": { "transit": { "airline": { "ancillaryInformation": { "ticketNumber": "123456789123456", "passengerName": "John Smith", "connectedTicketNumber": "987654321987654", "service": [ { "categoryCode": "1" } ] } } } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/refunds/6805496388936342404953/voids" }, "self": { "method": "GET", "href": "/pts/v2/refunds/6805496388936342404953" } }, "clientReferenceInformation": { "code": "TC50171_3" }, "id": "6805496388936342404953", "orderInformation": { "amountDetails": { "currency": "USD" } }, "processorInformation": { "approvalCode": "888888", "responseCode": "100" }, "reconciliationId": "712678686G0ONA52", "refundAmountDetails": { "currency": "USD", "refundAmount": "102.21" }, "status": "PENDING", "submitTimeUtc": "2023-04-03T19:20:39Z" } ``` Issue a Credit {#airline-elavon-credit-intro} ============================================= This topic describes how to issue an airline credit. > IMPORTANT All fields used in the original transaction must be included in your request. Endpoint {#airline-elavon-credit-intro_d14e189} ----------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/credits/`{#airline-elavon-credit-intro_d14e198} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/credits/`{#airline-elavon-credit-intro_d14e208} Required Fields for Airline Credits {#airline-elavon-credit-req-fields} ======================================================================= [orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : [orderInformation.billTo.address1](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-address1.md "") : [orderInformation.billTo.administrativeArea](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-admin-area.md "") : [orderInformation.billTo.country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-country.md "") : [orderInformation.billTo.email](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-email.md "") : [orderInformation.billTo.firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-first-name.md "") : [orderInformation.billTo.lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-last-name.md "") : [orderInformation.billTo.externality](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-externality.md "") : [orderInformation.billTo.postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-postal-code.md "") : [paymentInformation.card.expirationMonth](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-exp-mo.md "") : [paymentInformation.card.expirationYear](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-exp-year.md "") : [paymentInformation.card.number](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-number.md "") : Required Fields for an Ancillary Purchase ----------------------------------------- Include these fields, in addition to the above fields, if there is an ancillary purchase: [travelInformation.transit.airline.ancillaryInformation.ticketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-ticket-num.md "") : [travelInformation.transit.airline.ancillaryInformation.connectedTicketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-connected-.md "") : [travelInformation.transit.airline.ancillaryInformation.passengerName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-passenger-.md "") : [travelInformation.transit.airline.ancillaryInformation.service\[\].categoryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-ca.md "") : Include one of the possible values listed in the [Ancillary Service Category Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-anc-codes.md "") section. : To send multiple category codes, you must include additional entries of this field in the array. Card-Specific Field for Processing Airline Credits {#airline-elavon-credit-card-fields} ======================================================================================= Certain card types require additional fields. Diners Club ----------- Use this field in addition to the required fields to capture an airline authorization when using a Diners Club card. [travelInformation.transit.airline.legs\[\].flightNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-flight-number.md "") : Optional Fields for Airline Credits {#airline-elavon-credit-opt-fields} ======================================================================= [travelInformation.transit.airline.ancillaryInformation.creditReasonIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-credit-rea.md "") : Set to one of these possible values: * `A`: Passenger transport ancillary fee cancellation * `B`: Airline ticket and passenger transport ancillary fee cancellation * `C`: Airline ticket cancellation * `O`: Other * `P`: Partial refund of airline ticket [travelInformation.transit.airline.ancillaryInformation.feeDescription](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-fee-descri.md "") : [travelInformation.transit.airline.ancillaryInformation.service\[\].categoryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-ca.md "") : For a list of all possible values, see [Ancillary Service Category Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-anc-codes.md ""). [travelInformation.transit.airline.ancillaryInformation.service\[\].feeAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-fe.md "") : [travelInformation.transit.airline.ancillaryInformation.service\[\].feeCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-0.md "") : For a list of all possible values, see [Ancillary Service Category Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-anc-codes.md ""). [travelInformation.transit.airline.ancillaryInformation.service\[\].subCategoryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-su.md "") : [travelInformation.transit.airline.clearingCount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-clearing-count.md "") : [travelInformation.transit.airline.clearingSequence](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-clearing-sequence.md "") : [travelInformation.transit.airline.totalClearingAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-total-clearing-amount.md "") : Example: Processing Airline Credits {#airline-elavon-credit-ex-rest} ==================================================================== Request ``` { "paymentInformation": { "card": { "number": "4111111111111111", "expirationMonth": "07", "expirationYear": "2027" } }, "orderInformation": { "amountDetails": { "totalAmount": "300.00", "currency": "USD" }, "billTo": { "firstName": "John", "lastName": "Smith", "address1": "123 Happy St", "externality": "Sunnyville", "administrativeArea": "TX", "postalCode": "55555", "country": "US", "email": "johnsmith@testemail.com" } } } ``` Response ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/credits/7678035881236488904805/voids" }, "self": { "method": "GET", "href": "/pts/v2/credits/7678035881236488904805" } }, "clientReferenceInformation": { "code": "1767803588270" }, "creditAmountDetails": { "currency": "USD", "creditAmount": "300.00" }, "id": "7678035881236488904805", "orderInformation": { "amountDetails": { "currency": "USD" } }, "paymentAccountInformation": { "card": { "type": "001" } }, "paymentInformation": { "tokenizedCard": { "type": "001" }, "card": { "type": "001" } }, "processorInformation": { "approvalCode": "888888", "responseCode": "100" }, "reconciliationId": "JDWEIJB43Y09", "status": "PENDING", "submitTimeUtc": "2026-01-07T16:33:08Z" } ``` Example: Issue a Credit for an Ancillary Purchase {#airline-elavon-credit-anc-ex-rest} ====================================================================================== Request ``` { "paymentInformation": { "card": { "number": "4111111111111111", "expirationMonth": "07", "expirationYear": "2027" } }, "orderInformation": { "amountDetails": { "totalAmount": "300.00", "currency": "USD" }, "billTo": { "firstName": "John", "lastName": "Smith", "address1": "123 Happy St", "externality": "Sunnyville", "administrativeArea": "TX", "postalCode": "55555", "country": "US", "email": "johnsmith@testemail.com" } }, "travelInformation": { "transit": { "airline": { "ancillaryInformation": { "ticketNumber": "1234567981234567989", "passengerName": "John Smith", "connectedTicketNumber": "987654321987654", "service": [ { "categoryCode": "1" } ] } } } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/credits/7678040337136100204805/voids" }, "self": { "method": "GET", "href": "/pts/v2/credits/7678040337136100204805" } }, "clientReferenceInformation": { "code": "1767804033806" }, "creditAmountDetails": { "currency": "USD", "creditAmount": "300.00" }, "id": "7678040337136100204805", "orderInformation": { "amountDetails": { "currency": "USD" } }, "paymentAccountInformation": { "card": { "type": "001" } }, "paymentInformation": { "tokenizedCard": { "type": "001" }, "card": { "type": "001" } }, "processorInformation": { "approvalCode": "888888", "responseCode": "100" }, "reconciliationId": "JQT0PJB4FMOB", "status": "PENDING", "submitTimeUtc": "2026-01-07T16:40:33Z" } ``` `FDC Nashville Global` Airline Requests {#airline-fdcglobal-intro} ================================================================== This section describes the airline payment services you can use when processing with `FDC Nashville Global`. Supported Card Types -------------------- This table lists the card types `FDC Nashville Global` supports and their values. When including the paymentInformation.card.type field, set the field to a value listed in the card type value column. | Supported Card Type | Card Type Value | |---------------------|-----------------| | American Express | `003` | | Discover | `004` | | Mastercard | `002` | | Visa | `001` | [`FDC Nashville Global` Supported Card Types] Authorize a Payment {#airline-fdcglobal-auth-intro} =================================================== This section describes how to process an airline authorization. Authorization Restrictions -------------------------- Ticket purchases that include multiple passengers may be included in a single authorization request, however, `Cybersource` recommends sending a separate capture request for each passenger. If any ancillary purchases are made at the same time as the ticket purchase, you may include all the items in a single authorization request, however, `Cybersource` recommends separating the ancillary and ticket purchases into individual capture requests. If any ancillary purchases are not made at the same time as the ticket purchase, `Cybersource` recommends separating the authorization and capture requests for the ancillary and ticket purchases. Endpoint {#airline-fdcglobal-auth-intro_d14e16} ----------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#airline-fdcglobal-auth-intro_d14e25} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#airline-fdcglobal-auth-intro_d14e35} **Production in Saudi Arabia:** `POST ``https://api.sa.cybersource.com``/pts/v2/payments` **Test in Saudi Arabia:** `POST ``https://apitest.sa.cybersource.com``/pts/v2/payments` Required Fields for an Airline Authorization {#airline-fdcglobal-auth-req-fields} ================================================================================= Include these fields to process an airline authorization. > IMPORTANT > When relaxed requirements for address data and the expiration date are being used, not all fields in this list are required. It is your responsibility to determine whether your account is enabled to use this feature and which fields are required. For details about relaxed requirements, see [Relaxed Requirements for Address Data and Expiration Date in Payment Transactions](/docs/cybs/en-us/airline/developer/all/rest/airline/payments-relax-reqs.md ""). [clientReferenceInformation.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-code.md "") : [orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : [orderInformation.billTo.address1](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-address1.md "") : [orderInformation.billTo.administrativeArea](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-admin-area.md "") : [orderInformation.billTo.country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-country.md "") : [orderInformation.billTo.email](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-email.md "") : [orderInformation.billTo.firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-first-name.md "") : [orderInformation.billTo.lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-last-name.md "") : [orderInformation.billTo.externality](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-externality.md "") : [orderInformation.billTo.postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-postal-code.md "") : [paymentInformation.card.expirationMonth](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-exp-mo.md "") : [paymentInformation.card.expirationYear](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-exp-year.md "") : [paymentInformation.card.number](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-number.md "") : [paymentInformation.card.type](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-type-a.md "") : [processingInformation.industryDataType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-industry-data-type.md "") : Set the value to `airline`. {#airline-fdcglobal-auth-req-fields_dl_slc_lxj_fxb} Card-Specific Fields for an Airline Authorization {#airline-fdcglobal-auth-card-fields} ======================================================================================= This section includes card-specific information required for an airline authorization. American Express ---------------- Include these fields in addition to the required fields when using an American Express card. American Express requires leg fields in the authorization request. For more information about leg fields, see [Airline Travel Legs](/docs/cybs/en-us/airline/developer/all/rest/airline/home-merch/airline-intro-legs.md ""). [orderInformation.shipTo.firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-shipto-first-name.md "") : [travelInformation.transit.airline.legs\[\].carrierCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-carrier-code.md "") : [travelInformation.transit.airline.legs\[\].departureDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-departure-date.md "") : [travelInformation.transit.airline.legs\[\].destinationAirportCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-dest-airport-code.md "") : [travelInformation.transit.airline.legs\[\].fareBasis](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-fare-basis.md "") : [travelInformation.transit.airline.legs\[\].originatingAirportCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-orig-airport-code.md "") : [travelInformation.transit.airline.passengerName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-pass-name.md "") : {#airline-fdcglobal-auth-card-fields_ae-fields-rest} `REST` Example: Airline Authorization {#airline-fdcglobal-auth-ex-rest} ======================================================================= Request ```keyword { "clientReferenceInformation": { "code": "RTS-Auth" }, "orderInformation": { "billTo": { "country": "US", "lastName": "VDP", "address2": "test", "address1": "201 S. Division St.", "postalCode": "48104-2201", "externality": "Ann Arbor", "administrativeArea": "MI", "firstName": "RTS", "phoneNumber": "999999999", "district": "MI", "buildingNumber": "123", "company": "Visa", "email": "test@cybs.com" }, "amountDetails": { "totalAmount": "100.00", "currency": "usd" }, "shipTo": { "firstName": "Michale" } }, "paymentInformation": { "card": { "expirationYear": "2031", "number": "3782822463xxxxx", "expirationMonth": "12", "securityCode": "123", "type": "003" } }, "processingInformation": { "industryDataType": "airline" }, "travelInformation": { "transit": { "airline": { "passengerName": "Michale", "legs": [ { "carrierCode": "123", "fareBasis": "B1", "departureDate": "20230202", "destinationAirportCode": "NY", "originatingAirportCode": "SFO" }, { "carrierCode": "456", "fareBasis": "B2", "departureDate": "20230202", "destinationAirportCode": "SFO", "originatingAirportCode": "SJC" } ] } } } } ``` Response to a Successful Request ``` { "_links": { "authReversal": { "method": "POST", "href": "/pts/v2/payments/6902464806406008803234/reversals" }, "self": { "method": "GET", "href": "/pts/v2/payments/6902464806406008803234" }, "capture": { "method": "POST", "href": "/pts/v2/payments/6902464806406008803234/captures" } }, "clientReferenceInformation": { "code": "1690246480572" }, "id": "6902464806406008803234", "issuerInformation": { "responseRaw": "0110322000000E1000020000000000000100000725005441300026475537344F4B48495131314D38333130303030300001590064003631342030313631373831313031353439343520202020202036363030533036303030303100103232415050524F56414C0012534443523030355959595959" }, "orderInformation": { "amountDetails": { "authorizedAmount": "100.00", "currency": "usd" } }, "paymentAccountInformation": { "card": { "type": "003" } }, "paymentInformation": { "tokenizedCard": { "type": "003" }, "card": { "type": "003" } }, "pointOfSaleInformation": { "terminalId": "00092940" }, "processorInformation": { "electronicVerificationResults": { "phoneNumberRaw": "Y", "emailRaw": "Y", "phoneNumber": "Y", "code": "Y", "postalCodeRaw": "Y", "street": "Y", "postalCode": "Y", "codeRaw": "Y", "streetRaw": "Y", "email": "Y" }, "merchantNumber": "000000000001234", "approvalCode": "831000", "responseCode": "00", "avs": { "code": "Y", "codeRaw": "Y" } }, "reconciliationId": "GU74OKHIQ11M", "status": "AUTHORIZED", "submitTimeUtc": "2023-07-25T00:54:41Z" } ``` Request ```keyword { "clientReferenceInformation": { "code": "RTS-Auth" }, "processingInformation": { "industryDataType": "airline" }, "paymentInformation": { "card": { "number": "4111111111111111", "expirationMonth": "12", "expirationYear": "2031", "type": "001" } }, "orderInformation": { "amountDetails": { "totalAmount": "102.21", "currency": "USD" }, "billTo": { "firstName": "John", "lastName": "Doe", "address1": "1 Market St", "externality": "san francisco", "administrativeArea": "CA", "postalCode": "94105", "country": "US", "email": "test@cybs.com" } } } ``` Successful Response ``` { "_links": { "authReversal": { "method": "POST", "href": "/pts/v2/payments/6917758602546577403955/reversals" }, "self": { "method": "GET", "href": "/pts/v2/payments/6917758602546577403955" }, "capture": { "method": "POST", "href": "/pts/v2/payments/6917758602546577403955/captures" } }, "clientReferenceInformation": { "code": "1691775860306" }, "id": "6917758602546577403955", "orderInformation": { "amountDetails": { "authorizedAmount": "102.21", "currency": "USD" } }, "paymentAccountInformation": { "card": { "type": "001" } }, "paymentInformation": { "tokenizedCard": { "type": "001" }, "card": { "type": "001" } }, "pointOfSaleInformation": { "terminalId": "111111" }, "processorInformation": { "approvalCode": "888888", "networkTransactionId": "123456789619999", "transactionId": "123456789619999", "responseCode": "100", "avs": { "code": "X", "codeRaw": "I1" } }, "reconciliationId": "68209505QL5OEHAU", "status": "AUTHORIZED", "submitTimeUtc": "2023-08-11T17:44:20Z" } ``` Unsuccessful Response ``` { "submitTimeUtc" : "2020-05-20T21:06:56Z", "status" : "INVALID_REQUEST", "reason" : "INVALID_DATA", "message" : "Declined - One or more fields in the request contains invalid data", "details" : [ { "field" : "stopover_code", "reason" : "INVALID_DATA" } ] } ``` Capture a Ticket Payment {#airline-fdcglobal-capture-intro} =========================================================== This section describes how to capture an airline ticket payment, such as when a person is purchasing a ticket on your e-commerce store. Capture Restrictions {#airline-fdcglobal-capture-intro_sect-cap-restrict} ------------------------------------------------------------------------- For a ticket purchase with multiple passengers, `Cybersource` recommends sending separate capture requests for each passenger. The original authorization may be a single request. When ancillary purchases are made at the same time as the ticket purchase, `Cybersource` recommends sending separate capture requests for the ticket and ancillary purchases. Airline Travel Legs {#airline-fdcglobal-capture-intro_sect-travel-legs} ----------------------------------------------------------------------- `FDC Nashville Global` requires you to include travel leg fields in your requests, even for direct flights. For more information about how to format travel leg fields, see [Airline Travel Legs](/docs/cybs/en-us/airline/developer/all/rest/airline/home-merch/airline-intro-legs.md ""). Leg Limitations {#airline-fdcglobal-capture-intro_leg-limit-capture} -------------------------------------------------------------------- `FDC Nashville Global` limits the maximum number of legs for each trip based on card type. This table describes the maximum number of legs for each trip based on processor and card type. | Supported Card Types | Maximum Number of Trip Legs | |----------------------|-----------------------------| | American Express | 4 | | Discover | 4 | | Mastercard | 99 | | Visa | 4 | [`FDC Nashville Global` Leg Limitations] Endpoint {#airline-fdcglobal-capture-intro_d14e147} --------------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments/`*{id}*`/captures`{#airline-fdcglobal-capture-intro_d14e156} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments/`*{id}*`/captures`{#airline-fdcglobal-capture-intro_d14e169} The *{id}* is the transaction ID returned in the authorization response. Required Fields for Capturing a Ticket Payment {#airline-fdcglobal-capture-req-fields} ====================================================================================== Include these required fields to capture an airline payment for tickets. [clientReferenceInformation.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-code.md "") : [orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : [processingInformation.industryDataType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-industry-data-type.md "") : Set the value to `airline`. [travelInformation.transit.airline.legs\[\].carrierCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-carrier-code.md "") : [travelInformation.transit.airline.legs\[\].class](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-class.md "") : [travelInformation.transit.airline.legs\[\].departureDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-departure-date.md "") : [travelInformation.transit.airline.legs\[\].destinationAirportCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-dest-airport-code.md "") : [travelInformation.transit.airline.legs\[\].originatingAirportCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-orig-airport-code.md "") : [travelInformation.transit.airline.passengerName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-pass-name.md "") : travelInformation.transit.airline.ticketNumber : {#airline-fdcglobal-capture-req-fields_dl_pyl_3dg_2xb} Card-Specific Fields for Capturing a Ticket Payment {#airline-fdcglobal-capture-req-fields-cardtype} ==================================================================================================== This section includes card-specific information required to capture a payment for tickets. Discover -------- Include these fields in addition to the required fields when using a Discover card. [travelInformation.agency.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-agency-code.md "") : [travelInformation.transit.airline.arrivalDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-arrival-date.md "") : [travelInformation.transit.airline.legs\[\].arrivalTime](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-arrival-time-a.md "") : [travelInformation.transit.airline.legs\[\].arrivalTimeMeridian](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-arrival-time-meri.md "") : Set the value to `A` or `P`. [travelInformation.transit.airline.legs\[\].departureTime](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-departure-time.md "") : [travelInformation.transit.airline.legs\[\].departureTimeMeridian](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-depart-time-merid.md "") : Set the value to `A` or `P`. [travelInformation.transit.airline.legs\[\].fareBasis](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-fare-basis.md "") : [travelInformation.transit.airline.legs\[\].flightNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-flight-number.md "") : [travelInformation.transit.airline.legs\[\].totalFareAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-total-fare-amount.md "") : [travelInformation.transit.airline.ticketIssueDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ticket-issue-date.md "") : [travelInformation.transit.airline.ticketIssuer.address](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ticket-issuer-add.md "") : {#airline-fdcglobal-capture-req-fields-cardtype_discover-fields-rest} Mastercard ---------- Include these fields in addition to the required fields when using a Mastercard card. [travelInformation.transit.airline.legs\[\].fareBasis](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-fare-basis.md "") : [travelInformation.transit.airline.legs\[\].flightNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-flight-number.md "") : [travelInformation.transit.airline.legs\[\].departureTime](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-depart-time.md "") : {#airline-fdcglobal-capture-req-fields-cardtype_mc-fields-rest} Visa ---- Include this field in addition to the required fields when using a Visa card. [travelInformation.transit.airline.restrictedTicketIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-restrict-ticket-ind.md "") : Set the value to `0` for refundable. : Set the value to `1` for nonrefundable. {#airline-fdcglobal-capture-req-fields-cardtype_visa-rest} Optional Fields for an Airline Capture {#airline-fdcglobal-capture-opt-fields} ============================================================================== Choose from these optional fields to include additional information when capturing an airline payment for direct flight tickets. [orderInformation.amountDetails.taxAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-tax-amount.md "") : [orderInformation.amountDetails.taxDetails\[\].amount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-tax-details-amount.md "") : [travelInformation.agency.name](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-agency-name.md "") : travelInformation.transit.airline.clearingCount : travelInformation.transit.airline.clearingSequence : [travelInformation.transit.airline.customerCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-cust-code.md "") : [travelInformation.transit.airline.legs\[\].conjunctionTicket](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-conjunction-ticke.md "") : [travelInformation.transit.airline.legs\[\].couponNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-coupon-num.md "") : [travelInformation.transit.airline.legs\[\].endorsementsRestrictions](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-endorse-restrict.md "") : [travelInformation.transit.airline.legs\[\].exchangeTicketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-ex-ticket-num.md "") : [travelInformation.transit.airline.legs\[\].feeAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-fee-amount.md "") : [travelInformation.transit.airline.legs\[\].stopoverIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-stop-over-indicat.md "") : Set the value to `O` (capital letter "O") to indicate the leg of a trip is allowed to stopover. Default value. : Set the value to `X`to indicate the leg of a trip is not allowed to stopover. [travelInformation.transit.airline.legs\[\].taxAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-tax-amount.md "") : [travelInformation.transit.airline.planNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-plan-number.md "") : travelInformation.transit.airline.totalClearingAmount : [travelInformation.transit.airline.totalFeeAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-total-fee-amount.md "") : [travelInformation.transit.exchangeTicketAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-exchange-ticket-amt.md "") : [travelInformation.transit.exchangeTicketFeeAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-exchange-ticket-fee-amt.md "") : {#airline-fdcglobal-capture-opt-fields_opt-fields-rest} `REST` Example: Capturing a Visa Airline Payment {#airline-fdcglobal-capture-ex-rest} ===================================================================================== Request ``` { "clientReferenceInformation": { "code": "RTS-Bill" }, "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "USD" } }, "processingInformation": { "industryDataType": "airline" }, "travelInformation": { "agency": { "name": "Thomascook" }, "transit": { "airline": { "passengerName": "John", "ticketNumber": "asd23", "customerCode": "LDTYOU789", "totalFeeAmount": "200", "planNumber": "49252", "exchangeTicketAmount": "11", "exchangeTicketFeeAmount": "1", "legs": [ { "carrierCode": "AA", "originatingAirportCode": "SFO", "class": "1", "stopoverIndicator": "O", "departureDate": "20230202", "destinationAirportCode": "NY", "exchangeTicketNumber": "ticket12", "endorsementsRestrictions": "Endorsement1234", "feeAmount": "999.99", "taxAmount": "99" }, { "carrierCode": "BB", "originatingAirportCode": "NY", "class": "2", "stopoverIndicator": "O", "departureDate": "20230202", "destinationAirportCode": "SFO", "exchangeTicketNumber": "ticket13", "endorsementsRestrictions": "Endorsement1234", "feeAmount": "999.99", "taxAmount": "99" } ] } } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/captures/6917768579016106103954/voids" }, "self": { "method": "GET", "href": "/pts/v2/captures/6917768579016106103954" } }, "clientReferenceInformation": { "code": "RTS-Bill" }, "id": "6917768579016106103954", "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "USD" } }, "reconciliationId": "682098706L5PQJ7Y", "status": "PENDING", "submitTimeUtc": "2023-08-11T18:00:58Z" } ``` Request ``` { "clientReferenceInformation": { "code": "RTS-Bill" }, "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "USD" } }, "processingInformation": { "industryDataType": "airline" }, "travelInformation": { "agency": { "name": "Thomascook", "code": "123" }, "transit": { "airline": { "passengerName": "John", "ticketNumber": "asd23", "customerCode": "LDTYOU789", "totalFeeAmount": "200", "planNumber": "49252", "exchangeTicketAmount": "11", "exchangeTicketFeeAmount": "1", "ticketIssueDate": "20190202", "arrivalDate": "20230808", "ticketIssuer": { "address": "Silicon Vally" }, "legs": [ { "carrierCode": "AA", "flightNumber": "UA789", "originatingAirportCode": "SFO", "class": "1", "stopoverIndicator": "O", "departureDate": "20230202", "destinationAirportCode": "NY", "fareBasis": "B1", "totalFareAmount": "12", "exchangeTicketNumber": "ticket12", "departureTime": "1720", "endorsementsRestrictions": "Endorsement1234", "arrivalTime": "1920", "arrivalTimeMeridian": "A", "departureTime": "1230", "departureTimeMeridian": "A" }, { "carrierCode": "BB", "flightNumber": "UA788", "originatingAirportCode": "NY", "class": "2", "stopoverIndicator": "O", "departureDate": "20230202", "destinationAirportCode": "SFO", "fareBasis": "B1", "totalFareAmount": "12", "exchangeTicketNumber": "ticket13", "departureTime": "1720", "endorsementsRestrictions": "Endorsement1234", "arrivalTime": "0120", "arrivalTimeMeridian": "A", "departureTime": "2030", "departureTimeMeridian": "A" } ] } } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/captures/6917775047466121303955/voids" }, "self": { "method": "GET", "href": "/pts/v2/captures/6917775047466121303955" } }, "clientReferenceInformation": { "code": "RTS-Bill" }, "id": "6917775047466121303955", "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "USD" } }, "reconciliationId": "68210417JL5O06RJ", "status": "PENDING", "submitTimeUtc": "2023-08-11T18:11:44Z" } ``` Request ``` { "clientReferenceInformation": { "code": "RTS-Bill" }, "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "USD" } }, "processingInformation": { "industryDataType": "airline" }, "travelInformation": { "agency": { "name": "Thomascook" }, "transit": { "airline": { "passengerName": "John", "ticketNumber": "asd23", "customerCode": "LDTYOU789", "totalFeeAmount": "200", "planNumber": "49252", "exchangeTicketAmount": "11", "exchangeTicketFeeAmount": "1", "legs": [ { "carrierCode": "AA", "flightNumber": "UA789", "originatingAirportCode": "SFO", "class": "1", "stopoverIndicator": "O", "departureDate": "20230202", "destinationAirportCode": "NY", "fareBasis": "B1", "exchangeTicketNumber": "ticket12", "departureTime": "1720", "endorsementsRestrictions": "Endorsement1234" }, { "carrierCode": "BB", "flightNumber": "UA788", "originatingAirportCode": "NY", "class": "2", "stopoverIndicator": "O", "departureDate": "20230202", "destinationAirportCode": "SFO", "fareBasis": "B1", "exchangeTicketNumber": "ticket13", "departureTime": "1720", "endorsementsRestrictions": "Endorsement1234" } ] } } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/captures/6917778689216158003955/voids" }, "self": { "method": "GET", "href": "/pts/v2/captures/6917778689216158003955" } }, "clientReferenceInformation": { "code": "RTS-Bill" }, "id": "6917778689216158003955", "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "USD" } }, "reconciliationId": "68210471JL5O06T1", "status": "PENDING", "submitTimeUtc": "2023-08-11T18:17:49Z" } ``` Request ``` { "clientReferenceInformation": { "code": "RTS-Bill" }, "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "USD" } }, "processingInformation": { "industryDataType": "airline" }, "travelInformation": { "agency": { "name": "Thomascook" }, "transit": { "airline": { "passengerName": "John", "ticketNumber": "asd23", "customerCode": "LDTYOU789", "totalFeeAmount": "200", "planNumber": "49252", "exchangeTicketAmount": "11", "exchangeTicketFeeAmount": "1", "restrictedTicketIndicator": "0", "legs": [ { "carrierCode": "AA", "originatingAirportCode": "SFO", "class": "1", "stopoverIndicator": "O", "departureDate": "20230202", "destinationAirportCode": "NY", "exchangeTicketNumber": "ticket12", "departureTime": "1720", "endorsementsRestrictions": "Endorsement1234" }, { "carrierCode": "BB", "originatingAirportCode": "NY", "class": "2", "stopoverIndicator": "O", "departureDate": "20230202", "destinationAirportCode": "SFO", "exchangeTicketNumber": "ticket13", "departureTime": "1720", "endorsementsRestrictions": "Endorsement1234" } ] } } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/captures/6917788755186225803955/voids" }, "self": { "method": "GET", "href": "/pts/v2/captures/6917788755186225803955" } }, "clientReferenceInformation": { "code": "RTS-Bill" }, "id": "6917788755186225803955", "orderInformation": { "amountDetails": { "totalAmount": "100.00", "currency": "USD" } }, "reconciliationId": "68211484JL5O0702", "status": "PENDING", "submitTimeUtc": "2023-08-11T18:34:35Z" } ``` Capture an Ancillary Purchase {#airline-fdcglobal-capture-anc-intro} ==================================================================== Ancillary purchases are any additional services, such as baggage, meals, and paid seats, your customers can purchase. Captures for ancillary purchases must be separate for captures for ticket purchases. `FDC Nashville Global` supports up to four ancillary purchases for each capture. Capture Restrictions -------------------- When ancillary purchases are made at the same time as the ticket purchase, `Cybersource` recommends that you send separate capture requests for the ticket and ancillary purchases. When ancillary purchases are not made at the same time as the ticket purchase, `Cybersource` recommends that you send separate authorization and capture requests for the ancillary and ticket purchases. Endpoint {#airline-fdcglobal-capture-anc-intro_d14e147} ------------------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments/`*{id}*`/captures`{#airline-fdcglobal-capture-anc-intro_d14e156} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments/`*{id}*`/captures`{#airline-fdcglobal-capture-anc-intro_d14e169} The *{id}* is the transaction ID returned in the authorization response. Required Fields for an Airline Capture {#airline-fdcglobal-capture-anc-req-fields} ================================================================================== [clientReferenceInformation.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-code.md "") : [orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : {#airline-fdcglobal-capture-anc-req-fields_dl_pyl_3dg_2xb} Ancillary Airline Fields ------------------------ Choose from these optional ancillary airline fields to include in your capture request in addition to the required fields listed above. > IMPORTANT > ` FDC Nashville Global ` supports up to four ancillary purchases for each capture. [travelInformation.transit.airline.ancillaryInformation.connectedTicketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-connected-.md "") : [travelInformation.transit.airline.ancillaryInformation.passengerName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-passenger-.md "") : [travelInformation.transit.airline.ancillaryInformation.service\[\].categoryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-ca.md "") : For a list of possible values, see [Ancillary Service Category Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-anc-codes.md ""). [travelInformation.transit.airline.ancillaryInformation.service\[\].subCategoryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-su.md "") : For a list of possible values, see [Ancillary Service Category Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-anc-codes.md ""). [travelInformation.transit.airline.ancillaryInformation.ticketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-ticket-num.md "") : [travelInformation.transit.airline.ticketChangeIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ticket-change-ind.md "") : Set the value to `C` for changing an existing ticket. : Set the value to `N` for a new ticket. {#airline-fdcglobal-capture-anc-req-fields_dl_kwx_nd3_1xb} `REST` Example: Capturing an Airline Payment for Ancillary Purchases {#airline-fdcglobal-capture-anc-ex-rest} ============================================================================================================= Request ``` { "clientReferenceInformation": { "code": "TC50171_3" }, "orderInformation": { "amountDetails": { "totalAmount": "102.21", "currency": "USD" } }, "travelInformation": { "transit": { "airline": { "ancillaryInformation": { "ticketNumber": "123456789", "passengerName": "John Doe", "connectedTicketNumber": "987654321", "service": [ { "categoryCode": "65", "subCategoryCode": "75" } ] } } } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/captures/6811595456806928403955/voids" }, "self": { "method": "GET", "href": "/pts/v2/captures/6811595456806928403955" } }, "clientReferenceInformation": { "code": "TC50171_3" }, "id": "6811595456806928403955", "orderInformation": { "amountDetails": { "totalAmount": "102.21", "currency": "USD" } }, "reconciliationId": "658927039G5GNF51", "status": "PENDING", "submitTimeUtc": "2023-04-10T20:45:45Z" } ``` Refund a Payment {#airline-fdcglobal-credit-fo-intro} ===================================================== This section describes how to process an airline refund, which requires you to have the transaction ID from the original payment. Endpoint {#airline-fdcglobal-credit-fo-intro_d14e219} ----------------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments/`*{id}*`/refunds`{#airline-fdcglobal-credit-fo-intro_d14e227} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments/`*{id}*`/refunds`{#airline-fdcglobal-credit-fo-intro_d14e240} The *{id}* is the transaction ID returned in the capture or sale response. Required Fields for an Airline Refund {#airline-fdcglobal-credit-fo-req-fields} =============================================================================== [clientReferenceInformation.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-ref-info-aa/client-ref-info-code.md "") : [orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : Optional Fields for an Airline Refund {#airline-fdcglobal-credit-fo-opt-fields} =============================================================================== Choose from these optional fields to include additional information when processing an airline refund. travelInformation.transit.airline. clearingCount : travelInformation.transit.airline. clearingSequence : travelInformation.transit.airline. totalClearingAmount : travelInformation. transit. airline.ancillaryInformation. creditReasonIndicator : Set to one of these possible values: * `A`: Passenger transport ancillary fee cancellation * `B`: Airline ticket and passenger transport ancillary fee cancellation * `C`: Airline ticket cancellation * `O`: Other * `P`: Partial refund of airline ticket `REST` Example: Processing an Airline Refund {#airline-fdcglobal-credit-fo-ex-rest} =================================================================================== Request ``` { "processingInformation": { "industryDataType": "airline" }, "orderInformation": { "amountDetails": { "totalAmount": "102.21" } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/refunds/6805496388936342404953/voids" }, "self": { "method": "GET", "href": "/pts/v2/refunds/6805496388936342404953" } }, "clientReferenceInformation": { "code": "1680549638986" }, "id": "6805496388936342404953", "orderInformation": { "amountDetails": { "currency": "USD" } }, "processorInformation": { "approvalCode": "888888", "responseCode": "100" }, "reconciliationId": "712678686G0ONA52", "refundAmountDetails": { "currency": "USD", "refundAmount": "102.21" }, "status": "PENDING", "submitTimeUtc": "2023-04-03T19:20:39Z" } ``` `Visa Platform Connect` Airline Requests {#airline-ctv-intro} ============================================================= This section describes how to process airline payments using `Visa Platform Connect`. Requirement {#airline-ctv-intro_section_epm_fmr_5xb} ---------------------------------------------------- When you are ready to go live with airline data processing, contact `Cybersource` Customer Support to have your account configured to process airline data. If your account is not enabled, and you try to send airline transactions, you will receive an error for invalid data. Related Information {#airline-ctv-intro_section_dmg_nnr_5xb} ------------------------------------------------------------ * See [Airline Data](/docs/cybs/en-us/airline/developer/all/rest/airline/payments-processing-airline-intro.md "") for information about and requirements for processing payments that include airline data. * See [Airline Data Reference Information](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro.md "") for a list and description of the different document type and ancillary service category codes that are used when processing payments that include airline data. {#airline-ctv-intro_ul_qgs_nnr_5xb} Authorize an Airline Ticket Payment {#airline-ctv-auth-intro} ============================================================= This section describes how to process an airline authorization. Authorization Restrictions -------------------------- Ticket purchases that include multiple passengers may be included in a single authorization request, but you must make separate capture requests for every passenger. If any ancillary purchases are made at the same time as the ticket purchase, you may include all items in a single authorization request, but you must separate the ancillary and ticket purchases into their own capture requests. If any ancillary purchases are made not at the same time as the ticket purchase, you must send separate authorization and capture requests for the ancillary and ticket purchases. Endpoint {#airline-ctv-auth-intro_d14e16} ----------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments`{#airline-ctv-auth-intro_d14e25} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments`{#airline-ctv-auth-intro_d14e35} **Production in Saudi Arabia:** `POST ``https://api.sa.cybersource.com``/pts/v2/payments` **Test in Saudi Arabia:** `POST ``https://apitest.sa.cybersource.com``/pts/v2/payments` Required Fields for Authorizing an Airline Payment {#airline-ctv-auth-req-fields} ================================================================================= Include these required fields for authorizing an airline payment. > IMPORTANT > When relaxed requirements for address data and the expiration date are being used, not all fields in this list are required. It is your responsibility to determine whether your account is enabled to use this feature and which fields are required. For details about relaxed requirements, see [Relaxed Requirements for Address Data and Expiration Date in Payment Transactions](/docs/cybs/en-us/airline/developer/all/rest/airline/payments-relax-reqs.md ""). [orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : [orderInformation.billTo.address1](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-address1.md "") : [orderInformation.billTo.administrativeArea](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-admin-area.md "") : [orderInformation.billTo.country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-company-country.md "") : [orderInformation.billTo.email](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-email.md "") : [orderInformation.billTo.firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-first-name.md "") : [orderInformation.billTo.lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-last-name.md "") : [orderInformation.billTo.externality](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-externality.md "") : [orderInformation.billTo.postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-postal-code.md "") : [paymentInformation.card.expirationMonth](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-exp-mo.md "") : [paymentInformation.card.expirationYear](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-exp-year.md "") : [paymentInformation.card.number](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-number.md "") : [processingInformation.industryDataType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-industry-data-type.md "") : Set the value to `airline`. {#airline-ctv-auth-req-fields_dl_dty_qrz_fxb} REST Example: Authorizing an Airline Payment {#airline-ctv-auth-ex-rest} ======================================================================== Request ```keyword { "processingInformation": { "industryDataType": "airline" }, "paymentInformation": { "card": { "number": "4111111111111111", "expirationMonth": "12", "expirationYear": "2031" } }, "orderInformation": { "amountDetails": { "totalAmount": "500.00", "currency": "usd" }, "billTo": { "firstName": "John", "lastName": "Doe", "address1": "123 Happy St.", "externality": "Sunny Town", "administrativeArea": "CA", "postalCode": "12345-1234", "country": "US", "email": "test@cybs.com" } } } ``` Response to a Successful Request ``` { "_links": { "authReversal": { "method": "POST", "href": "/pts/v2/payments/6823009451126309503954/reversals" }, "self": { "method": "GET", "href": "/pts/v2/payments/6823009451126309503954" }, "capture": { "method": "POST", "href": "/pts/v2/payments/6823009451126309503954/captures" } }, "clientReferenceInformation": { "code": "1682300945230" }, "id": "6823009451126309503954", "orderInformation": { "amountDetails": { "authorizedAmount": "500.00", "currency": "usd" } }, "paymentAccountInformation": { "card": { "type": "001" } }, "paymentInformation": { "tokenizedCard": { "type": "001" }, "card": { "type": "001" } }, "pointOfSaleInformation": { "terminalId": "111111" }, "processorInformation": { "approvalCode": "888888", "networkTransactionId": "123456789619999", "transactionId": "123456789619999", "responseCode": "100", "avs": { "code": "X", "codeRaw": "I1" } }, "reconciliationId": "67720603YGMSE5JE", "status": "AUTHORIZED", "submitTimeUtc": "2023-04-24T01:49:05Z" } ``` Captures for Ticket Purchases {#airline-ctv-capture-intro} ========================================================== This section describes how to capture an airline payment for ticket purchases. Captures for ticket purchases must be made separately from captures for ancillary purchases. For more information about how to capture an ancillary purchase, see [Captures for Ancillary Purchases](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ctv-intro/airline-ctv-capture-anc-intro.md ""). Travel Legs ----------- You can use travel leg fields for trips that have multiple legs. For more information on how to use travel leg fields, see [Airline Data](/docs/cybs/en-us/airline/developer/all/rest/airline/payments-processing-airline-intro.md ""). Leg Limitations {#airline-ctv-capture-intro_leg-limit-capture} -------------------------------------------------------------- `Visa Platform Connect` limits the maximum number of legs for each trip based on card type. This table describes the maximum number of legs for each trip based on card type. | Supported Card Types | Maximum Number of Trip Legs | |----------------------|-----------------------------| | American Express | 4 | | Discover | 4 | | Mastercard | 4 | | Visa | 4 | [`Visa Platform Connect` Leg Limitations] Endpoint {#airline-ctv-capture-intro_d14e147} --------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments/`*{id}*`/captures`{#airline-ctv-capture-intro_d14e156} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments/`*{id}*`/captures`{#airline-ctv-capture-intro_d14e169} The *{id}* is the transaction ID returned in the authorization response. Required Fields for Capturing an Airline Payment {#airline-ctv-capture-req-fields} ================================================================================== Include these required fields to capture an airline payment for ticket purchases. [orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : [processingInformation.industryDataType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-industry-data-type.md "") : Set the value to `airline`. Card-Specific Field to Capture an Airline Payment {#airline-ctv-capture-card-fields} ==================================================================================== This section includes card-specific information. Mastercard ---------- Use this card-specific field in addition to the required fields when capturing an authorization with a Mastercard. [travelInformation.transit.airline.ticketIssuer.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ticket-issuer-code.md "") : Optional Fields for Capturing an Airline Payment {#airline-ctv-capture-opt-fields} ================================================================================== You can use these optional fields to include additional information when capturing an airline payment. [orderInformation.amountDetails.taxAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-tax-amount.md "") : [orderInformation.amountDetails.taxDetails\[\].amount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-tax-details-amount.md "") : [orderInformation.lineItems\[\].taxDetails\[\].code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-tax-details-code.md "") : [orderInformation.lineItems\[\].totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-line-items-total-amount.md "") : [travelInformation.agency.code](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-agency-code.md "") : [travelInformation.agency.name](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-agency-name.md "") : [travelInformation.transit.airline.customerCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-cust-code.md "") : [travelInformation.transit.airline.documentType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-doc-type.md "") : For a list of possible values, see [Airline Document Type Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-doc-codes.md ""). [travelInformation.transit.airline.exchangeTicketFeeAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-exchange-ticket-fee-amt.md "") : [travelInformation.transit.airline.legs\[\].conjunctionTicket](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-conjunction-ticke.md "") : [travelInformation.transit.airline.legs\[\].couponNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-coupon-num.md "") : [travelInformation.transit.airline.legs\[\].endorsementsRestrictions](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-endorse-restrict.md "") : [travelInformation.transit.airline.legs\[\].exchangeTicketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-ex-ticket-num.md "") : [travelInformation.transit.airline.legs\[\].fareBasis](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-fare-basis.md "") : [travelInformation.transit.airline.legs\[\].feeAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-fee-amount.md "") : [travelInformation.transit.airline.legs\[\].stopoverIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-stop-over-indicat.md "") : [travelInformation.transit.airline.legs\[\].taxAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-legs-tax-amount.md "") : [travelInformation.transit.airline.planNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-plan-number.md "") : [travelInformation.transit.airline.ticketChangeIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ticket-change-ind.md "") : [travelInformation.transit.airline.ticketIssueDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ticket-issue-date.md "") : [travelInformation.transit.airline.totalFeeAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-total-fee-amount.md "") : [travelInformation.transit\[\].exchangeTicketAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-exchange-ticket-amt.md "") : {#airline-ctv-capture-opt-fields_dl_bxz_p11_gxb} Related Information {#airline-ctv-capture-opt-fields_section_a54_trz_sxb} ------------------------------------------------------------------------- * [API field reference guide for the REST API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/rest-api-fields-intro.md "") {#airline-ctv-capture-opt-fields_ul_b54_trz_sxb} Example: Capturing an Airline Payment {#airline-ctv-capture-ex-rest} ==================================================================== Use this example as a reference for capturing an airline payment. Request ``` { "clientReferenceInformation": { "code": "TC50171_3" }, "processingInformation": { "industryDataType": "airline" }, "orderInformation": { "amountDetails": { "totalAmount": "500.00", "currency": "USD" } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/captures/6823025890736075903954/voids" }, "self": { "method": "GET", "href": "/pts/v2/captures/6823025890736075903954" } }, "clientReferenceInformation": { "code": "TC50171_3" }, "id": "6823025890736075903954", "orderInformation": { "amountDetails": { "totalAmount": "500.00", "currency": "USD" } }, "reconciliationId": "67720603YGMSE5JE", "status": "PENDING", "submitTimeUtc": "2023-04-24T02:16:29Z" } ``` Captures for Ancillary Purchases {#airline-ctv-capture-anc-intro} ================================================================= This section describes how to capture an airline payment for ancillary purchases. Ancillary purchases are any additional services, such as baggage, meals, and paid seats, that your customers can purchase. Captures for ancillary purchases must be made separately from captures for ticket purchases. Endpoint {#airline-ctv-capture-anc-intro_d14e147} ------------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments/`*{id}*`/captures`{#airline-ctv-capture-anc-intro_d14e156} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments/`*{id}*`/captures`{#airline-ctv-capture-anc-intro_d14e169} The *{id}* is the transaction ID returned in the authorization response. Required Fields for Capturing an Authorization for Ancillary Purchases {#airline-ctv-capture-anc-req-fields} ============================================================================================================ Include these required fields to capture an airline payment for ancillary purchases. [orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : [processingInformation.industryDataType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/processing-info-aa/processing-info-industry-data-type.md "") : Set the value to `airline`. Related Information {#airline-ctv-capture-anc-req-fields_section_cwr_3tz_sxb} ----------------------------------------------------------------------------- * [API field reference guide for the REST API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/rest-api-fields-intro.md "") {#airline-ctv-capture-anc-req-fields_ul_dwr_3tz_sxb} Ancillary Fields for Capturing an Authorization for an Ancillary Purchase {#airline-ctv-capture-anc-opt-fields} =============================================================================================================== Choose from these optional ancillary fields to add additional information when capturing an ancillary purchase. [travelInformation.transit.airline.ancillaryInformation.connectedTicketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-connected-.md "") : [travelInformation.transit.airline.ancillaryInformation.creditReasonIndicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-credit-rea.md "") : [travelInformation.transit.airline.ancillaryInformation.passengerName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-passenger-.md "") : [travelInformation.transit.airline.ancillaryInformation.service\[\].categoryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-ca.md "") : For a list of possible values, see [Ancillary Service Category Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-anc-codes.md ""). [travelInformation.transit.airline.ancillaryInformation.service\[\].subCategoryCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-service-su.md "") : [travelInformation.transit.airline.ancillaryInformation.ticketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/travel-info-aa/travel-info-transit-airline-ancill-info-ticket-num.md "") : {#airline-ctv-capture-anc-opt-fields_dl_v3y_hvd_gxb} REST Example: Capturing an Authorization for an Ancillary Purchase {#airline-ctv-capture-anc-ex-rest} ===================================================================================================== Use this example as a reference for capturing an ancillary purchase with the ancillary fields. Request ``` { "clientReferenceInformation": { "code": "TC50171_3" }, "processingInformation": { "industryDataType": "airline" }, "orderInformation": { "amountDetails": { "totalAmount": "500.00", "currency": "USD" } }, "travelInformation": { "transit": { "airline": { "ancillaryInformation": { "ticketNumber": "123456789123456", "passengerName": "John Doe", "connectedTicketNumber": "654321987654321" } } } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/captures/6823030661646093703954/voids" }, "self": { "method": "GET", "href": "/pts/v2/captures/6823030661646093703954" } }, "clientReferenceInformation": { "code": "TC50171_3" }, "id": "6823030661646093703954", "orderInformation": { "amountDetails": { "totalAmount": "500.00", "currency": "USD" } }, "reconciliationId": "67221841NGMV8WOT", "status": "PENDING", "submitTimeUtc": "2023-04-24T02:24:26Z" } ``` Refunds {#airline-ctv-credit-intro} =================================== This topic describes how to process an airline refund. This service returns the funds used in the initial capture and requires the original capture ID. Endpoint {#airline-ctv-credit-intro_d14e219} -------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/payments/`*{id}*`/refunds`{#airline-ctv-credit-intro_d14e227} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/payments/`*{id}*`/refunds`{#airline-ctv-credit-intro_d14e240} The *{id}* is the transaction ID returned in the capture or sale response. Required Fields for Processing an Airline Refund {#airline-ctv-credit-req-fields} ================================================================================= Include these required fields to process an airline refund. [orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : Related Information {#airline-ctv-credit-req-fields_section_phk_p5z_sxb} ------------------------------------------------------------------------ * [API field reference guide for the REST API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/rest-api-fields-intro.md "") {#airline-ctv-credit-req-fields_ul_qhk_p5z_sxb} Optional Fields for Processing an Airline Refund {#airline-ctv-credit-opt-fields} ================================================================================= This section includes these types of optional fields for an airline refund: * [General Optional Fields](#airline-ctv-credit-opt-fields_general "") * [Optional Fields for Ticket Purchases](#airline-ctv-credit-opt-fields_ticket "") * [Optional Fields for Ancillary Purchases](#airline-ctv-credit-opt-fields_ancillary "") {#airline-ctv-credit-opt-fields_ul_ijj_smv_2xb} General Optional Fields {#airline-ctv-credit-opt-fields_general} ---------------------------------------------------------------- You can use these optional fields to include additional information in any airline purchase. travelInformation.agency.code : travelInformation.agency.name : travelInformation.transit.airline.arrivalDate : travelInformation.transit.airline.carrierName : travelInformation.transit.airline.clearingCount : travelInformation.transit.airline.clearingSequence : travelInformation.transit.airline.creditReasonIndicator : travelInformation.transit.airline.customerCode : travelInformation.transit.airline.documentType : For a list of possible values, see [Airline Document Type Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-doc-codes.md ""). travelInformation.transit.airline.electronicTicketIndicator : travelInformation.transit.airline.exchangeTicketFeeAmount : travelInformation.transit.airline.numberOfPassengers : travelInformation.transit.airline.passengerName : travelInformation.transit.airline.planNumber : travelInformation.transit.airline.purchaseType : travelInformation.transit.airline.reservationSystemCode : travelInformation.transit.airline.restrictedTicketDesciption : travelInformation.transit.airline.restrictedTicketIndicator : travelInformation.transit.airline.ticketChangeIndicator : travelInformation.transit.airline.ticketIssueDate : travelInformation.transit.airline.ticketIssuer.externality : travelInformation.transit.airline.ticketNumber : travelInformation.transit.airline.totalClearingAmount : travelInformation.transit.airline.totalFeeAmount : travelInformation.transit\[\].exchangeTicketAmount : Airline Optional Fields for Ticket Purchases {#airline-ctv-credit-opt-fields_ticket} ------------------------------------------------------------------------------------ You can use these optional fields to include additional information when requesting an airline credit for a ticket purchase. travelInformation.transit.airline.legs\[\].arrivalTime : travelInformation.transit.airline.legs\[\].arrivalTimeMeridian : travelInformation.transit.airline.legs\[\].carrierCode : travelInformation.transit.airline.legs\[\].class : travelInformation.transit.airline.legs\[\].conjunctionTicket : travelInformation.transit.airline.legs\[\].couponNumber : travelInformation.transit.airline.legs\[\].departureDate : travelInformation.transit.airline.legs\[\].departureTime : travelInformation.transit.airline.legs\[\].departureTimeMeridian : travelInformation.transit.airline.legs\[\].destinationAirportCode : travelInformation.transit.airline.legs\[\].endorsementsRestrictions : travelInformation.transit.airline.legs\[\].exchangeTicketNumber : travelInformation.transit.airline.legs\[\].fareBasis : travelInformation.transit.airline.legs\[\].feeAmount : travelInformation.transit.airline.legs\[\].flightNumber : travelInformation.transit.airline.legs\[\].originatingAirportCode : travelInformation.transit.airline.legs\[\].stopoverIndicator : travelInformation.transit.airline.legs\[\].taxAmount : travelInformation.transit.airline.legs\[\].totalFareAmount : Ancillary Optional Fields {#airline-ctv-credit-opt-fields_ancillary} -------------------------------------------------------------------- You can use these optional fields to include additional information when requesting an airline credit for an ancillary purchase. travelInformation.transit.airline.ancillaryInformation.connectedTicketNumber : travelInformation.transit.airline.ancillaryInformation.creditReasonIndicator : travelInformation.transit.airline.ancillaryInformation.passengerName : travelInformation.transit.airline.ancillaryInformation.service\[\].categoryCode : For a list of possible values, see [Ancillary Service Category Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-anc-codes.md ""). travelInformation.transit.airline.ancillaryInformation.service\[\].subCategoryCode : travelInformation.transit.airline.ancillaryInformation.ticketNumber : Related Information {#airline-ctv-credit-opt-fields_section_mpc_r5z_sxb} ------------------------------------------------------------------------ * [API field reference guide for the REST API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/rest-api-fields-intro.md "") {#airline-ctv-credit-opt-fields_ul_npc_r5z_sxb} REST Example: Processing an Airline Refund {#airline-ctv-credit-ex-rest} ======================================================================== Use this example as a reference for processing an airline refund. Request ``` { "clientReferenceInformation": { "code": "TC50171_3" }, "processingInformation": { "industryDataType": "airline" }, "orderInformation": { "amountDetails": { "totalAmount": "500", "currency": "USD" } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/refunds/6823038625416445403955/voids" }, "self": { "method": "GET", "href": "/pts/v2/refunds/6823038625416445403955" } }, "clientReferenceInformation": { "code": "TC50171_3" }, "id": "6823038625416445403955", "orderInformation": { "amountDetails": { "currency": "USD" } }, "processorInformation": { "approvalCode": "888888", "responseCode": "100" }, "reconciliationId": "67722608EGMV6Q7V", "refundAmountDetails": { "currency": "USD", "refundAmount": "500.00" }, "status": "PENDING", "submitTimeUtc": "2023-04-24T02:37:42Z" } ``` Issue a Credit {#airline-ctv-credit-sa-intro} ============================================= This topic describes how to process an airline credit. This service distributes funds without requiring a capture ID. > IMPORTANT All fields used in the original transaction must be included in your request. Endpoint {#airline-ctv-credit-sa-intro_d14e189} ----------------------------------------------- **Production:** `POST ``https://api.cybersource.com``/pts/v2/credits/`{#airline-ctv-credit-sa-intro_d14e198} **Test:** `POST ``https://apitest.cybersource.com``/pts/v2/credits/`{#airline-ctv-credit-sa-intro_d14e208} Required Fields for Processing an Airline Credit {#airline-ctv-credit-sa-req-fields} ==================================================================================== Include these required fields to process an airline credit. > IMPORTANT > When relaxed requirements for address data and the expiration date are being used, not all fields in this list are required. It is your responsibility to determine whether your account is enabled to use this feature and which fields are required. For details about relaxed requirements, see [Relaxed Requirements for Address Data and Expiration Date in Payment Transactions](/docs/cybs/en-us/airline/developer/all/rest/airline/payments-relax-reqs.md ""). [orderInformation.amountDetails.currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-currency.md "") : [orderInformation.amountDetails.totalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-amount-details-total-amount.md "") : [orderInformation.billTo.address1](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-address1.md "") : [orderInformation.billTo.administrativeArea](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-admin-area.md "") : [orderInformation.billTo.country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-company-country.md "") : [orderInformation.billTo.email](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-email.md "") : [orderInformation.billTo.firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-first-name.md "") : [orderInformation.billTo.lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-last-name.md "") : [orderInformation.billTo.externality](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-externality.md "") : [orderInformation.billTo.postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/order-info-aa/order-info-bill-to-postal-code.md "") : [paymentInformation.card.expirationMonth](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-exp-mo.md "") : [paymentInformation.card.expirationYear](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-exp-year.md "") : [paymentInformation.card.number](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/payment-info-aa/payment-info-card-number.md "") : Optional Fields for Processing an Airline Credit {#airline-ctv-credit-sa-opt-fields} ==================================================================================== This section includes these types of optional fields for an airline credit: * [General Optional Fields](#airline-ctv-credit-sa-opt-fields_general "") * [Optional Fields for Ticket Purchases](#airline-ctv-credit-sa-opt-fields_ticket "") * [Optional Fields for Ancillary Purchases](#airline-ctv-credit-sa-opt-fields_ancillary "") {#airline-ctv-credit-sa-opt-fields_ul_ijj_smv_2xb} General Optional Fields {#airline-ctv-credit-sa-opt-fields_general} ------------------------------------------------------------------- You can use these optional fields to include additional information in any airline purchase. travelInformation.agency.code : travelInformation.agency.name : travelInformation.transit.airline.arrivalDate : travelInformation.transit.airline.carrierName : travelInformation.transit.airline.clearingCount : travelInformation.transit.airline.clearingSequence : travelInformation.transit.airline.creditReasonIndicator : travelInformation.transit.airline.customerCode : travelInformation.transit.airline.documentType : For a list of possible values, see [Airline Document Type Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-doc-codes.md ""). travelInformation.transit.airline.electronicTicketIndicator : travelInformation.transit.airline.exchangeTicketFeeAmount : travelInformation.transit.airline.numberOfPassengers : travelInformation.transit.airline.passengerName : travelInformation.transit.airline.planNumber : travelInformation.transit.airline.purchaseType : travelInformation.transit.airline.reservationSystemCode : travelInformation.transit.airline.restrictedTicketDesciption : travelInformation.transit.airline.restrictedTicketIndicator : travelInformation.transit.airline.ticketChangeIndicator : travelInformation.transit.airline.ticketIssueDate : travelInformation.transit.airline.ticketIssuer.externality : travelInformation.transit.airline.ticketNumber : travelInformation.transit.airline.totalClearingAmount : travelInformation.transit.airline.totalFeeAmount : travelInformation.transit\[\].exchangeTicketAmount : Airline Optional Fields for Ticket Purchases {#airline-ctv-credit-sa-opt-fields_ticket} --------------------------------------------------------------------------------------- You can use these optional fields to include additional information when requesting an airline credit for a ticket purchase. travelInformation.transit.airline.legs\[\].arrivalTime : travelInformation.transit.airline.legs\[\].arrivalTimeMeridian : travelInformation.transit.airline.legs\[\].carrierCode : travelInformation.transit.airline.legs\[\].class : travelInformation.transit.airline.legs\[\].conjunctionTicket : travelInformation.transit.airline.legs\[\].couponNumber : travelInformation.transit.airline.legs\[\].departureDate : travelInformation.transit.airline.legs\[\].departureTime : travelInformation.transit.airline.legs\[\].departureTimeMeridian : travelInformation.transit.airline.legs\[\].destinationAirportCode : travelInformation.transit.airline.legs\[\].endorsementsRestrictions : travelInformation.transit.airline.legs\[\].exchangeTicketNumber : travelInformation.transit.airline.legs\[\].fareBasis : travelInformation.transit.airline.legs\[\].feeAmount : travelInformation.transit.airline.legs\[\].flightNumber : travelInformation.transit.airline.legs\[\].originatingAirportCode : travelInformation.transit.airline.legs\[\].stopoverIndicator : travelInformation.transit.airline.legs\[\].taxAmount : travelInformation.transit.airline.legs\[\].totalFareAmount : Ancillary Optional Fields {#airline-ctv-credit-sa-opt-fields_ancillary} ----------------------------------------------------------------------- You can use these optional fields to include additional information when requesting an airline credit for an ancillary purchase. travelInformation.transit.airline.ancillaryInformation.connectedTicketNumber : travelInformation.transit.airline.ancillaryInformation.creditReasonIndicator : travelInformation.transit.airline.ancillaryInformation.passengerName : travelInformation.transit.airline.ancillaryInformation.service\[\].categoryCode : For a list of possible values, see [Ancillary Service Category Codes](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro/airline-ref-anc-codes.md ""). travelInformation.transit.airline.ancillaryInformation.service\[\].subCategoryCode : travelInformation.transit.airline.ancillaryInformation.ticketNumber : REST Example: Processing an Airline Credit {#airline-ctv-credit-sa-ex-rest} =========================================================================== Request ``` { "paymentInformation": { "card": { "number": "4111111111111111", "expirationMonth": "12", "expirationYear": "31" } }, "orderInformation": { "amountDetails": { "totalAmount": "500.00", "currency": "USD" }, "billTo": { "firstName": "John", "lastName": "Doe", "address1": "123 Happy St.", "externality": "Sunnyville", "administrativeArea": "CA", "postalCode": "12345", "country": "US", "email": "johndoe@test.com" } } } ``` Response to a Successful Request ``` { "_links": { "void": { "method": "POST", "href": "/pts/v2/credits/6823065885666134104951/voids" }, "self": { "method": "GET", "href": "/pts/v2/credits/6823065885666134104951" } }, "clientReferenceInformation": { "code": "1682306588644" }, "creditAmountDetails": { "currency": "USD", "creditAmount": "500.00" }, "id": "6823065885666134104951", "orderInformation": { "amountDetails": { "currency": "USD" } }, "paymentAccountInformation": { "card": { "type": "001" } }, "paymentInformation": { "tokenizedCard": { "type": "001" }, "card": { "type": "001" } }, "processorInformation": { "approvalCode": "888888", "responseCode": "100" }, "reconciliationId": "74259417PGM9TXHT", "status": "PENDING", "submitTimeUtc": "2023-04-24T03:23:08Z" } ``` Airline Data Reference Information {#airline-ref-intro} ======================================================= This section contains reference information that is useful when using Airline Data. Airline Document Type Codes {#airline-ref-doc-codes} ==================================================== To indicate the purpose of a purchase, set the travelInformation.transit.airline.documentType field to a value listed in the Code column. | Code | Description | |:-----|:-----------------------------------------------------------------| | 01 | Passenger ticket | | 02 | Additional collection | | 03 | Excess baggage | | 04 | Miscellaneous charge order (MCO) or prepaid ticket authorization | | 05 | Special service ticket | | 06 | Supported refund | | 07 | Unsupported refund | | 08 | Lost ticket application | | 09 | Tour order voucher | | 10 | Ticket by mail | | 11 | Undercharge adjustment | | 12 | Group ticket | | 13 | Exchange adjustment | | 14 | SPD or air freight | | 15 | In-flight adjustment | | 16 | Agency passenger ticket | | 17 | Agency tour order or voucher | | 18 | Agency miscellaneous charge order (MCO) | | 19 | Agency exchange order | | 20 | Agency group ticket | | 21 | Debit adjustment for duplicate refund or use | | 22 | In-flight merchandise order | | 23 | Catalogue merchandise order | | 24 | In-flight phone charges | | 25 | Frequent flyer fee or purchase | | 26 | Kennel charge | | 27 | Animal transportation charge | | 28 | Firearms case | | 29 | Upgrade charge | | 30 | Credit for unused transportation | | 31 | Credit for class of service adjustment | | 32 | Credit for denied boarding | | 33 | Credit for miscellaneous refund | | 34 | Credit for lost ticket refund | | 35 | Credit for exchange refund | | 36 | Credit for overcharge adjustment | | 37 | Credit for multiple Unused tickets | | 38 | Exchange order | | 39 | Self-service ticket | | 41 | In-flight duty-free purchase | | 42 | Senior citizen discount booklets | | 43 | Club membership fee | | 44 | Coupon book | | 45 | In-flight charges | | 46 | Tour deposit | | 47 | Frequent flyer overnight delivery charge | | 48 | Frequent flyer fulfillment | | 49 | Small package delivery | | 50 | Vendor sale | | 51 | Miscellaneous taxes or fees | | 52 | Travel agency fee | | 60 | Vendor refund or credit | | 64 | Duty free sale | | 65 | Preferred seat upgrade | | 66 | Cabin upgrade | | 67 | Lounge or club access or day pass | | 68 | Agent assisted reservation or ticketing fee | | 69 | Ticket change or cancel fee | | 70 | Trip insurance | | 71 | Unaccompanied minor | | 72 | Standby fee | | 73 | Curbside baggage | | 74 | In-flight medical equipment | | 75 | Ticket or pass print fee | | 76 | Checked sporting or special equipment | | 77 | Dry ice fee | | 78 | Mail or postage fee | | 79 | Club membership fee or temporary trial | | 80 | Frequent flyer activation or reinstatement | | 81 | Gift certificate | | 82 | Onboard or in-flight prepaid voucher | | 83 | Optional services fee | | 84 | Advance purchase for excess baggage | | 85 | Advance purchase for preferred seat upgrade | | 86 | Advance purchase for cabin upgrade | | 87 | Advance purchase for optional services | | 88 | Wi-Fi | | 89 | Packages | | 90 | In-flight entertainment or internet access | | 91 | Overweight bag fee | | 92 | Sleep sets | | 93 | Special purchase fee | [Airline Document Type Codes] Ancillary Service Category Codes {#airline-ref-anc-codes} ========================================================= To indicate the service provided in an ancillary purchase, set the travelInformation.transit.airline.ancillaryInformation.service\[\].categoryCode and travelInformation.transit.airline.ancillaryInformation.service\[\].subCategoryCode fields to a value listed in the Ancillary Service Category Code column. | Ancillary Service Category Codes | Description | |:--------------------------------:|:------------------------| | `BF` | Bundled service | | `BG` | Baggage fee | | `CF` | Change fee | | `CG` | Cargo | | `CO` | Carbon offset | | `FF` | Frequent flyer | | `GF` | Gift card | | `GT` | Ground transport | | `IE` | In-flight entertainment | | `LG` | Lounge | | `MD` | Medical | | `ML` | Meal or beverage | | `OT` | Other | | `PA` | Passenger assist fee | | `PT` | Pets | | `SA` | Seat fees | | `SB` | Standby | | `SF` | Service fee | | `ST` | Store | | `TS` | Travel service | | `UN` | Unaccompanied travel | | `UP` | Upgrades | | `WI` | Wi-Fi | [Ancillary Service Category Codes] Airline Data {#payments-processing-airline-intro} ================================================= Airline data processing goes beyond basic payment transactions by allowing you to process specific travel data. This requires you to submit additional information, such as: * Carrier * Departure Date * Destination Airport * Purchase Date * Originating Airport * Ticket Class * Trip Legs {#payments-processing-airline-intro_ul_x5d_bnt_nwb} Supported Processor {#payments-processing-airline-intro_section_rrr_24l_5xb} ---------------------------------------------------------------------------- * [Airline Data Processing](/docs/cybs/en-us/airline/developer/all/rest/airline/payments-airline-intro.md "") {#payments-processing-airline-intro_ul_jfd_d4l_5xb} Requirement {#payments-processing-airline-intro_airline-process-prereq-section} ------------------------------------------------------------------------------- When you are ready to go live with airline data processing, contact `Cybersource` Customer Support to have your account configured to process airline data. If your account is not enabled, and you try to send airline transactions, you will receive an error for invalid data. Related Information {#payments-processing-airline-intro_section_dmg_nnr_5xb} ---------------------------------------------------------------------------- * See [Airline Data Processing](/docs/cybs/en-us/airline/developer/all/rest/airline/payments-airline-intro.md "") for information that shows you how to process payments that include airline data. {#payments-processing-airline-intro_ul_qgs_nnr_5xb} Relaxed Requirements for Address Data and Expiration Date in Payment Transactions {#payments-relax-reqs} ======================================================================================================== With relaxed requirements for address data and the expiration date, not all standard payment request fields are required. It is your responsibility to determine whether your account is enabled to use this feature and which fields are required. Airline Data Processing {#payments-airline-intro} ================================================= This section describes how to process airline payments. Requirement {#payments-airline-intro_section_epm_fmr_5xb} --------------------------------------------------------- When you are ready to go live with airline data processing, contact `Cybersource` Customer Support to have your account configured to process airline data. If your account is not enabled, and you try to send airline transactions, you will receive an error for invalid data. Related Information {#payments-airline-intro_section_dmg_nnr_5xb} ----------------------------------------------------------------- * See [Airline Data](/docs/cybs/en-us/airline/developer/all/rest/airline/payments-processing-airline-intro.md "") for information about and requirements for processing payments that include airline data. * See [Airline Data Reference Information](/docs/cybs/en-us/airline/developer/all/rest/airline/airline-ref-intro.md "") for a list and description of the different document type and ancillary service category codes that are used when processing payments that include airline data. {#payments-airline-intro_ul_qgs_nnr_5xb}