---
updatedAt: 2025-12-02T00:33:40.000Z
agentTools:
  projectIndex: https://developer.bitpay.com/llms.txt
---

# Notification Codes

## Webhook Notification Codes

Codes for invoice events with webhook notifications

<HTMLBlock>{`
<table class="table">
  <tbody>
    <tr>
      <th>BitPay code</th>
      <th>Name</th>
      <th>Purpose</th>
    </tr>
    <tr>
      <td>1003</td>
      <td><code>"invoice_paidInFull"</code></td>
      <td>To notify merchant that an invoice has reached the status <code>paid</code></td>
    </tr>
    <tr>
      <td>1004</td>
      <td><code>"invoice_expired"</code></td>
      <td>To notify a merchant that an invoice has expired without being paid</td>
    </tr>
    <tr>
      <td>1005</td>
      <td><code>"invoice_confirmed"</code></td>
      <td>To notify merchant that an invoice has reached the status <code>confirmed</code></td>
    </tr>
    <tr>
      <td>1006</td>
      <td><code>"invoice_completed"</code></td>
      <td>To notify merchant that an invoice has reached the status <code>completed</code></td>
    </tr>
    <tr>
      <td>1012</td>
      <td><code>"invoice_manuallyNotified"</code></td>
      <td>Whenever a merchant request for the last notification to be resent (see section <a href="#rest-api-resources-invoices-request-a-webhook-to-be-resent">Request a webhook to be resent</a>).</td>
    </tr>
    <tr>
      <td>1013</td>
      <td><code>"invoice_failedToConfirm"</code></td>
      <td>To notify merchant that an invoice has reached the status <code>invalid</code></td>
    </tr>
    <tr>
      <td>1016</td>
      <td><code>"invoice_refundComplete"</code></td>
      <td>To notify a merchant that a refund request has been successfully processed</td>
    </tr>
    <tr>
      <td>1019</td>
      <td><code>"invoice_declined"</code></td>
      <td>To notify a merchant that an invoice has been <code>declined</code></td>
    </tr>
  </tbody>
</table>
`}</HTMLBlock>