For AI agents: the complete documentation index is at /llms.txt, and the full text of every page is at /llms-full.txt. Most pages are also available as Markdown by adding .md to the URL.

Capture

The Capture web method completes a transaction for a prior authorization.

Arguments

Name	Type	Description
Credentials	MerchantCredentials	A MerchantCredentials object used to authenticate against Merchantware.
Request	CaptureRequest	A CaptureRequest object containing the transactional data used capture a previous authorization and place it into the batch.

Response

A TransactionResponse46 object is returned.

Notes

This method captures a previous authorization and adds it to the current batch for settlement.
If you wish to cancel a transaction created with the Capture method, you may use the Void method. However, you cannot use the Void method to cancel a transaction after it has been batched.

Example SOAP Request

Sample Request Packet (raw)

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
    <soap12:Body>
        <Capture xmlns="http://schemas.merchantwarehouse.com/merchantware/v46/">
            <Credentials>
                <MerchantName>Zero Inc</MerchantName>
                <MerchantSiteId>00000000</MerchantSiteId>
                <MerchantKey>00000-00000-00000-00000-00000</MerchantKey>
            </Credentials>
            <Request>
                <Token>1971238639</Token>
                <Amount>15.00</Amount>
                <InvoiceNumber>CREDIT12</InvoiceNumber>
                <RegisterNumber>1</RegisterNumber>
                <MerchantTransactionId>TRX123</MerchantTransactionId>
                <CardAcceptorTerminalId>32</CardAcceptorTerminalId>
            </Request>
        </Capture>
    </soap12:Body>
</soap12:Envelope>

Sample Return Packet

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
    <soap12:Body>
        <CaptureResponse xmlns="http://schemas.merchantwarehouse.com/merchantware/v46/">
            <CaptureResult>
                <ApprovalStatus>APPROVED</ApprovalStatus>
                <Token>1971245925</Token>
                <AuthorizationCode>OK9999</AuthorizationCode>
                <TransactionDate>1/23/2020 2:25:30 PM</TransactionDate>
                <Amount>15.00</Amount>
                <RemainingCardBalance />
                <CardNumber />
                <Cardholder />
                <CardType>0</CardType>
                <FsaCard />
                <ReaderEntryMode>3</ReaderEntryMode>
                <AvsResponse />
                <CvResponse />
                <ErrorMessage />
                <ExtraData />
                <Rfmiq>10000003WM</Rfmiq>
                <DebitTraceNumber />
            </CaptureResult>
        </CaptureResponse>
    </soap12:Body>
</soap12:Envelope>