Platform / Flows
Billing flows and payment lifecycle
All billing operations are performed through the operator web UI. The following flows are supported.
01 Checkout invoice
detailsOne-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.
02 Email subscription
detailsRecurring 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.
03 Balance top-up
detailsPrepaid credit
1) Operator selects a paid plan and deposit currency. 2) NOWPayments creates a sub-partner balance payment. 3) The funded provider balance supports recurring plan renewal. Recurring provider credentials must be configured.
04 Subscription cancellation
detailsAccess through provider expiry
Canceling stops the provider subscription. Paid access remains only until the subscription's recorded expire_date; there is no additional fixed 30-day cancellation grace period. Reconciliation returns the workspace to Starter after entitlement expires.
05 Payment confirmation
detailsWebhook-verified
POST /webhooks/nowpayments verifies the HMAC-SHA512 signature, stores a deduplicated inbox event, enqueues durable processing, and returns 202. Invalid signatures return 401; persistence or enqueue failures return 503. Background processing retries up to 20 attempts and plan reconciliation is safe to repeat.
Related docs
see also