Invoices (TenaBill)

Invoices are the core billing record in TenaBill. Each invoice belongs to a customer and is collected through the hosted billing portal or authorized checkout links included in reminder emails.

Console: TenaBill merchant console → Invoices (/invoices)

Invoice statuses

Status	Meaning
Open	Awaiting payment
Paid	Payment collected
Void	Cancelled; will not be collected
Uncollectible	Marked as bad debt

View invoice detail

The console Invoices page is read-only. Click Details on any row to open a side panel with status, total, created date, and customer contact information. The console does not send payment reminders, show dunning history, or mutate invoices.

Create invoices

Invoices are created via the merchant API (/api/v1/merchant/* with X-TenaBill-Api-Key). The console list is read-only to preserve your billing logic as the authoritative source:

POST /api/v1/merchant/invoices
X-TenaBill-Api-Key: <your-key>
Content-Type: application/json

{
  "customerId": "00000000-0000-0000-0000-000000000001",
  "currency": "USD",
  "lines": [
    { "description": "Pro plan", "unitAmount": 49.00, "quantity": 1, "offeringCode": "pro-monthly" }
  ]
}

See API keys for merchant authentication.

Payment reminders and dunning

Payment reminders and overdue dunning notices are not available from this console page. TenaBill sends them through background automation (dunning worker) and your server-side integrations. Customize the email content under Settings → Email templates (invoice.payment_reminder and dunning.overdue categories). See Email templates.

Collect payment

Customers pay open invoices through the billing portal — not from this console page. Send a portal magic link (see Customers) or rely on automated reminder emails; those flows include an authorized checkout URL. Configure Payments (Stripe Connect) before customers attempt checkout.

Related

• Customers — who owns each invoice
• Catalog — offerings referenced by line items
• Payments — Stripe Connect setup required for collection
• Webhooks — invoice.paid event
• Email templates — reminder and dunning email content