Captures with Level III Data
This section shows you how to capture an authorized transaction with Level III data.
Endpoint
Production:
POST
https://api.cybersource.com
/pts/v2/payments/{id}
/capturesTest:
POST
https://apitest.cybersource.com
/pts/v2/payments/{id}
/capturesThe
{id}
is the transaction
ID returned in the authorization response.Required Fields for Capturing a Payment with Level III Data Using the REST API
REST
APIThese fields are required in a capture request with Level III data:
- orderInformation.amountDetails.currency
- orderInformation.amountDetails.discountAmount
- orderInformation.amountDetails.taxDetails[].rate
- Required for Visa transactions only.
- orderInformation.amountDetails.totalAmount
- orderInformation.lineItems[].discountAmount
- orderInformation.lineItems[].discountRate
- Required for Mastercard transactions only.
- orderInformation.lineItems[].productName
- orderInformation.lineItems[].quantity
- orderInformation.lineItems[].unitOfMeasure
- Required for Visa transactions only.
- orderInformation.lineItems[].unitPrice
- processingInformation.purchaseLevel
- Set field to3.
Optional Fields for Capturing a Payment with Level III Data Using the REST API
REST
APIThese fields are optional in a capture request with Level III data:
- buyerInformation.vatRegistrationNumber
- Optional for Visa transactions only.
- merchantInformation.vatRegistrationNumber
- orderInformation.amountDetails.dutyAmount
- orderInformation.amountDetails.freightAmount
- orderInformation.amountDetails.nationalTaxIncluded
- orderInformation.amountDetails.taxAmount
- orderInformation.amountDetails.taxDetails[].amount
- orderInformation.invoiceDetails.commodityCode
- orderInformation.invoiceDetails.purchaseOrderDate
- Optional for Visa transactions only.
- orderInformation.invoiceDetails.purchaseOrderNumber
- orderInformation.invoiceDetails.supplierOrderReference
- orderInformation.invoiceDetails.taxable
- Optional for Mastercard transactions only.
- orderInformation.lineItems[].commodityCode
- Optional for Mastercard transactions only.
- orderInformation.lineItems[].discountApplied
- Optional for Mastercard transactions only.
- orderInformation.lineItems[].discountRate
- orderInformation.lineItems[].productCode
- orderInformation.lineItems[].taxAmount
- orderInformation.lineItems[].taxDetails[].amount
- Optional for Visa transactions only.
- orderInformation.lineItems[].taxDetails[].code
- Optional for Visa transactions only.
- orderInformation.lineItems[].taxDetails[].rate
- orderInformation.lineItems[].taxRate
- orderInformation.lineItems[].taxStatusIndicator
- Optional for Mastercard transactions only.
- orderInformation.lineItems[].totalAmount
- orderInformation.shippingDetails.shipFromPostalCode
- orderInformation.shipTo.country
- orderInformation.shipTo.postalCode
- senderInformation.vatRegistrationNumber
- Optional for Visa transactions only.