Captures

This section provides the information you need in order to capture an authorized transaction.

Supported Card Types

All supported card types can process captures. For a list of all supported card types, see Payment Processors.

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.

Required Fields for Capturing an Authorization

Field value maps from the original authorization, sale, or credit transaction.
Cybersource
provides the value for this field.
For
Visa Platform Connect
, when capturing the authorization of an Apple Pay transaction on the mada Pay mobile app, set this field to
060
. Apple Pay transactions on the mada Pay app are supported for these cards issued in the Kingdom of Saudi Arabia:
  • mada debit and prepaid cards
  • Mastercard payment cards co-badged with mada
  • Visa payment cards co-badged with mada

REST Example: Capturing an Authorization

Request 
        
{
    "clientReferenceInformation": {
        "code": "ABC123",
        "partner": {
            "thirdPartyCertificationNumber": "123456789012"
        }
    },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "100.00",
            "currency": "EUR"
    }
}
Response to a Successful Request 
        
{
    "_links": {
        "void": {
            "method": "POST",
            "href": "/pts/v2/captures/6662994431376681303954/voids"
        },
        "self": {
            "method": "GET",
            "href": "/pts/v2/captures/6662994431376681303954"
        }
    },
    "clientReferenceInformation": {
        "code": "1666299443215"
    },
    "id": "6662994431376681303954",
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "100.00",
            "currency": "EUR"
        }
    },
    "reconciliationId": "66535942B9CGT52U",
    "status": "PENDING",
    "submitTimeUtc": "2022-10-20T20:57:23Z"
}