API docs Billing Platform

Flows

Billing flows and payment lifecycle

All billing operations are performed through the operator web UI. The following flows are supported.

Details

Checkout invoice

One-time payment

1) Operator selects a plan in the billing UI. 2) A NOWPayments checkout invoice is created. 3) Operator completes payment via the NOWPayments checkout page. 4) NOWPayments webhook confirms payment status. 5) Workspace plan is upgraded upon confirmed payment.

Details

Email subscription

Recurring billing

1) Operator subscribes with an email address for recurring billing. 2) Recurring invoices are generated based on the plan cycle. 3) Payment reminders are sent to the billing email.

Details

Balance top-up

Prepaid credit

1) Operator initiates a balance payment in the billing UI. 2) Payment is processed via NOWPayments. 3) Workspace credit balance is updated.

Details

Subscription cancellation

30-day grace period

1) Operator cancels the subscription in the billing UI. 2) A 30-day grace period applies before access is downgraded. 3) During the grace period, all plan features remain available. 4) After the grace period, the workspace reverts to the Starter plan.

Details

Payment confirmation

Webhook-verified

Payments are confirmed via the NOWPayments webhook at POST /webhooks/nowpayments. The webhook handler verifies the HMAC-SHA512 signature before processing the event.

Related docs