On This Page
Issue a Credit
This topic describes how to issue an airline credit.
IMPORTANT
All fields used in the original transaction must be included in your
request.
Endpoint
Production:
POST
https://api.cybersource.com
/pts/v2/credits/Test:
POST
https://apitest.cybersource.com
/pts/v2/credits/Required Fields for Airline Credits
Required Fields for an Ancillary Purchase
Include these fields, in addition to the above fields, if there is an ancillary
purchase:
- Include one of the possible values listed in the Ancillary Service Category Codes section.
- To send multiple category codes, you must include additional entries of this field in the array.
Card-Specific Field for Processing Airline Credits
Credits
Certain card types require additional fields.
Diners Club
Use this field in addition to the required fields to capture an airline
authorization when using a Diners Club card.
Optional Fields for Airline Credits
Credits
- Set to one of these possible values:
- A: Passenger transport ancillary fee cancellation
- B: Airline ticket and passenger transport ancillary fee cancellation
- C: Airline ticket cancellation
- O: Other
- P: Partial refund of airline ticket
- For a list of all possible values, see Ancillary Service Category Codes.
- For a list of all possible values, see Ancillary Service Category Codes.
Example: Processing Airline Credits
Credits
Request
{ "paymentInformation": { "card": { "number": "4111111111111111", "expirationMonth": "07", "expirationYear": "2027" } }, "orderInformation": { "amountDetails": { "totalAmount": "300.00", "currency": "USD" }, "billTo": { "firstName": "John", "lastName": "Smith", "address1": "123 Happy St", "externality": "Sunnyville", "administrativeArea": "TX", "postalCode": "55555", "country": "US", "email": "johnsmith@testemail.com" } } }
Response
{ "_links": { "void": { "method": "POST", "href": "/pts/v2/credits/7678035881236488904805/voids" }, "self": { "method": "GET", "href": "/pts/v2/credits/7678035881236488904805" } }, "clientReferenceInformation": { "code": "1767803588270" }, "creditAmountDetails": { "currency": "USD", "creditAmount": "300.00" }, "id": "7678035881236488904805", "orderInformation": { "amountDetails": { "currency": "USD" } }, "paymentAccountInformation": { "card": { "type": "001" } }, "paymentInformation": { "tokenizedCard": { "type": "001" }, "card": { "type": "001" } }, "processorInformation": { "approvalCode": "888888", "responseCode": "100" }, "reconciliationId": "JDWEIJB43Y09", "status": "PENDING", "submitTimeUtc": "2026-01-07T16:33:08Z" }
Example: Issue a Credit for an Ancillary Purchase
Credit
for an Ancillary PurchaseRequest
{ "paymentInformation": { "card": { "number": "4111111111111111", "expirationMonth": "07", "expirationYear": "2027" } }, "orderInformation": { "amountDetails": { "totalAmount": "300.00", "currency": "USD" }, "billTo": { "firstName": "John", "lastName": "Smith", "address1": "123 Happy St", "externality": "Sunnyville", "administrativeArea": "TX", "postalCode": "55555", "country": "US", "email": "johnsmith@testemail.com" } }, "travelInformation": { "transit": { "airline": { "ancillaryInformation": { "ticketNumber": "1234567981234567989", "passengerName": "John Smith", "connectedTicketNumber": "987654321987654", "service": [ { "categoryCode": "1" } ] } } } } }
Response to a Successful Request
{ "_links": { "void": { "method": "POST", "href": "/pts/v2/credits/7678040337136100204805/voids" }, "self": { "method": "GET", "href": "/pts/v2/credits/7678040337136100204805" } }, "clientReferenceInformation": { "code": "1767804033806" }, "creditAmountDetails": { "currency": "USD", "creditAmount": "300.00" }, "id": "7678040337136100204805", "orderInformation": { "amountDetails": { "currency": "USD" } }, "paymentAccountInformation": { "card": { "type": "001" } }, "paymentInformation": { "tokenizedCard": { "type": "001" }, "card": { "type": "001" } }, "processorInformation": { "approvalCode": "888888", "responseCode": "100" }, "reconciliationId": "JQT0PJB4FMOB", "status": "PENDING", "submitTimeUtc": "2026-01-07T16:40:33Z" }