Void a Payment {#payments-processing-sale-void-intro}
=====================================================

This section describes how to void a payment that was submitted but not yet processed by the processor. A payment is also known as a sale, which is an authorization and capture in one API request. Include the payment ID in the void request endpoint to cancel the payment.

Endpoint {#payments-processing-sale-void-intro_d14e241}
-------------------------------------------------------

Required Fields for Voiding a Payment {#payments-processing-sale-void-required-fields}
======================================================================================

merchantID
:

merchantReferenceCode
:

voidService_voidRequestID
:
Set this field to the request ID that was included in the sale response message.

voidService_run
:
Set the value to `true`.

Simple Order Example: Void a Payment {#payments-processing-sale-void-ex-so}
===========================================================================

Request

```
&lt;requestMessage&gt;
    &lt;merchantID&gt;Napa Valley Vacations&lt;/merchantID&gt;
    &lt;merchantReferenceCode&gt;482046C3A7E94F5&lt;/merchantReferenceCode&gt;
    &lt;voidService run="true"&gt;
        &lt;voidRequestID&gt;098123456789&lt;/voidRequestID&gt;
    &lt;/voidService&gt;
&lt;/requestMessage&gt;
```

Response to a Successful Request

```
&lt;c:replyMessage&gt;
    &lt;c:requestID&gt;0305782650000167905080&lt;/c:requestID&gt;
    &lt;c:decision&gt;ACCEPT&lt;/c:decision&gt;
    &lt;c:reasonCode&gt;100&lt;/c:reasonCode&gt;
    &lt;c:merchantReferenceCode&gt;482046C3A7E94F5&lt;/c:merchantReferenceCode&gt;
    &lt;c:voidReply&gt;
        &lt;c:reconciliationID&gt;ABCDE12345FGHIJ67890&lt;/c:reconciliationID&gt;
        &lt;c:reasonCode&gt;100&lt;/c:reasonCode&gt;
        &lt;c:amount&gt;100.00&lt;/c:amount&gt;
        &lt;c:currency&gt;USD&lt;/c:currency&gt;
    &lt;/c:voidReply&gt;
&lt;/c:replyMessage&gt;
```

