Invoices
Create, send, and track one-shot or recurring invoices.
An invoice bills a customer for a fixed amount, once or on a recurring cycle. See Billing → Invoice for the full product guide.
private key required, live only
Invoice endpoints require the private key (sk...) and are only available in the live
environment. There is no sandbox invoicing.
Endpoints
| Method | Path | Description |
|---|---|---|
POST | /invoices | Create an invoice |
GET | /invoices | List invoices |
GET | /invoices/{id} | Retrieve an invoice |
PUT | /invoices/{id} | Update an invoice (only if editable) |
DELETE | /invoices/{id} | Delete an invoice (only if editable) |
POST | /invoices/{id}/send | Mark the invoice as sent |
POST | /invoices/{id}/mark-paid | Mark the invoice as paid (full or partial) |
POST | /invoices/{id}/cancel | Cancel an invoice |
Recurring invoices
Set is_recurring: true and a recurring_frequency on creation to have Wajub automatically
generate the next invoice at the end of each cycle. See
Billing → Recurring invoices for the full workflow.
Events
Every status change (sent, paid, overdue, cancelled) is delivered as a single invoice.updated
event. Check data.status to see which one occurred. See the
full event catalog.
| Event | Trigger |
|---|---|
invoice.created | A new invoice was created |
invoice.updated | The invoice changed, sent, marked paid, overdue, or cancelled |
invoice.deleted | The invoice was deleted |