On This Page

Capture an Authorized Payment

The capture request enables you to capture an authorized payment. You can either capture the entire amount in one request or request partial-capture amounts. Oney supports multiple partial-capture requests when the total amount of all captures is less than the authorized amount. Requesting a capture requires the from the authorization response.

You can capture an authorized payment up to 28 days after the payment was authorized.

Calculating the Grand Total

Include the grand total in the request by using the

orderInformation.amountDetails.totalAmount

field.

Endpoints

Production:

POST https://api.cybersource.com/pts/v2/payments/{id}
/captures

Test:

POST https://apitest.cybersource.com/pts/v2/payments/{id}
/captures

Set the {id}
to the request ID contained in the authorization response.

Response Statuses

The capture service responds with one of these statuses as the

status

response field value:

FAILED

: The capture request failed.

PENDING

: The capture request is accepted but is not settled. Request the check status service to retrieve status updates. See Check a Transaction Status.

SETTLED

: The capture request is settled for the requested amount.

The capture service also responds with a reason code as the field value.

Required Fields for Capturing a Payment

Include these required fields to capture a payment.

clientReferenceInformation.code
orderInformation.amountDetails.currency: Set to
EUR
.
orderInformation.amountDetails.totalAmount
paymentInformation.paymentType.method.name: Set to
ONEY
.
paymentInformation.paymentType.name: Set to
BNPL
.
processingInformation.actionList: Set to
AP_CAPTURE
.

Example: Capturing a Payment

Request

{
    "clientReferenceInformation": {
        "code": "refnum-1234"
    },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "102.21",
            "currency": "EUR"
        }
    },
        "paymentInformation": {
            "paymentType": {
                "name": "BNPL",
                "method": {
                    "name": "ONEY"
                }
            }
        },
    "processingInformation": {
        "actionList": "AP_CAPTURE"
    }
}

Response

{
    "_links": {
        "self": {
            "method": "POST",
            "href": "/pts/v2/captures/7546768043406678904807"
        },
        "refund": {
            "method": "POST",
            "href": "/pts/v2/captures/7546768043406678904807/refunds"
        },
        "status": {
            "method": "POST",
            "href": "/pts/v2/refresh-payment-status/7546768043406678904807"
        }
    },
    "clientReferenceInformation": {
        "code": "refnum-1234"
    },
    "id": "7546768043406678904807",
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "102.21",
            "currency": "EUR"
        }
    },
    "processorInformation": {
        "responseDetails": "00004",
        "responseCode": "00004"
    },
    "reconciliationId": "XFZ3ZE1G1DID",
    "status": "SETTLED",
    "submitTimeUtc": "2025-08-08T18:13:28Z"
}