← Back to KB index
Billing

Invoices, billing cycle, and Stripe portal

Where to find invoices, how billing cycles work, and how to update cards.

Billing cycle

All plans bill monthly on the 1st of the month at 00:00 UTC. New tenants are pro-rated

from signup date.

Stripe customer portal

Each tenant has a unique Stripe portal URL. Get it via:

curl -H "X-API-Key: $KEY" https://api.darkcoders.io/api/v1/v25/billing/portal

Returns a one-time URL valid for 1 hour.

Failed payment

After 1 failed charge, account enters payment_grace (7-day window).

After 7 days unpaid, account becomes read_only.

After 30 days unpaid, account is suspended (data retained 90 days then purged).

Annual prepay discount

Annual contracts pay 10 months upfront for 12 months service.

Invoice PDF

Latest 12 invoices: /api/v1/v25/billing/invoices?limit=12