On This Page
FILTER BY TAG

Capture a Ticket Payment

This section describes how to capture an airline ticket payment, such as when a person is purchasing a ticket on your e-commerce store.

Capture Restrictions

For a ticket purchase with multiple passengers,
Cybersource
 recommends sending separate capture requests for each passenger. The original authorization may be a single request.
When ancillary purchases are made at the same time as the ticket purchase,
Cybersource
 recommends sending separate capture requests for the ticket and ancillary purchases.

Airline Travel Legs

FDC Nashville Global
 requires you to include travel leg fields in your requests, even for direct flights. For more information about how to format travel leg fields, see Airline Travel Legs.

Leg Limitations

FDC Nashville Global
 limits the maximum number of legs for each trip based on card type. This table describes the maximum number of legs for each trip based on processor and card type.
FDC Nashville Global
 Leg Limitations
Supported Card Types
Maximum Number of Trip Legs
American Express
4
Discover
4
Mastercard
99
Visa
4

Endpoint

Production:
POST
https://api.cybersource.com
/pts/v2/payments/
{id}
/captures
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments/
{id}
/captures
The
{id}
 is the transaction ID returned in the authorization response.

Card-Specific Fields for Capturing a Ticket Payment

This section includes card-specific information required to capture a payment for tickets.

Visa

Include this field in addition to the required fields when using a Visa card.
Set the value to
0
 for refundable.
Set the value to
1
 for nonrefundable.

Optional Fields for an Airline Capture

Choose from these optional fields to include additional information when capturing an airline payment for direct flight tickets.
travelInformation.transit.airline.clearingCount
travelInformation.transit.airline.clearingSequence
Set the value to
O
 (capital letter "O") to indicate the leg of a trip is allowed to stopover. Default value.
Set the value to
X
to indicate the leg of a trip is not allowed to stopover.
travelInformation.transit.airline.totalClearingAmount

REST
 Example: Capturing a Visa Airline Payment

