The billing operations console is available to users with the billing admin or super admin platform role.
Overview
The operations hub links to five tools:| Tool | What it does |
|---|---|
| Refunds | Issue partial or full refunds across payment providers |
| Credits | Apply manual credits and adjustments to tenant accounts |
| Manual invoices | Create and track offline invoices for enterprise tenants |
| Failures & suspensions | Monitor payment failures and suspended accounts |
| PO review | Review and approve enterprise purchase orders |
Issuing refunds
Navigate to Billing > Operations > Refunds to issue a refund.Enter tenant and charge details
Provide the Tenant ID, select the payment provider (Stripe, Paystack, or Flutterwave), enter the Charge ID from the provider, and the refund amount in dollars.
Confirm with a reason
Click Issue Refund to open the confirmation dialog. Enter a reason for the refund — this is recorded in the audit log.
Applying credits
Navigate to Billing > Operations > Credits to apply a manual credit. Provide the Tenant ID and the credit amount in dollars. Click Issue Credit and enter a reason. Credits are applied in USD and tracked in the tenant’s billing ledger. Use credits for:- Goodwill adjustments after a service disruption
- Promotional offers or onboarding incentives
- Correcting billing errors
Creating manual invoices
Navigate to Billing > Operations > Manual Invoices to create an offline invoice for tenants that pay outside the standard billing flow — for example, government agencies or enterprises using wire transfers.Monitoring payment failures
Navigate to Billing > Operations > Failures & Suspensions to view tenants with failed payments or suspended accounts. This page surfaces accounts that are progressing through the payment failure lifecycle so you can intervene before access is fully suspended.Reviewing purchase orders
Navigate to Billing > Operations > PO Review to manage enterprise purchase orders. The review queue shows submitted POs with their amount, status, and submission date. Approve a PO to activate billing against the order balance, or reject it with a reason that is sent back to the submitting tenant. For details on how tenants submit purchase orders, see purchase order billing.Tenant billing monitoring
Navigate to Billing > Tenants to see a dashboard of billing health across all tenants. The page shows:- MRR summary — total monthly recurring revenue across all tenants.
- Status breakdown — counts of active, trial, past due, and canceled subscriptions.
- Tenant table — each row shows the tenant name, plan, subscription status, payment provider, last payment date, and MRR contribution.
Dunning overrides
When a tenant’s payment fails, the billing system moves them through a graduated dunning lifecycle (degraded, restricted, suspended). You can override this behavior from the tenant billing detail page. Click Override Dunning to open the dunning override dialog. The dialog has four fields:| Field | Description |
|---|---|
| Contract mode | Controls how the dunning lifecycle behaves for this tenant. See the table below. |
| Force state | Immediately set the tenant to a specific billing state. Leave as “No Change” to keep the current state. Options: Active, Past Due, Unpaid, Suspended. |
| Grace extension (days) | Add extra days to the tenant’s grace period before the next dunning stage kicks in. |
| Reason | Required. A note explaining the override — for example, a support ticket number or billing dispute reference. |
Contract modes
| Mode | Behavior |
|---|---|
| Standard (Auto) | Default. The system automatically retries failed payments and progresses through dunning stages on a fixed schedule. |
| Enterprise (Manual) | Disables automatic retries. The tenant stays in their current state until a billing admin manually intervenes — useful for enterprise accounts that pay by wire or PO. |
| Government (No Retry) | No automatic retries. Designed for government procurement workflows where payment timelines are outside your control. |
- Restore access during a billing dispute by forcing the state back to
Active - Extend a grace period while waiting for a wire transfer by adding grace days
- Switch to manual dunning after signing an enterprise contract by changing the contract mode to Enterprise
- Accommodate government procurement timelines by switching to the Government mode, which prevents automatic suspension
Grace period controls
You can grant a temporary grace period that extends a tenant’s access to a specific metric beyond their plan limit. From the tenant billing detail page, click Add Grace to open the grace period dialog:| Field | Description |
|---|---|
| Metric | The usage metric to extend. Available metrics: Verifications, Mints, Webhook Endpoints, Storage (Bytes). |
| Extra allowance | Number of additional units to allow beyond the plan limit. |
| Duration (hours) | How long the grace period lasts before it expires automatically. |
Available metrics
| Metric | What it controls |
|---|---|
| Verifications | Additional verification API calls beyond the plan quota |
| Mints | Additional attestation mints beyond the monthly limit |
| Webhook Endpoints | Extra webhook endpoint slots beyond the plan maximum |
| Storage (Bytes) | Additional storage capacity in bytes |
Entitlement overrides
Platform admins can set per-tenant feature flags and quota overrides that take precedence over the tenant’s plan entitlements. Use this for custom agreements, pilot programs, or temporary access grants. From the tenant billing detail page, open the Override dialog:- Quotas — set numeric overrides for specific metrics (e.g. increase
attestations.mintto 10,000 or setseatsto 10). - Features — toggle feature flags as a JSON object (e.g.
{"offline_bundles": true}to enable a feature not included in the tenant’s plan).
Related
Billing overview
Plans, rate cards, entitlements, and payment failure lifecycle.
Partnership pricing
Create custom rate cards for partner tenants.
Tenant management
Per-tenant billing detail and subscription management.
Platform staff
Staff roles including billing admin permissions.