---
updatedAt: 2025-09-22T17:25:38.000Z
agentTools:
  projectIndex: https://developer.bitpay.com/llms.txt
---

# Cancel an Invoice by GUID

Facades: `merchant`

## Overview

Cancel an invoice by ID, with the option to force cancelation when no contact information is present.

> 📘 Note
>
> Cancellation will require **either** an SMS or E-mail to have already been set if the invoice has proceeded to the point where it may have been paid.

## Parameters

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Parameter
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        invoiceId
      </td>

      <td>
        The ID of the invoice to delete.
      </td>
    </tr>

    <tr>
      <td>
        forceCancel
      </td>

      <td>
        If `true` it will cancel the invoice even if no contact information is present.  

        When omitted, this will be false.
      </td>
    </tr>
  </tbody>
</Table>

## Example

```typescript TypeScript
await client.cancelInvoice('invoiceGuid');
```