Billing & Plans
Flow App Studio uses a subscription model with four tiers. Each tier has limits on the number of projects, team members, and monthly sessions.
Plans
| Feature | Free | Basic | Gold | Diamond |
|---|---|---|---|---|
| Projects (apps) | 1 | Up to plan limit | Up to plan limit | Up to plan limit |
| Team members | 1 | Up to plan limit | Up to plan limit | Up to plan limit |
| Monthly sessions | 1,000 | Up to plan limit | Up to plan limit | Up to plan limit |
| Custom functions | ✓ | ✓ | ✓ | ✓ |
| API calls | ✓ | ✓ | ✓ | ✓ |
| Providers / channels | ✓ | ✓ | ✓ | ✓ |
Exact per-plan limits (max apps, sessions, team members) are shown during checkout and in your organisation’s Billing page.
Subscriptions
Subscriptions are billed through Paystack. You can choose:
- Monthly — billed each month on the anniversary of your subscription start date
- Annual — billed once per year at a discounted rate
Subscription statuses
| Status | Meaning |
|---|---|
ACTIVE | Subscription is current and sessions are being processed |
TRIAL | In the free trial period |
ONGOING | Payment in progress |
PAST_DUE | Payment failed; grace period active |
CANCELLED | Subscription was cancelled; access ends at period end |
EXPIRED | Subscription ended |
Auto-renewal is enabled by default. Disable it in Billing → Subscription → Cancel Auto-Renew.
Invoices
Every billing cycle generates an Invoice. Invoices go through these states:
| Status | Meaning |
|---|---|
DRAFT | Being prepared |
ISSUED | Sent and awaiting payment |
PAID | Payment confirmed |
OVERDUE | Payment not received by due date |
VOID | Cancelled invoice |
View and download invoices at Billing → Invoices in the web app (/main/invoices).
Payments
Flow App Studio processes payments via Paystack. Supported payment methods depend on your region (cards, mobile money, bank transfer).
When a payment is made, a Payment record is created and linked to the invoice. Webhooks from Paystack update subscription and invoice statuses automatically.
Usage Records
Usage is tracked monthly and resets at the start of each billing cycle:
| Metric | Tracked |
|---|---|
| Active apps | Projects with at least one session this month |
| Sessions | Total sessions across all projects |
| API calls | Total outbound API calls from flows |
You can view current month usage in Billing → Usage alongside your plan limits.
Upgrading or Downgrading
Change your plan from Billing → Subscription → Change Plan. Upgrading takes effect immediately. Downgrading takes effect at the end of the current billing period.
If you downgrade to a plan with lower limits and your current usage exceeds those limits, the Flow Engine will enforce the new limits at the start of the next billing cycle.
Passing quota data to the SDK
If you embed the FlowStudio component yourself, pass your organisation’s plan limits and current usage so the builder can show appropriate warnings:
<FlowStudio
api_key="..."
quota={{
plan: 'Gold',
max_apps: 20,
max_team_members: 10,
max_sessions: 50000,
current_apps: 12,
current_sessions: 31000,
}}
/>