Skip to main content

Invoice payment status

· One min read

As we are making progress on the grace period feature, which will allow you to review invoices before they are sent to customers, we have introduced changes to the API to add new invoice management options.

The invoice object included a status attribute with three possible values: pending, failed and succeeded. This attribute has been renamed payment_status for accuracy purposes (possible values remains unchanged).

In addition to this, a new status attribute has been created, including two possible values:

  • draft: when an invoice has been generated but can still be modified; and
  • finalized: when the invoice is validated and can no longer be modified.

All existing invoices are considered as finalized, you will not be able to use the draft status until the grace period feature is deployed (later this month).

Please contact us at if you have any questions, we will be happy to help.