On This Page {#jumplink-list} [Markdown](/docs/cybs/en-us/airline/developer/all/so/airline/airline-uatp-intro/airline-uatp-capture-intro.md) Filter FILTER BY TAG Capture an Airline Ticket Payment {#airline-uatp-capture-intro} =============================================================== This topic describes how to capture an airline payment. Before you can capture payment, you must authorize the funds by sending an authorization request. The authorization response includes a request ID in the requestID 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-uatp-capture-intro_leg-limit-capture} --------------------------------------------------------------- `UATP` 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 | |----------------------|------------------------------| | UATP | 4 | [`UATP` Leg Limitations] 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](/docs/cybs/en-us/airline/developer/all/so/airline/airline-ref-intro/airline-ref-doc-codes.md ""). Invoice Date ------------ `Cybersource` creates an invoice number (INVN) for `UATP` transactions. You can set the invoice date by inputting it in the value of the optional airlineData_invoiceDate field. If you do not use the invoice date field in your request, `Cybersource` uses the date the batch file was generated. This table describes the different values of the fourteen-digit invoice number. | Three characters | Two characters | Three characters | Four characters | Two characters | |------------------|---------------------------|--------------------------------|--------------------------------------------------------|----------------| | Airline code | Year Example: 06 for 2006 | Day Example: 000 for January 1 | Acquirer: the left-most Four digits of the card number | Spaces | [Invoice Number] Ticket Document Number ---------------------- You must include a valid ticket document number in one of these fields: * airlineData_ticketNumber: Set the value to the ticket number, which can be up to 12 digits. `Cybersource` will append this value with your 3-digit IATA merchant code to send a 15-digit ticket document number to `UATP`. * ccCaptureService_reconciliationID: Set this value to your 3-digit IATA merchant code followed by the ticket number, which can be up to 12 digits, for a total of 15 digits. If you include both fields in the request, and you use the reconciliation ID for your own reconciliation rather than the ticket document number, you must set the value for the airlineData_ticketNumber as described above and ensure that the first three digits of the reconciliation ID do not include your IATA code. Endpoint {#airline-uatp-capture-intro_d9e88} -------------------------------------------- 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 {#airline-uatp-capture-req-fields} ========================================================================= [airlineData_passengerName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/airline-data-passenger-name.md "") : [airlineData_ticketNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/airline-data-ticket-number.md "") : See the service description for the value and usage requirements. [ccCaptureService_authRequestID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/cc-capture-service-auth-request-id.md "") : [ccCaptureService_reconciliationID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/cc-capture-service-reconciliation-id.md "") : See the service description for the value and usage requirements. [ccCaptureService_run](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/cc-capture-service-run.md "") : [merchantID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/merchant-id.md "") : [merchantReferenceCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/merchant-reference-code.md "") : Set the value to the `merchant_ref_number` value used in corresponding authorization request. [purchaseTotals_currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/purchase-totals-currency.md "") : [purchaseTotals_grandTotalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/purchase-totals-grand-total-amount.md "") : {#airline-uatp-capture-req-fields_dl_k33_xwj_g3c} Optional Fields for an Airline Capture {#airline-uatp-capture-opt-fields} ========================================================================= Choose from these optional fields to include additional information when capturing an airline payment. airlineData_invoiceDate : [airlineData_leg_#_carrierCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/airline-data-leg-num-carrier-code.md "") : [airlineData_leg_#_departureDate](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/airline-data-leg-num-departure-date.md "") : [airlineData_leg_#_destination](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/airline-data-leg-num-destination.md "") : [airlineData_leg_#_fareBasis](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/airline-data-leg-num-fare-basis.md "") : [airlineData_leg_#_originatingAirportCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/airline-data-leg-num-orig-airport-code.md "") : [airlineData_leg_#_stopoverCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/airline-data-leg-num-stop-over-code.md "") : Simple Order Example: Airline Capture {#airline-uatp-capture-ex-so} =================================================================== Request ``` <requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.23">    <merchantID>okgo</merchantID>    <merchantReferenceCode>R98TV09EN200W</merchantReferenceCode>    <ccCaptureService run="true">       <authRequestID>0839543530000172034078</authRequestID>       <reconciliationID>98R33X7</reconciliationID>    </ccCaptureService>    <purchaseTotals>       <currency>USD</currency>       <grandTotalAmount>204.78</grandTotalAmount>    </purchaseTotals>    <airlineData>       <passengerName>Johnny Smith</passengerName>       <leg id="0">          <carrierCode>AA</carrierCode>          <departureDate>20061215</departureDate>          <originatingAirportCode>SJC</originatingAirportCode>          <destination>SEA</destination>       </leg>       <leg id="1">          <carrierCode>AA</carrierCode>          <destination>SJC</destination>       </leg>    </airlineData> </requestMessage> ``` Response ``` <c:replyMessage xmlns:c="urn:schemas-cybersource-com:transaction-data-1.23">    <c:requestID>0305782650000167905080</c:requestID>    <c:decision>ACCEPT</c:decision>    <c:reasonCode>100</c:reasonCode>    <c:merchantReferenceCode>R98TV09EN200W</c:merchantReferenceCode>    <c:purchaseTotals><c:currency>USD</c:currency></c:purchaseTotals>    <c:ccCaptureReply>       <c:reasonCode>100</c:reasonCode>       <c:amount>204.78</c:amount>       <c:reconciliationID>1094820975023470</c:reconciliationID>       <c:enhancedDataEnabled>y</c:enhancedDataEnabled>    </c:ccCaptureReply> </c:replyMessage> ``` RELATED TO THIS PAGE * [API Field Reference Guide](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/api-fields-so-intro.md) * [Business Center Test](https://businesscentertest.cybersource.com/ebc2/) * [Business Center Production](https://businesscenter.cybersource.com/ebc2/) * [Customer Support](https://support.visaacceptance.com/)