# DoVoid API Operation (SOAP) (/api/nvp-soap/do-void-soap)



> **Note:** **Important:** NVP/SOAP is a legacy integration method. We accept new integrations and support existing integrations, but there are newer solutions. If you're starting an integration, [we recommend our latest solutions](/).

Voids an order or an authorization.

## DoVoid Request Message [#dovoid-request-message]

<img src="https://www.paypalobjects.com/webstatic/en_US/developer/docs/api/DoVoidRequestType1.gif" alt="DoVoidRequestType,Diagram" />

> **Note:** **Note:** Only the fields described in this documentation are available for use.

### DoVoid Request Fields [#dovoid-request-fields]

| Field<br />             | Description<br />                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `AuthorizationID`<br /> | `xs:string`<br /&#x3E; &#x2A;(Required)* Original authorization ID specifying the authorization to void or, to void an order, the order ID.<br />  > **Note:** &#x2A;*Important:** If you are voiding a transaction that has been reauthorized, use the ID from the original authorization, and not the reauthorization. Character length and limitations: 19 single-byte characters<br />                                           |
| `Note`<br />            | `xs:string`<br /&#x3E; &#x2A;(Optional)* Informational note about this void that is displayed to the buyer in email and in their transaction history.<br /> Character length and limitations: 255 single-byte characters<br />                                                                                                                                                                                                       |
| `MsgSubId`<br />        | `xs:string`<br /> (*Optional*) A message ID used for idempotence to uniquely identify a message. This ID can later be used to request the latest results for a previous request without generating a new request. Examples of this include requests due to timeouts or errors during the original request.<br /> Character length and limitations: 38 single-byte characters<br /> This field is available since version 94.0.<br /> |

## DoVoid Response Message [#dovoid-response-message]

<img src="https://www.paypalobjects.com/webstatic/en_US/developer/docs/api/DoVoidResponseType1.gif" alt="DoVoidResponseType,Diagram" />

> **Note:** **Note:** Only the fields described in this documentation are available for use.

### DoVoidResponse Fields [#dovoidresponse-fields]

| Field                   | Description                                                                                                                                                                                                                                                                                                                                                                                                             |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AuthorizationID`<br /> | `xs:string`<br /&#x3E; &#x2A;(Optional)* Authorization identification number you specified in the request.<br /> Character length and limitations: 19 single-byte characters<br />                                                                                                                                                                                                                                      |
| `MsgSubId`<br />        | `xs:string`<br /> A message ID used for idempotence to uniquely identify a message. This ID can later be used to request the latest results for a previous request without generating a new request. Examples of this include requests due to timeouts or errors during the original request.<br /> Character length and limitations: 38 single-byte characters<br /> This field is available since version 94.0.<br /> |

## Additional information [#additional-information]

* [API error codes](/api/nvp-soap/errors/)