On This Page

{#jumplink-list}  
[Markdown](/docs/vas/en-us/payments/developer/ctv/rest/payments/payment-l3-intro/l23-l3-processing-capture-intro-payments.md)  
Filter  
FILTER BY TAG

Captures with Level III Data {#l23-l3-processing-capture-intro-payments}
========================================================================

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

Endpoint {#l23-l3-processing-capture-intro-payments_d12e127}
------------------------------------------------------------

**Production:** `POST ``https://api.visaacceptance.com``/pts/v2/payments/`*{id}*`/captures`{#l23-l3-processing-capture-intro-payments_d12e136}  
**Test:** `POST ``https://apitest.visaacceptance.com``/pts/v2/payments/`*{id}*`/captures`{#l23-l3-processing-capture-intro-payments_d12e149}  
The *{id}* is the transaction ID returned in the authorization response.

Required Fields for Capturing a Payment with Level III Data {#l23-l3-processing-capture-req-fields-ctv}
=======================================================================================================

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

orderInformation.amountDetails.currency
:

orderInformation.amountDetails.nationalTaxIncluded
:
Set the value to `1` if the sum of all orderInformation.lineItems\[\].taxDetails\[\].amount values \> `0`.

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
:

processingInformation.purchaseLevel
:
Set field to `3`.
{#l23-l3-processing-capture-req-fields-ctv_dl_rr4_ycp_vwb}

Optional Fields for Capturing a Payment with Level III Data {#l23-l3-processing-capture-opt-fields-ctv}
=======================================================================================================

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

buyerInformation.vatRegistrationNumber
:

merchantInformation.cardAcceptorReferenceNumber
:

merchantInformation.vatRegistrationNumber
:

order.vatTaxAmountSign
:

orderInformation.amountDetails.discountAmount
:

orderInformation.amountDetails.dutyAmount
:

orderInformation.amountDetails.freightAmount
:

orderInformation.amountDetails.taxAppliedAfterDiscount
:

orderInformation.amountDetails.taxAppliedLevel
:

orderInformation.amountDetails.taxDetails\[\].amount
:

orderInformation.amountDetails.taxDetails\[\].rate
:

orderInformation.invoiceDetails.commodityCode
:

orderInformation.invoiceDetails.purchaseContactName
:

orderInformation.invoiceDetails.purchaseOrderDate
:

orderInformation.invoiceDetails.vatInvoiceReferenceNumber
:

orderInformation.lineItems\[\].commodityCode
:

orderInformation.lineItems\[\].discountAmount
:

orderInformation.lineItems\[\].discountRate
:

orderInformation.lineItems\[\].invoiceNumber
:

orderInformation.lineItems\[\].productCode
:

orderInformation.lineItems\[\].productName
:

orderInformation.lineItems\[\].quantity
:

orderInformation.lineItems\[\].taxAppliedAfterDiscount
:

orderInformation.lineItems\[\].taxDetails\[\].amount
:

orderInformation.lineItems\[\].taxRate
:

orderInformation.lineItems\[\].taxStatusIndicator
:

orderInformation.lineItems\[\].totalAmount
:

orderInformation.lineItems\[\].typeOfSupply
:

orderInformation.lineItems\[\].unitOfMeasure
:

orderInformation.lineItems\[\].unitPrice
:

orderInformation.shippingDetails.shipFromPostalCode
:

orderInformation.shipTo.administrativeArea
:

orderInformation.shipTo.postalCode
:

senderInformation.vatRegistrationNumber
:
{#l23-l3-processing-capture-opt-fields-ctv_dl_u5k_dvn_vwb}

REST Example: Capturing a Payment with Level III Data {#l23-l3-processing-capture-ex-rest-ctv}
==============================================================================================

Request

```
{
  "clientReferenceInformation": {
    "code": "TC50171_14"
  },
  "processingInformation": {
    "purchaseLevel": "3"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "200.00",
      "currency": "USD"
    },
    "lineItems": [
      {
        "productCode": "service",
        "productName": "TestProduct1",
        "quantity": "2",
        "unitPrice": "40.00",
        "unitOfMeasure": "EA",
        "totalAmount": "100.00",
        "taxAmount": "20.00"
      }
    ],
    "invoiceDetails": {
      "purchaseOrderNumber": "L3PurchaseOrderNo",
      "purchaseOrderDate": "2024-11-15",
      "taxable": true
    }
  }
}
```

{#l23-l3-processing-capture-ex-rest-ctv_codeblock_wmc_gfn_vwb}  
Response to a Successful Request

```
{
  "_links": {
    "void": {
      "method": "POST",
      "href": "/pts/v2/captures/7319475673656287004951/voids"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/captures/7319475673656287004951"
    }
  },
  "clientReferenceInformation": {
    "code": "TC50171_14"
  },
  "id": "7319475673656287004951",
  "orderInformation": {
    "invoiceDetails": {
      "level3TransmissionStatus": "Y"
    },
    "amountDetails": {
      "totalAmount": "200.00",
      "currency": "USD"
    }
  },
  "reconciliationId": "68960954X33X5WQ2",
  "status": "PENDING",
  "submitTimeUtc": "2024-11-18T16:32:47Z"
}
```

{#l23-l3-processing-capture-ex-rest-ctv_codeblock_ymc_gfn_vwb}  
RELATED TO THIS PAGE