On This Page

Captures with Level II Data

This section shows you how to capture an authorized transaction with Level II data. These required fields and example are specific to Visa Platform Connect.

For required fields, optional fields, and examples specific to your processor see the Level II and Level III Processing developer guides.

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 a Payment with Level II Data

Use these required fields to capture a payment that includes Level II data.

orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount
orderInformation.invoiceDetails.purchaseOrderNumber: Required for purchase/procurement cards only.
orderInformation.invoiceDetails.taxable: Required if the sum of all
orderInformation.lineItems[].taxAmount
values >
0
.
orderInformation.lineItems[].taxAmount

Related Information

API field reference guide for the REST API

Optional Fields for Capturing a Payment with Level II Data

You can use these optional fields to include additional information when capturing a payment with Level II data.

order.vatTaxAmountSign
orderInformation.shipTo.postalCode

Related Information

API field reference guide for the REST API

REST Example: Capturing a Payment with Level II Data

Request

{
  "clientReferenceInformation": {
    "code": "TC50171_3"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "7.77",
      "currency": "USD"
    },
    "invoiceDetails": {
      "purchaseOrderNumber": "LevelII Auth Po",
      "taxable": true
    },
    "lineItems": [
      {
        "unitPrice": "7.00",
        "taxAmount": ".77"
      }
    ]
  }
}

Response to a Successful Request

{
  "_links": {
    "void": {
      "method": "POST",
      "href": "/pts/v2/captures/7316954580096155203955/voids"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/captures/7316954580096155203955"
    }
  },
  "clientReferenceInformation": {
    "code": "TC50171_3"
  },
  "id": "7316954580096155203955",
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "112.00",
      "currency": "USD"
    }
  },
  "reconciliationId": "7316954318366152603955",
  "status": "PENDING",
  "submitTimeUtc": "2024-11-15T18:30:58Z"
}