Request
{
    "clientReferenceInformation": {
        "code": "RTS-Bill"
    },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "100.00",
            "currency": "USD"
        }
    },
    "processingInformation": {
        "industryDataType": "airline"
    },
    "travelInformation": {
        "agency": {
            "name": "Thomascook"
        },
        "transit": {
            "airline": {
                "passengerName": "John",
                "ticketNumber": "asd23",
                "customerCode": "LDTYOU789",
                "totalFeeAmount": "200",
                "planNumber": "49252",
                "exchangeTicketAmount": "11",
                "exchangeTicketFeeAmount": "1",
                "legs": [
                    {
                        "carrierCode": "AA",
                        "originatingAirportCode": "SFO",
                        "class": "1",
                        "stopoverIndicator": "O",
                        "departureDate": "20230202",
                        "destinationAirportCode": "NY",
                        "exchangeTicketNumber": "ticket12",
                        "endorsementsRestrictions": "Endorsement1234",
                        "feeAmount": "999.99",
                        "taxAmount": "99"
                    },
                    {
                        "carrierCode": "BB",
                        "originatingAirportCode": "NY",
                        "class": "2",
                        "stopoverIndicator": "O",
                        "departureDate": "20230202",
                        "destinationAirportCode": "SFO",
                        "exchangeTicketNumber": "ticket13",
                        "endorsementsRestrictions": "Endorsement1234",
                        "feeAmount": "999.99",
                        "taxAmount": "99"
                    }
                ]
            }
        }
    }
}
Response to a Successful Request
{
  "_links": {
    "void": {
      "method": "POST",
      "href": "/pts/v2/captures/6917768579016106103954/voids"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/captures/6917768579016106103954"
    }
  },
  "clientReferenceInformation": {
    "code": "RTS-Bill"
  },
  "id": "6917768579016106103954",
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "100.00",
      "currency": "USD"
    }
  },
  "reconciliationId": "682098706L5PQJ7Y",
  "status": "PENDING",
  "submitTimeUtc": "2023-08-11T18:00:58Z"
}
Request
{
    "clientReferenceInformation": {
        "code": "RTS-Bill"
    },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "100.00",
            "currency": "USD"
        }
    },
    "processingInformation": {
        "industryDataType": "airline"
    },
    "travelInformation": {
        "agency": {
            "name": "Thomascook",
            "code": "123"
        },
        "transit": {
            "airline": {
                "passengerName": "John",
                "ticketNumber": "asd23",
                "customerCode": "LDTYOU789",
                "totalFeeAmount": "200",
                "planNumber": "49252",
                "exchangeTicketAmount": "11",
                "exchangeTicketFeeAmount": "1",
                "ticketIssueDate": "20190202",
                "arrivalDate": "20230808",
                "ticketIssuer": {
                    "address": "Silicon Vally"
                },
                "legs": [
                    {
                        "carrierCode": "AA",
                        "flightNumber": "UA789",
                        "originatingAirportCode": "SFO",
                        "class": "1",
                        "stopoverIndicator": "O",
                        "departureDate": "20230202",
                        "destinationAirportCode": "NY",
                        "fareBasis": "B1",
                        "totalFareAmount": "12",
                        "exchangeTicketNumber": "ticket12",
                        "departureTime": "1720",
                        "endorsementsRestrictions": "Endorsement1234",
                        "arrivalTime": "1920",
                        "arrivalTimeMeridian": "A",
                        "departureTime": "1230",
                        "departureTimeMeridian": "A"
                    },
                    {
                        "carrierCode": "BB",
                        "flightNumber": "UA788",
                        "originatingAirportCode": "NY",
                        "class": "2",
                        "stopoverIndicator": "O",
                        "departureDate": "20230202",
                        "destinationAirportCode": "SFO",
                        "fareBasis": "B1",
                        "totalFareAmount": "12",
                        "exchangeTicketNumber": "ticket13",
                        "departureTime": "1720",
                        "endorsementsRestrictions": "Endorsement1234",
                        "arrivalTime": "0120",
                        "arrivalTimeMeridian": "A",
                        "departureTime": "2030",
                        "departureTimeMeridian": "A"
                    }
                ]
            }
        }
    }
}
Response to a Successful Request
{
  "_links": {
    "void": {
      "method": "POST",
      "href": "/pts/v2/captures/6917775047466121303955/voids"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/captures/6917775047466121303955"
    }
  },
  "clientReferenceInformation": {
    "code": "RTS-Bill"
  },
  "id": "6917775047466121303955",
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "100.00",
      "currency": "USD"
    }
  },
  "reconciliationId": "68210417JL5O06RJ",
  "status": "PENDING",
  "submitTimeUtc": "2023-08-11T18:11:44Z"
}
Request
{
    "clientReferenceInformation": {
        "code": "RTS-Bill"
    },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "100.00",
            "currency": "USD"
        }
    },
    "processingInformation": {
        "industryDataType": "airline"
    },
    "travelInformation": {
        "agency": {
            "name": "Thomascook"
        },
        "transit": {
            "airline": {
                "passengerName": "John",
                "ticketNumber": "asd23",
                "customerCode": "LDTYOU789",
                "totalFeeAmount": "200",
                "planNumber": "49252",
                "exchangeTicketAmount": "11",
                "exchangeTicketFeeAmount": "1",
                "legs": [
                    {
                        "carrierCode": "AA",
                        "flightNumber": "UA789",
                        "originatingAirportCode": "SFO",
                        "class": "1",
                        "stopoverIndicator": "O",
                        "departureDate": "20230202",
                        "destinationAirportCode": "NY",
                        "fareBasis": "B1",
                        "exchangeTicketNumber": "ticket12",
                        "departureTime": "1720",
                        "endorsementsRestrictions": "Endorsement1234"
                    },
                    {
                        "carrierCode": "BB",
                        "flightNumber": "UA788",
                        "originatingAirportCode": "NY",
                        "class": "2",
                        "stopoverIndicator": "O",
                        "departureDate": "20230202",
                        "destinationAirportCode": "SFO",
                        "fareBasis": "B1",
                        "exchangeTicketNumber": "ticket13",
                        "departureTime": "1720",
                        "endorsementsRestrictions": "Endorsement1234"
                    }
                ]
            }
        }
    }
}
Response to a Successful Request
{
  "_links": {
    "void": {
      "method": "POST",
      "href": "/pts/v2/captures/6917778689216158003955/voids"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/captures/6917778689216158003955"
    }
  },
  "clientReferenceInformation": {
    "code": "RTS-Bill"
  },
  "id": "6917778689216158003955",
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "100.00",
      "currency": "USD"
    }
  },
  "reconciliationId": "68210471JL5O06T1",
  "status": "PENDING",
  "submitTimeUtc": "2023-08-11T18:17:49Z"
}
Request
{
    "clientReferenceInformation": {
        "code": "RTS-Bill"
    },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "100.00",
            "currency": "USD"
        }
    },
    "processingInformation": {
        "industryDataType": "airline"
    },
    "travelInformation": {
        "agency": {
            "name": "Thomascook"
        },
        "transit": {
            "airline": {
                "passengerName": "John",
                "ticketNumber": "asd23",
                "customerCode": "LDTYOU789",
                "totalFeeAmount": "200",
                "planNumber": "49252",
                "exchangeTicketAmount": "11",
                "exchangeTicketFeeAmount": "1",
                "restrictedTicketIndicator": "0",
                "legs": [
                    {
                        "carrierCode": "AA",
                        "originatingAirportCode": "SFO",
                        "class": "1",
                        "stopoverIndicator": "O",
                        "departureDate": "20230202",
                        "destinationAirportCode": "NY",
                        "exchangeTicketNumber": "ticket12",
                        "departureTime": "1720",
                        "endorsementsRestrictions": "Endorsement1234"
                    },
                    {
                        "carrierCode": "BB",
                        "originatingAirportCode": "NY",
                        "class": "2",
                        "stopoverIndicator": "O",
                        "departureDate": "20230202",
                        "destinationAirportCode": "SFO",
                        "exchangeTicketNumber": "ticket13",
                        "departureTime": "1720",
                        "endorsementsRestrictions": "Endorsement1234"
                    }
                ]
            }
        }
    }
}
Response to a Successful Request
{
  "_links": {
    "void": {
      "method": "POST",
      "href": "/pts/v2/captures/6917788755186225803955/voids"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/captures/6917788755186225803955"
    }
  },
  "clientReferenceInformation": {
    "code": "RTS-Bill"
  },
  "id": "6917788755186225803955",
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "100.00",
      "currency": "USD"
    }
  },
  "reconciliationId": "68211484JL5O0702",
  "status": "PENDING",
  "submitTimeUtc": "2023-08-11T18:34:35Z"
}
RELATED TO THIS PAGE