---
updatedAt: 2025-11-13T22:55:06.000Z
agentTools:
  projectIndex: https://developer.corrigopro.com/llms.txt
---

# Invoice status changed

Every time an invoice status is changed, your WebHook receives a notification containing all necessary information. In most cases, notification payload will contain a new status value only, but if your customer [disputes, authorizes or pays](docs/retrieving-invoices#section-customer-actions) an invoice, payload will contain action-specific info, as described below.

## Fields

<Table align={["left","left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        Field
      </th>

      <th style={{ textAlign: "left" }}>
        Value Type
      </th>

      <th style={{ textAlign: "left" }}>
        Verification
      </th>

      <th style={{ textAlign: "left" }}>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        Header
      </td>

      <td style={{ textAlign: "left" }}>
        [MessageHeader](https://developer.corrigopro.com/docs/data-models#section-messageheader)
      </td>

      <td style={{ textAlign: "left" }}>
        Mandatory
      </td>

      <td style={{ textAlign: "left" }}>
        Complex object that contains important information about the request.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        Status
      </td>

      <td style={{ textAlign: "left" }}>
        [InvoiceStatus](https://developer.corrigopro.com/docs/enumerations#section-invoicestatus)
      </td>

      <td style={{ textAlign: "left" }}>
        Mandatory
      </td>

      <td style={{ textAlign: "left" }}>
        New invoice status
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        Comment
      </td>

      <td style={{ textAlign: "left" }}>
        String
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        Author comment justifying an action. In case of customer dispute it will contain rejection reason.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        AuthNumber
      </td>

      <td style={{ textAlign: "left" }}>
        String
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        Authorization number, present only if **Status** = Authorized
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        CheckNumber
      </td>

      <td style={{ textAlign: "left" }}>
        String
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        Check number, present only if **Status** = Paid
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        Amount
      </td>

      <td style={{ textAlign: "left" }}>
        Decimal (Money)
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        If **Status** = Authorized, contains authorization amount. If **Status** = Paid, contains paid amount.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        PaidDate
      </td>

      <td style={{ textAlign: "left" }}>
        DateTime
      </td>

      <td style={{ textAlign: "left" }}>
        Optional
      </td>

      <td style={{ textAlign: "left" }}>
        Date when the payment was submitted, present only if **Status** = Paid
      </td>
    </tr>
  </tbody>
</Table>

## Example notification: invoice paid

```json
{
	"Status": "Paid",
	"Comment": "Invoice has been paid. Thank you for cooperation!",
	"AuthNumber": null,
	"CheckNumber": "01234567890",
	"Amount": 157.25,
	"PaidDate": "2018-08-20T15:02:04.4520807Z",
	"Header": {
		"WorkOrderId": 42,
		"BranchId": 501027,
		"Sender": {
			"Name": "Tyrion Lannister",
			"Phone": "+12025556632",
			"Type": "Customer"
		},
		"Action": "InvoiceStatusChanged",
		"ActionDate": "2018-08-20T15:02:04.3895801Z",
		"ApiVersion": "1.1",
		"MessageId": "cb8dd48d-6080-42d0-9739-e1b28642e530"
	}
}
```