Skip to main content
The billing operations console gives billing administrators a single page to manage financial operations across all tenants. Navigate to Billing > Billing Operations in the platform console.
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:

​
Issuing refunds

Navigate to Billing > Operations > Refunds to issue a refund.
1

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.
2

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.
3

Refund is processed

The refund is submitted to the payment provider. The tenant and amount are logged for billing reconciliation.
You can issue partial refunds by entering an amount less than the original charge. The charge ID is available from the provider’s dashboard or from the tenant’s invoice history.

​
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.
Click any row to open the tenant billing detail page, which shows the tenant’s subscription, entitlement quotas, recent invoices, and admin action controls.

​
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:

​
Contract modes

Use dunning overrides when you need to:
  • 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
Dunning overrides bypass the standard payment enforcement lifecycle. Every override requires a reason and is recorded in the audit log. Use the Force State option sparingly — it immediately changes the tenant’s billing state regardless of payment status.

​
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:

​
Available metrics

Active grace periods are listed below the controls with their metric name, extra allowance, and expiration date. Each grace period expires independently — you can have multiple active periods for different metrics at the same time.
Grace periods are useful for onboarding scenarios where a tenant needs temporary headroom while evaluating an upgrade. For permanent changes, use entitlement overrides instead.

​
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.mint to 10,000 or set seats to 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).
Overrides persist until you remove them. They do not expire with the billing cycle.
Entitlement overrides bypass plan-level enforcement. Use them sparingly and document the reason in the tenant’s notes.

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.