Create an invoice
POST/invoices
Creates a draft. The total is computed server-side from the line amounts
plus tax_amount; the draft is not payable until it is sent.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
Currently supported currencies by Paygasus Pay
Example
USDCustomer display name.
Unix epoch milliseconds. Overdue is derived from this while the invoice is open — never stored as a status.
One display line on the invoice. Amounts are minor units, like every amount on the wire (design.md §5).
object
A monetary amount in the currency’s minor units (e.g. cents for USD).
Example
1000Human display label (e.g. INV-1044). Never used as an identifier or
in a URL — the opaque id is the only reference.
Tax in minor units. The server computes total = lines + tax; a
client-supplied total is not accepted anywhere on this API.
Example
1000Responses
Section titled “Responses”Invoice created as a draft
object
Currently supported currencies by Paygasus Pay
Example
USDUnix epoch milliseconds.
One display line on the invoice. Amounts are minor units, like every amount on the wire (design.md §5).
object
A monetary amount in the currency’s minor units (e.g. cents for USD).
Example
1000Unix epoch milliseconds; set once paid.
Set once sent: the stable invoice payment URL the customer pays at.
A monetary amount in the currency’s minor units (e.g. cents for USD).
Example
1000Server-computed: sum of line amounts + tax_amount.
Example
1000Invalid request
object
object
When present and true, the caller may retry the same request.