Skip to navigation
API ReferenceInvoices

Void an Invoice

Cancels a sent, unpaid Invoice so it can no longer be paid. Its number is kept and never reused. Refused for a draft, a paid Invoice, or while a Customer is paying it right now. The Idempotency-Key header is required.

Authentication

AuthorizationBearer

Your secret key: sk_test_… in Test mode, sk_live_… in Live mode.

Path parameters

idintegerOptional
Invoice identifier.

Headers

idempotency-keystringRequired>=1 character

Client-generated key; a repeated key returns the original result instead of repeating the change.

Response

The voided Invoice, or the original result of a retried key.
idinteger
Invoice identifier.
numberstring or null

The Invoice number, such as INV-0007. Assigned when the Invoice is sent, so a draft has none; numbers are never reused.

statusenum

draft until sent and editable only from the dashboard. sent: the Customer can pay it. paid: paid in full. void: you voided it; it can no longer be paid.

Allowed values:
overdueboolean

A sent, unpaid Invoice past its due date (Pacific/Fiji). Derived, not a status; the Customer can still pay.

modeenum

test for an Invoice made with an sk_test_ key, live for an sk_live_ key.

Allowed values:
customerNamestring
Who you billed.
customerEmailstring or null
The Customer's email, if you gave one.
itemslist of objects
The line items, excluding tax.
taxLabelstring or null

Label of the tax line; null if none.

taxPercentdouble
0 when there is no tax line.
vatNumberstring or null
Your VAT number, if you gave one.
dueDatestring

YYYY-MM-DD, Pacific/Fiji.

subtotalinteger

Sum of the line items, in FJD cents (minor units).

taxinteger

The tax line, in FJD cents (minor units).

totalinteger

Amount due; under FJD 5,000.00, in FJD cents (minor units).

urlstring
The hosted page the Customer opens and pays on. Works once the Invoice is sent.
pdfUrlstring or null

Where to GET the PDF, with your secret key. Null on a draft.

createdAtinteger
Unix ms timestamp the draft was created.
sentAtinteger or null

Unix ms timestamp it was sent; null on a draft.

paidAtinteger or null

Unix ms timestamp it was paid; null until then.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error