Request-Level Fields

The tables in this section describe the airline request fields to use with a capture or credit request.

When you send a capture or credit request with airline data, you must include the basic fields required for every capture or credit request. For information about the non-airline-data fields required for capture and credit requests, see Credit Card Services Using the SCMP API.

 

Table 32

General Request-Level Fields

CyberSource Field Name	Lloyds-OmniPay Field Name	Description	Required / Optional	Data Type & Length
airline_agent_code	Travel Agency Code	IATA1 code for the travel agency.	Optional	String (8)
airline_agent_name	Travel Agency Name	Name of the travel agency that is issuing the ticket. Note For Visa, if the number of characters exceeds 25, the value will be truncated.	Optional	Visa: String (25) Mastercard: String (30)
airline_carrier_name	Issuing Carrier	Name of the airline that is issuing the ticket.	Optional for Mastercard Not used for Visa	String (4)
airline_customer_code	Customer Code	Code provided by the cardholder.	Optional	String (17)
airline_passenger_name	Passenger Name	Name of the passenger to whom the ticket was issued. Do not include special characters such as commas, hyphens, or apostrophes. Only ASCII characters are supported. For Visa, the first character cannot be a space. Note For Visa, if the number of characters exceeds 20, the value will be truncated.	Required	Visa: String (20) Mastercard: String (29)
airline_restricted_ticket_indicator	Restricted Ticket Indicator	Flag that indicates whether or not the ticket is restricted (nonrefundable). Possible values: ■ 0 (default): No restriction (refundable) ■ 1: Restricted (nonrefundable)	Optional for Visa Not used for Mastercard	String (1)
airline_ticket_number	Ticket Number	Ticket number.	Required	String (15)
industry_datatype	No corresponding processor field	Flag that indicates that the transaction includes airline data. This field must be set to airline in order for airline data to be sent to the processor. Important If this field is not set to airline or is not included in the request, CyberSource does not send airline data to the processor.	Required	String (7)
1 IATA=International Air Transport Association

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.

Table 33

Request-Level Fields for Travel Legs

CyberSource Field Name	Lloyds-OmniPay Field Name	Description	Required / Optional	Data Type & Length
airline_leg#_carrier_code	Mastercard: Carrier Code Visa: Trip Leg n Carrier Code	IATA1 code for the carrier for this leg of the trip.	Required	String (2)
airline_leg#_class	Mastercard: Service Class Code Visa: Trip Leg n Service Class	IATA1 code for the class of service for this leg of the trip, such as coach or first class. Note For Visa, if there is more than one character, the value will be truncated.	Required	Visa: String (1) Mastercard: String (2)
airline_leg#_leg_departure_date	Mastercard: Travel Date Visa: Departure Date	Departure date for this leg of the trip. Format: YYYYMMDD. This date must be in the future.	Required	Integer (6)
airline_leg#_departure_time	Departure Time	Time of departure. The format is HHMM. If not all zeros, then the hours must be 00-23 and the minutes must be 00-59.	Optional for Mastercard Not used for Visa	Integer (4)
airline_leg#_departure_time_segment	Departure Time Segment	AM or PM for the departure time. Possible values: ■ A: 12:00 midnight to 11:59 a.m. ■ P: 12:00 noon to 11:59 p.m.	Optional for Mastercard Not used for Visa	String (1)
airline_leg#_destination	Mastercard: City of Destination/Airport Code Visa: Trip Leg n Destination City/Airport Code	IATA1 code for the destination airport for this leg of the trip. Note For Visa, if the number of characters exceeds 3, the value will be truncated.	Required	Visa: String (3) Mastercard: String (5)
airline_leg#_fare_basis	Mastercard: Fare Basis Code Visa: Trip Leg n - Fare Basis Code	Code for the fare basis for this leg of the trip. The fare basis is assigned by the carriers and indicates a particular ticket type, such as business class or discounted/nonrefundable. For Visa, this field may contain spaces. Note For Visa, if the number of characters exceeds 6, the value will be truncated.	Optional	Visa: String (6) Mastercard: String (15)
airline_leg#_flight_number	Mastercard: Flight Number Visa: Trip Leg n - Flight Number	Flight number for this leg of the trip. For Visa, this field may contain spaces.	Optional	String (5)
airline_leg#_originating_airport_code	Mastercard: City of Origin/Airport Code Visa: Origination City/Airport Code	IATA1 code for the originating airport for this leg of the trip. For Visa, the value for miscellaneous airline changes must be XAA.	Required	String (5)
airline_leg#_stopover_code	Mastercard: Stopover Code Visa: Trip Leg n Stopover Code	Code that indicates whether a stopover is allowed on this leg of the trip. Possible values: ■ O (capital letter “O”) (default): Stopover allowed ■ X (capital letter “X”): Stopover not allowed	Required	String (1)
1 IATA=International Air Transport Association