On This Page

Capture Service

The capture service is a follow-on service that uses the request ID returned from the previous authorization. The request ID links the capture to the authorization. This service transfers funds from the customer’s account to your bank and usually takes two to four days to complete.

Processor-Specific Information About Authorizations and Captures
Payment Processor	Authorization and Capture Information
`Elavon`	`Elavon` limits authorization and capture amounts to 999999999999 (twelve 9s).
FDMS South	For the Indonesian rupiah (IDR) and Chilean peso (CLP) currencies: Rounding occurs, which can cause a minor discrepancy of one currency unit between the amount you requested and the amount that is authorized. When a transaction is enabled for partial authorization, you must ensure that the requested amount does not include any digits to the right of the decimal separator.

Required Fields for Capturing a Payment

The following fields are required when creating a capture request:

clientReferenceInformation.code
orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount
processingInformation.paymentSolution: Set to
008
.

Related Information

REST API Field Reference Guide

Capturing a Payment

Pass the original authorization ID in the URL, and send the service request to

POST https://<url_prefix>/v2/payments/{id}/captures

. Use one of these URL prefixes:

Test:

apitest.cybersource.com

Production:

api.cybersource.com

Production in India:

api.in.cybersource.com

ADDITIONAL INFORMATION

Where

is the authorization ID returned in the authorization response.

{
  "id": "6481692924466004003001"
}

The URL with the

value is included in the authorization response:

{
  "_links": {
    "capture": {
      "method": "POST",
      "href": "/pts/v2/payments/6481692924466004003001/captures"
    }
  }

Check the response message to make sure that the request was successful. A 200-level HTTP response code indicates success. For information about response codes, see Transaction Response Codes.

Example: Basic Credit Card Capture Using the REST API

Capture Request

{
  "clientReferenceInformation": {
    "code": "482046C3A7E94F5BD1FE3C66C"
  },
  "processingInformation": {
    "paymentSolution": "008"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "49.95",
      "currency": "USD"
    }
  }
}

Capture Response

{
    "clientReferenceInformation": {
        "code": "482046C3A7E94F5BD1FE3C66C"
    },
    "processingInformation": {
        "reconciliationID": "02850840187309570"
    },
    "orderInformation": {
        "amountDetails": {
           "totalAmount": "49.95",
           "currency": "USD"
        }
    }
}