Void

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 TransactionResponse45 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)
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
   <soap:Header/>
   <soap:Body>
      <Void xmlns="http://schemas.merchantwarehouse.com/merchantware/v45/">
         <Credentials>
            <MerchantName>Zero Inc</MerchantName>
            <MerchantSiteId>00000000</MerchantSiteId>
            <MerchantKey>00000-00000-00000-00000-00000</MerchantKey>
         </Credentials>
         <Request>
            <Token>608973</Token>
            <RegisterNumber>35</RegisterNumber>
            <MerchantTransactionId>167901</MerchantTransactionId>
            <CardAcceptorTerminalId>3</CardAcceptorTerminalId>
         </Request>
      </Void>
   </soap:Body>
</soap:Envelope>


Sample Return Packet
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <VoidResponse xmlns="http://schemas.merchantwarehouse.com/merchantware/v45/">
         <VoidResult>
            <ApprovalStatus>APPROVED</ApprovalStatus>
            <Token>608974</Token>
            <AuthorizationCode>VOID</AuthorizationCode>
            <TransactionDate>3/14/2016 8:30:18 PM</TransactionDate>
            <Amount/>
            <RemainingCardBalance/>
            <CardNumber/>
            <Cardholder/>
            <CardType>0</CardType>
            <FsaCard/>
            <ReaderEntryMode>0</ReaderEntryMode>
            <AvsResponse/>
            <CvResponse/>
            <ErrorMessage/>
            <ExtraData/>
         </VoidResult>
      </VoidResponse>
   </soap:Body>
</soap:Envelope>