The Capture transaction transfers funds from the customer to the merchant. The Capture references the associated Authorization by means of the litleTxnId element returned in the Authorization response.
You send a Capture after the order has been fulfilled. In some cases, it is not possible to fulfill a customer’s entire order in one shipment (for example, if some items are backordered, or some shipped from an off-site location). In this situation, you can send a Partial Capture transaction by setting the partial attribute to true. A Partial Capture contains only the data relevant to the items that were actually shipped, enabling you to settle the funds related to those items.
Example: Online Capture Request - Full Capture
The following Capture example is for a full capture. Although the <capture> element includes an <amount> child, it is not required for a full Capture. If you omit the <amount> child element, the capture amount defaults to the full amount from the associated Authorization.
<litleOnlineRequest version="9.4" xmlns="http://www.litle.com/schema" merchantId="100"> <authentication> <user>User Name</user> <password>password</password> </authentication> <capture id="2" reportGroup="ABC Division" customerId="038945" partial="false"> <litleTxnId>13254123434</litleTxnId> <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>2011-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> <detailTax> <taxIncludedInTotal>true</taxIncludedInTotal> <taxAmount>55</taxAmount> <taxRate>0.0059</taxRate> <taxTypeIdentifier>03</taxTypeIdentifier> <cardAcceptorTaxId>011234567</cardAcceptorTaxId> </detailTax> </lineItemData> <lineItemData> <itemSequenceNumber>2</itemSequenceNumber> <itemDescription>table</itemDescription> <productCode>TB123</productCode> <quantity>1</quantity> <unitOfMeasure>EACH</unitOfMeasure> <lineItemTotal>30000</lineItemTotal> <itemDiscountAmount>0</itemDiscountAmount> <commodityCode>300</commodityCode> <unitCost>300.00</unitCost> </lineItemData> </enhancedData> </capture> </litleOnlineRequest>
Example: Online Capture Response
<litleOnlineResponse version="9.4" xmlns="http://www.litle.com/schema" response="0" message="Valid Format"> <captureResponse id="2" reportGroup="ABC Division" customerId="038945"> <litleTxnId>1100030204</litleTxnId> <response>001</response> <responseTime>2015-07-11T14:48:48</responseTime> <postDate>2015-07-11</postDate> <message>Transaction received</message> </captureResponse> </litleOnlineResponse>
Return to a list of sample XML transactions
For additional information, consult the LitleXML reference guide