On This Page

Captures

When you set the
completeMandate.type
 field value to
AUTH
 or
PREFER_AUTH
, you must send a request to capture an authorized payment. Full and partial captures are supported.

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.

Example: Authorization Response from
Unified Checkout

{
  "details": {
    "clientReferenceInformation": {
      "code": "1753351101383"
    },
    "orderInformation": {
      "amountDetails": {
        "currency": "USD",
        "totalAmount": "21.00"
      }
    },
    "processorInformation": {
      "approvalCode": "AUTH456789",
      "responseCode": "00003",
      "responseDetails": "00003",
      "transactionId": "2016011808153910011808153AUTH"
    },
    "reconciliationId": "04RYADD29YRO",
    "submitTimeUtc": "2025-07-24T09:58:21Z"
  },
  "id": "7533511014286971803092",
  "message": "Request processed successfully.",
  "outcome": "AUTHORIZED",
  "status": "AUTHORIZED"
}

Response Status

Cybersource
 responds to your capture request with one of these statuses:
  • FAILED
    : The capture request failed.
  • PENDING
    : The capture request is accepted but not captured. Send a request to the check status service to retrieve status updates.
  • SETTLED
    : The capture request is settled for the amount requested.