TSYS Acquiring Solutions Airline Processing
TSYS Acquiring Solutions
Airline ProcessingThis section describes the airline payment services you can use when processing with
TSYS Acquiring Solutions
.Cybersource
sends airline data for Mastercard and
Discover to TSYS Acquiring Solutions
, but TSYS Acquiring Solutions
removes the
airline data for these card types when sending the settlement information. Only
American Express and Visa transactions qualify for the airline interchange
rate.Supported Card Types
This table describes the card types that
TSYS Acquiring Solutions
supports.Supported Card Types |
---|
American Express |
Visa |
Authorizations
This sections describes how to process a successful
TSYS Acquiring Solutions
authorization.Endpoint
Set the
ccAuthService_run
field to
true
.Send the request to
https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
.Required Fields for an Airline Authorization
Include these required fields for processing an airline authorization.
- Set this field totrue.
- airlineData_numberOfPassengers
- airlineData_ticketNumber
- Set toairline.
Simple Order API Example: Capturing an Authorization
Simple Order API
Example: Capturing an AuthorizationUse this example as a reference for capturing an authorization.
Request
Response
Captures
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 Trip 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 Capturing an Airline Payment
Include these required fields to capture an airline payment.
- Set to themerchant_ref_numbervalue used in corresponding authorization request.
- airlineData_ticketNumber
- Set 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.
- airlineData_clearingCount
- airlineData_clearingSequence
Optional Fields for Capturing an Airline Payment
Choose from these optional fields to include additional information when capturing an
airline payment.
Simple Order API Example: Capturing an Airline Payment
Simple Order API
Example: Capturing an Airline PaymentUse this example as a reference for capturing an airline payment.
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>
Stand-Alone Credits
Stand-Alone Credits
This topic describes how to process an airline
stand-alone credit
.All fields used in the original transaction must be included in your
request.
Endpoint
Set the
ccCreditService_run
field to
true
.Send the request to
https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
.Required Fields for Airline Stand
Alone Credits
Stand
Alone Credits
Include these required fields to request an airline
stand-alone credit
.- set totrue. For exampleccCreditService run="true".
- Set to themerchant_ref_numbervalue used in corresponding capture request.
- airlineData_ticketNumber
- Set 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.