Skip to content

Invoices (TenaBill) ​

Invoices are the core billing record in TenaBill. Each invoice belongs to a customer and can be paid through the hosted billing portal or a direct checkout session.

Console: TenaBill merchant console → Invoices (/invoices)

Invoice statuses ​

StatusMeaning
OpenAwaiting payment
PaidPayment collected
VoidCancelled; will not be collected
UncollectibleMarked as bad debt

View invoice detail ​

Click any row to expand the invoice detail panel. You can see line items, due date, and dunning history.

Send a payment reminder ​

With an invoice selected, click Send reminder. TenaBill sends a invoice.payment_reminder email to the customer using the configured email template and branding.

You can also trigger reminders programmatically via POST /api/v1/console/invoices/{id}/remind.

Dunning ​

TenaBill tracks automatic retry and reminder attempts in the dunning log visible on each invoice detail view. Dunning emails use the dunning.overdue template category configured in Settings → Email templates.

Create invoices ​

Invoices are created via the API. The console list is read-only to preserve your billing logic as the authoritative source:

http
POST /api/v1/console/invoices
X-TenaBill-Api-Key: <your-key>

{
  "customerId": "cust_abc",
  "lineItems": [{ "offeringId": "off_xyz", "quantity": 1 }],
  "dueDate": "2026-07-01"
}

Hosted checkout ​

Generate a pay link for any open invoice:

http
POST /api/v1/console/checkout/sessions
{ "invoiceId": "inv_abc" }

Share the returned checkoutUrl with your customer; the /pay/ portal handles Stripe collection.

TenaBill billing documentation