Account

An Account is a named customer of your organization — usable for both companies and individuals. Each account can have one or more Subscriptions, Recipients for notifications, Payment Cards, and pending Draft Invoice Lines. The code field is the external identifier you control; the uuid is generated by Fenerum.

Subscribe an account to a plan

The POST /api/v1/accounts/{code}/subscribe/ endpoint creates a new subscription on the account and cancels all other subscriptions on the same account. If a subscription is being replaced, Fenerum issues a pro-rated invoice immediately.

Do not use this endpoint together with the Create Subscription endpoint — they have overlapping semantics and combining them will produce unexpected cancellations. See the charging options docs for the financial consequences of replacing a subscription.

Generate an invoice for an account

The POST /api/v1/accounts/{code}/generate_invoice/ endpoint creates an invoice containing every draft invoice line on the account that is not flagged include_in_next_renewal_invoice. A separate invoice is produced for each distinct currency used by those lines. The response is an unpaginated list of all invoices created.