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.

Void

The Void method voids a prior unsettled transaction.

Arguments

Name	Type	Description
Credentials	MerchantCredentials	A MerchantCredentials object used to authenticate against Merchantware.
Request	VoidRequest	A VoidRequest object containing the transactional data used to void a previous transaction.

Response

A TransactionResponse46 object is returned.

Notes

This removes a transaction from the current batch. It is not possible to void a transaction settled in a previous batch.
For more guidance, see our Best Practices guide on Void Failure Handling.

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>
        <Void 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>1971226912</Token>
                <RegisterNumber>1</RegisterNumber>
                <MerchantTransactionId>TRX123</MerchantTransactionId>
                <CardAcceptorTerminalId>32</CardAcceptorTerminalId>
            </Request>
        </Void>
    </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>
        <VoidResponse xmlns="http://schemas.merchantwarehouse.com/merchantware/v46/">
            <VoidResult>
                <ApprovalStatus>APPROVED</ApprovalStatus>
                <Token>1971338624</Token>
                <AuthorizationCode>VOID</AuthorizationCode>
                <TransactionDate>1/23/2020 4:28:05 PM</TransactionDate>
                <Amount />
                <RemainingCardBalance />
                <CardNumber />
                <Cardholder />
                <CardType>0</CardType>
                <FsaCard />
                <ReaderEntryMode>0</ReaderEntryMode>
                <AvsResponse />
                <CvResponse />
                <ErrorMessage />
                <ExtraData />
                <DebitTraceNumber />
            </VoidResult>
        </VoidResponse>
    </soap12:Body>
</soap12:Envelope>

Policies

Connect

Additional Resources