On This Page
Capture an Airline Payment
This section describes how to capture an airline payment.
Leg Limitations
TSYS Acquiring Solutions
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
#
character in the field name with a sequential number starting with
0
. For example, for a trip with two legs, set the airlineData_leg_#
field
as airlineData_leg_0
and
airlineData_leg_1
, 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 | Maxiumum Number of Travel Legs |
|---|---|
American Express | 9 |
Visa | 4 |
Document Type
When capturing an airline payment, you must use the
airlineData_documentType
field to specify the purpose of the transaction. For all possible values, see Airline Document Type Codes. Multiple Captures
TSYS Acquiring Solutions
allows you to request multiple partial captures for one
authorization when using the Visa card type. You must ensure that the total amount
for all captures does not exceed the authorized amount. For a list of the fields
required for multiple captures, see Multiple Capture Fields for an Airline Payment.Endpoint
Set the
ccCaptureService_run
field to
true
.Send the request to
https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
.Required Fields for an Airline Capture
Include these required fields to capture an airline payment.
- Set the value to themerchant_ref_numbervalue used in corresponding authorization request.
- Verosupports Brazilian real (BRL) currency only.
- Set the value toairline.
- Replace the#character with the number0for the first leg and consecutive numbers for any additional legs.
- Replace the#character with the number0for the first leg and consecutive numbers for any additional legs.
- Replace the#character with the number0for the first leg and consecutive numbers for any additional legs.
- Replace the#character with the number0for the first leg and consecutive numbers for any additional legs.
- Replace the#character with the number0for the first leg and consecutive numbers for any additional legs.
Multiple Capture Fields for an Airline Payment
Include these fields in addition to the required fields when you are requesting multiple
partial captures for a single airline payment.
Optional Fields for an Airline Capture
Choose from these optional fields to include additional information when capturing an
airline payment.
For ancillary fields, see Airline Ancillary Fields.
Simple Order Example: Airline Ticket Capture
Request
<requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.11"> <merchantID>test-merchant</merchantID> <merchantReferenceCode>R98TV09EN200W</merchantReferenceCode> <purchaseTotals> <currency>USD</currency> <grandTotalAmount>204.78</grandTotalAmount> </purchaseTotals> <ccCaptureService run="true"> <authRequestID>0839543530000172034078</authRequestID> <industryDatatype>airline</industryDatatype> </ccCaptureService> <airlineData> <agentCode>98222147<agentCode> <agentName>Regent Travel</agentName> <ticketNumber>1234567890123450</ticketNumber> <passengerName>John Smith</passengerName> <leg id="0"> <carrierCode>VS</carrierCode> <originatingAirportCode>GLA</originatingAirportCode> <class>C</class> <departureDate>080812</departureDate> <destination>LGW</destination> </leg> </airlineData> </requestMessage>
Response
<replyMessage xmlns:c="urn:schemas-cybersource-com:transaction-data-1.124"> <requestID>0305782650000167905080</requestID> <decision>ACCEPT</decision> <reasonCode>100</reasonCode> <merchantReferenceCode>R98TV09EN200W</merchantReferenceCode> <purchaseTotals><currency>USD</currency></purchaseTotals> <ccCaptureReply> <reasonCode>100</reasonCode> <amount>204.78</amount> <reconciliationID>1094820975023470</reconciliationID> <enhancedDataEnabled>y</enhancedDataEnabled> </ccCaptureReply> </replyMessage>