Skip to main content
POST
Email an invoice

Authorizations

Authorization
string
header
required

Your account's secret key: Authorization: Bearer sk_test_… or sk_live_…. Server-side only.

Headers

Idempotency-Key
string

A unique key per operation (a UUID works). Retrying with the same key returns the original response.

Path Parameters

invoiceID
string<uuid>
required

Invoice ID.

Response

Success.

What a customer owes: line items, totals and status. Status: draft → open → paid, or void / uncollectible.

id
string<uuid>
customerId
string<uuid> | null

The customer's product enrollment id. Set on product, usage and subscription invoices.

payerId
string<uuid> | null

The paying customer's id. Set on one-off invoices.

subscriptionId
string<uuid> | null

The subscription that generated the invoice

invoiceNumber
string | null

Sequential invoice number

status
enum<string>

draft (being built), open (issued, awaiting payment), paid, void (canceled) or uncollectible (written off).

Available options:
draft,
open,
paid,
void,
uncollectible
currency
string

Currency, as an ISO 4217 code (BRL).

subtotal
string

Sum of line items before tax and discounts.

tax
string

Tax on the invoice.

total
string

The invoice's final amount.

amountDue
string

How much is still owed.

periodStart
string<date-time> | null

Start of the billed period

periodEnd
string<date-time> | null

End of the billed period

dueDate
string<date-time> | null

Due date.

finalizedAt
string<date-time> | null

When the invoice was issued.

paidAt
string<date-time> | null

When the invoice was paid.

successUrl
string | null

Where checkout sends the buyer after payment.

cancelUrl
string | null

Where checkout sends the buyer if they back out.

createdAt
string<date-time>
lineItems
object[]