Invoices - Numero

An invoice is a request for payment backed by a dedicated one-time virtual account. You create the invoice with an amount; Numero mints a payment account for it; when the customer funds that account, a FUNDING_NOTIFICATION webhook fires and the invoice is automatically marked paid.

How it works

Create invoice   →  Numero returns an invoice number + a payment account
Share it         →  Send the customer the amount + payment account (or the hosted pay link)
Customer pays    →  They transfer into the invoice's virtual account
Auto-reconciled  →  Invoice flips to PAID and a webhook is delivered

Statuses

Status	Meaning
`PENDING`	Awaiting payment
`PAID`	Funded and reconciled
`CANCELLED`	Cancelled before payment; the payment account is retired

Endpoints

Method	Endpoint	Description
POST	`/api/v1/business/invoices`	Create an invoice
GET	`/api/v1/business/invoices`	List invoices
GET	`/api/v1/business/invoices/{invoiceNumber}`	Get an invoice
POST	`/api/v1/business/invoices/{invoiceNumber}/cancel`	Cancel an unpaid invoice