Capture Given Auth Request

You must specify the Capture Given Auth request as follows. The structure of the request is identical for either an Online or a Batch submission.

<captureGivenAuth id="Capture Given Auth Id" reportGroup="iQ Report Group" customerId="Customer Id">

<orderId>Order Id</orderId>

<authInformation>

<amount>Authorization Amount</amount>

<secondaryAmount>Secondary Amount</secondaryAmount>

<surchargeAmount>Amount of Surcharge</surchargeAmount>

<orderSource>Order Entry Source</orderSource>

<billToAddress>

<shipToAddress>

<retailerAddress>

<additionalCOFData>

[ <card> | <token> | <paypage> | <mpos>]

<customBilling>

<taxType>payment or fee</taxType>

<processingInstructions>

<debtRepayment>true or false</debtRepayment>

<processingType>processingType Enum</processingType>

<originalNetworkTransactionId>Network Txn Value</originalNetworkTransactionId>

<originalTransactionAmount>Amount from Orig Txn</originalTransactionAmount>

<businessIndicator>consumerBillPayment</businessIndicator>

<crypto>false</crypto>

<passengerTransportData>

<foreignRetailerIndicator>F</foreignRetailerIndicator>

<accountFundingTransactionData>

<typeOfDigitalCurrency>Type value</typeOfDigitalCurrency>

<conversionAffiliateId>Conversion Affiliate Id value</conversionAffiliateId>

</captureGivenAuth>

Example: Batch Capture Given Auth Request

The following example shows a single Capture Given Auth request. The example uses the <card> child element, but a tokenized merchant could use the <token> child element in its place.

<cnpRequest version="12.0" xmlns="http://www.vantivcnp.com/schema" numBatchRequests="1">

<authentication>

<user>User Name</user>

<password>password</password>

</authentication>

<batchRequest id="batchId" numCaptureGivenAuths="1" captureGivenAuthAmount="10000" merchantId="100">

<captureGivenAuth id="AX54321678" reportGroup="RG27">

<orderId>orderId</orderId>

<authInformation>

<authDate>2016-09-21</authDate>

<authCode>123456</authCode>

</authInformation>

<amount>10000</amount>

<orderSource>ecommerce</orderSource>

<card>

<type>VI</type>

<number>4005550000081019</number>

<expDate>0910</expDate>

</card>

<enhancedData>

<customerReference>PO12345</customerReference>

<salesTax>125</salesTax>

<taxExempt>false</taxExempt>

<discountAmount>0</discountAmount>

<shippingAmount>495</shippingAmount>

<dutyAmount>0</dutyAmount>

<shipFromPostalCode>01851</shipFromPostalCode>

<destinationPostalCode>01851</destinationPostalCode>

<destinationCountryCode>USA</destinationCountryCode>

<invoiceReferenceNumber>123456</invoiceReferenceNumber>

<orderDate>2016-09-21</orderDate>

<detailTax>

<taxIncludedInTotal>true</taxIncludedInTotal>

<taxAmount>55</taxAmount>

<taxRate>0.0055</taxRate>

<taxTypeIdentifier>00</taxTypeIdentifier>

<cardAcceptorTaxId>011234567</cardAcceptorTaxId>

</detailTax>

<lineItemData>

<itemSequenceNumber>1</itemSequenceNumber>

<itemDescription>chair</itemDescription>

<productCode>CH123</productCode>

<quantity>1</quantity>

<unitOfMeasure>EACH</unitOfMeasure>

<taxAmount>125</taxAmount>

<lineItemTotal>9380</lineItemTotal>

<lineItemTotalWithTax>9505</lineItemTotalWithTax>

<itemDiscountAmount>0</itemDiscountAmount>

<commodityCode>300</commodityCode>

<unitCost>93.80</unitCost>

</lineItemData>

</enhancedData>

</captureGivenAuth>

</batchRequest>

</cnpRequest>

Example: Online Capture Given Auth Request

<cnpOnlineRequest version="12.0" xmlns="http://www.vantivcnp.com/schema" merchantId="100">

<authentication>

<user>userName</user>

<password>password</password>

</authentication>

<captureGivenAuth id="AX54321678" reportGroup="RG27">

<orderId>orderId</orderId>

<authInformation>

<authDate>2016-08-24</authDate>

<authCode>123456</authCode>

</authInformation>

<amount>10000</amount>

<orderSource>ecommerce</orderSource>

<card>

<type>VI</type>

<number>4005550000081019</number>

<expDate>0910</expDate>

</card>

<enhancedData>

<customerReference>PO12345</customerReference>

<salesTax>125</salesTax>

<deliveryType>TBD</deliveryType>

<taxExempt>false</taxExempt>

<discountAmount>0</discountAmount>

<shippingAmount>495</shippingAmount>

<dutyAmount>0</dutyAmount>

<shipFromPostalCode>01851</shipFromPostalCode>

<destinationPostalCode>01851</destinationPostalCode>

<destinationCountryCode>USA</destinationCountryCode>

<invoiceReferenceNumber>123456</invoiceReferenceNumber>

<orderDate>2016-08-14</orderDate>

<detailTax>

<taxIncludedInTotal>true</taxIncludedInTotal>

<taxAmount>55</taxAmount>

<taxRate>0.0059</taxRate>

<taxTypeIdentifier>00</taxTypeIdentifier>

<cardAcceptorTaxId>011234567</cardAcceptorTaxId>

</detailTax>

<lineItemData>

<itemSequenceNumber>1</itemSequenceNumber>

<itemDescription>chair</itemDescription>

<productCode>CH123</productCode>

<quantity>1</quantity>

<unitOfMeasure>EACH</unitOfMeasure>

<taxAmount>125</taxAmount>

<lineItemTotal>9380</lineItemTotal>

<lineItemTotalWithTax>9505</lineItemTotalWithTax>

<itemDiscountAmount>0</itemDiscountAmount>

<commodityCode>300</commodityCode>

<unitCost>93.80</unitCost>

</lineItemData>

</enhancedData>

</captureGivenAuth>

</cnpOnlineRequest>

Example: Capture Given Auth Request using token Element

The example below uses the following token related elements (click name to jump to element definition): token and cnpToken.

<captureGivenAuth id="99999" customerId="444" reportGroup="RG1">

<orderId>F12345</orderId>

<authInformation>

<authDate>2011-10-25</authDate>

<authCode>500005</authCode>

</authInformation>

<amount>15000</amount>

<orderSource>ecommerce</orderSource>

<billToAddress>

<name>John Doe</name>

<addressLine1>10 Main Street</addressLine1>

<city>San Jose</city>

<state>CA</state>

<zip>95032-1234</zip>

<country>USA</country>

</billToAddress>

<token>

<cnpToken>1112000100010085</cnpToken>

<expDate>1112</expDate>

<cardValidationNum>987</cardValidationNum>

</token>

</captureGivenAuth>