Skip to main content

​
Overview

An invoice is a bill with line items, an optional tax rate, and a customer. Creating one automatically creates a payment to settle it — share that payment’s link with your customer and the invoice is marked paid the moment the payment completes.
Fetch the linked payment (GET /payments/{id}, using the payment_id from the invoice response) to get the shareable shortUrl for the customer. See Payment Links.

​
Amounts and tax

  • All money fields are integers in the smallest unit of the currency (cents): unit_price, subtotal, tax_total, total.
  • subtotal = Σ quantity × unit_price.
  • A single tax_percentage (0–100) applies to the whole subtotal: tax_total = subtotal × tax_percentage / 100, and total = subtotal + tax_total. Per-line tax rates are not supported.
  • currency is the pricing currency; settlement happens in USDC like every Ebioro payment.

​
Invoice statuses

Cancelling voids the invoice and expires its payment link. A paid invoice cannot be cancelled — refund the linked payment instead.

​
Customers

Attach a customer either by reference or inline:
  • customer_id — bill an existing customer again.
  • customer — create one inline: customer_type (individual | business), name, company_name, email, vat_number, address.
The customer appears on the invoice response and can be reused via its id on later invoices.

​
Invoice numbering

Numbers are minted gaplessly per merchant: prefix + sequence. Configure the prefix via the numbering settings:
  • The {year} token resolves to the current year at creation time (INV-2026-100). The sequence is continuous — {year} stamps the year but does not reset the counter each January.
  • next_number can only move forward, so an already-issued number is never reissued.
  • You can also pass an explicit invoice_number when creating an invoice; the gapless counter is skipped for that invoice.
GET /invoices/settings returns the current prefix, the next number, and a resolved preview ("INV-2026-5").