On This Page

Refunds

This topic describes how to process an airline refund.
This service returns the funds used in the initial capture and requires the original capture ID.

Endpoint

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

Required Fields for Processing an Airline
Refund

Include these required fields to process an airline refund.

Optional Fields for Processing an Airline
Refund

This section includes these types of optional fields for an airline
refund
:

General Optional Fields

You can use these optional fields to include additional information in any airline purchase.
travelInformation.agency.code
travelInformation.agency.name
travelInformation.transit.airline.arrivalDate
travelInformation.transit.airline.carrierName
travelInformation.transit.airline.clearingCount
travelInformation.transit.airline.clearingSequence
travelInformation.transit.airline.creditReasonIndicator
travelInformation.transit.airline.customerCode
travelInformation.transit.airline.documentType
For a list of possible values, see Airline Document Type Codes.
travelInformation.transit.airline.electronicTicketIndicator
travelInformation.transit.airline.exchangeTicketFeeAmount
travelInformation.transit.airline.numberOfPassengers
travelInformation.transit.airline.passengerName
travelInformation.transit.airline.planNumber
travelInformation.transit.airline.purchaseType
travelInformation.transit.airline.reservationSystemCode
travelInformation.transit.airline.restrictedTicketDesciption
travelInformation.transit.airline.restrictedTicketIndicator
travelInformation.transit.airline.ticketChangeIndicator
travelInformation.transit.airline.ticketIssueDate
travelInformation.transit.airline.ticketIssuer.locality
travelInformation.transit.airline.ticketNumber
travelInformation.transit.airline.totalClearingAmount
travelInformation.transit.airline.totalFeeAmount
travelInformation.transit[].exchangeTicketAmount

Airline Optional Fields for Ticket Purchases

You can use these optional fields to include additional information when requesting an airline
credit
 for a ticket purchase.
travelInformation.transit.airline.legs[].arrivalTime
travelInformation.transit.airline.legs[].arrivalTimeMeridian
travelInformation.transit.airline.legs[].carrierCode
travelInformation.transit.airline.legs[].class
travelInformation.transit.airline.legs[].conjunctionTicket
travelInformation.transit.airline.legs[].couponNumber
travelInformation.transit.airline.legs[].departureDate
travelInformation.transit.airline.legs[].departureTime
travelInformation.transit.airline.legs[].departureTimeMeridian
travelInformation.transit.airline.legs[].destinationAirportCode
travelInformation.transit.airline.legs[].endorsementsRestrictions
travelInformation.transit.airline.legs[].exchangeTicketNumber
travelInformation.transit.airline.legs[].fareBasis
travelInformation.transit.airline.legs[].feeAmount
travelInformation.transit.airline.legs[].flightNumber
travelInformation.transit.airline.legs[].originatingAirportCode
travelInformation.transit.airline.legs[].stopoverIndicator
travelInformation.transit.airline.legs[].taxAmount
travelInformation.transit.airline.legs[].totalFareAmount

Ancillary Optional Fields

You can use these optional fields to include additional information when requesting an airline
credit
 for an ancillary purchase.
travelInformation.transit.airline.ancillaryInformation.connectedTicketNumber
travelInformation.transit.airline.ancillaryInformation.creditReasonIndicator
travelInformation.transit.airline.ancillaryInformation.passengerName
travelInformation.transit.airline.ancillaryInformation.service[].categoryCode
For a list of possible values, see Ancillary Service Category Codes.
travelInformation.transit.airline.ancillaryInformation.service[].subCategoryCode
travelInformation.transit.airline.ancillaryInformation.ticketNumber

REST Example: Processing an Airline Refund

Use this example as a reference for processing an airline refund.
Request
{
  "clientReferenceInformation": {
    "code": "TC50171_3"
  },
  "processingInformation": {
    "industryDataType": "airline"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "500",
      "currency": "USD"
    }
  }
}
Response to a Successful Request
{
  "_links": {
    "void": {
      "method": "POST",
      "href": "/pts/v2/refunds/6823038625416445403955/voids"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/refunds/6823038625416445403955"
    }
  },
  "clientReferenceInformation": {
    "code": "TC50171_3"
  },
  "id": "6823038625416445403955",
  "orderInformation": {
    "amountDetails": {
      "currency": "USD"
    }
  },
  "processorInformation": {
    "approvalCode": "888888",
    "responseCode": "100"
  },
  "reconciliationId": "67722608EGMV6Q7V",
  "refundAmountDetails": {
    "currency": "USD",
    "refundAmount": "500.00"
  },
  "status": "PENDING",
  "submitTimeUtc": "2023-04-24T02:37:42Z"
}