Invoices

Create and manage invoices for your customers.

The Invoice object

{
  "id": "inv_abc123",
  "object": "invoice",
  "customer": "cus_xyz789",
  "status": "open",
  "currency": "xof",
  "amount_due": 175000,
  "amount_paid": 0,
  "due_date": "2026-03-15",
  "hosted_invoice_url": "https://invoice.ikawaari.com/inv_abc123",
  "created": 1708300800
}

Endpoints

Method	Endpoint	Description
POST	/v1/invoices	Create an invoice
GET	/v1/invoices/{id}	Retrieve an invoice
PATCH	/v1/invoices/{id}	Update a draft invoice
POST	/v1/invoices/{id}/finalize	Finalize an invoice
POST	/v1/invoices/{id}/void	Void an invoice
GET	/v1/invoices	List invoices