On This Page
Capture an Airline Payment
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 theidfield. The request ID is required in the capture request. For more information about how to send an authorization request, see the Standard Payment Processing section in thePayments Developer Guide.
Leg Limitations
Elavon
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 Travel Legs |
|---|---|
Diners Club | 4 |
Discover | 4 |
JCB Card | 4 |
Mastercard | 4 |
Visa | 4 |
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. Endpoint
Production:
POST
https://api.cybersource.com
/pts/v2/payments/{id}
/capturesTest:
POST
https://apitest.cybersource.com
/pts/v2/payments/{id}
/capturesThe is the transaction ID
returned in the authorization response.
{id}
Required Fields for an Airline Capture
- Set the value toairline.
Required Fields for an Ancillary Purchase
Include these fields, in addition to the above fields, if there is an ancillary
purchase:
- Include one of the possible values listed in the Ancillary Service Category Codes section.
- To send multiple category codes, you must include additional entries of this field in the array.
Card-Specific Field for an Airline Capture
Card-Specific Field for an Airline Capture
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.
Optional Fields for an Airline Capture
- For a list of all possible values, see Ancillary Service Category Codes.
- For a list of all possible values, see Ancillary Service Category Codes.
REST Example: Airline Ticket Capture
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" }
REST Example: Ancillary Capture
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" }