Billing & Subscription Invoices

The Billing area covers the partner contract — your white-label agreement with SabiBooks. It is distinct from Customer Invoices, which are the invoices your merchants issue to their customers.

Page	Path	Purpose
Billing Overview	/billing	Current plan, merchant usage, monthly fee, recent invoice history at a glance
Subscription Invoices	/billing/invoices	Full filterable history of invoices SabiBooks has issued to your partner account

Note

The Billing area is read-only. Partners pay monthly fees via bank transfer; the portal does not collect payment on these invoices.

Billing Overview (/billing)

The overview gives you a single screen with everything you need to confirm your billing position is healthy.

Top Metrics

Two cards at the top:

Card	Shows
Next Invoice	The date your next monthly invoice will be generated.
Last Invoice	The status and amount of your most recent invoice — or “No invoices yet” before the first billing cycle.

Billing Plan Card

Shows the current contract tier and contract period:

• Plan badge — current tier label: Starter, Growth, or Enterprise.
• Contract Period — start and end date for your current contract.
• Status — active or expired.

Merchant Usage Card

Tracks how many merchants are active under your partner account against your contract’s included merchant count.

Element	Description
Active count	Total merchants currently active under your partner.
Included	Number of merchants included in the base monthly fee.
Progress bar	Visual usage indicator with a 12 of 10 merchants used-style label.
Overage alert	When active count exceeds included, an amber alert: “You have N merchants above your included limit. Overage fees will apply.”

Monthly Fee Card

Breaks down the projected monthly fee for the current period:

• Base monthly fee — flat fee for the contract tier.
• Per-merchant overage — (active − included) × per-merchant rate when active > included; otherwise zero.
• Total — sum of base + overage. This is what your next invoice will reflect (assuming no contract changes).

Invoice History Preview

Lists your most recent invoices. Empty state: “No invoices have been generated yet. Your first invoice will be created on <date>.” Includes a View all invoices link to the full history.

Subscription Invoices (/billing/invoices)

The dedicated history page with filters and pagination.

Header

Subtitle on the page makes the read-only nature explicit: “View all invoices for your partner account. Payments are made via bank transfer.”

Status Filters

Filter chips at the top of the page let you narrow the history by status:

Filter	Meaning
All	Default — every invoice ever issued.
Sent	Invoice issued and awaiting payment.
Paid	Invoice fully reconciled.
Overdue	Past due date with outstanding balance.
Draft	Generated but not yet sent.
Void	Cancelled invoice — kept on record but not collectible.

Filters apply immediately on click; only one filter is active at a time.

Invoice Rows

Each row in the table shows:

Column	Description
Invoice number	Auto-generated identifier (e.g. PINV-2026-0001).
Period	Billing period the invoice covers (start–end date).
Issued	When the invoice was generated.
Due	Payment due date.
Amount	Total amount in Naira.
Status	Coloured badge matching the status filter values above.

Click any row to open the invoice detail page.

Pagination

The list paginates at 10 invoices per page. Navigation controls at the bottom move between pages and display the total count.

Empty State

Before your first billing cycle: “No invoices yet — Invoices will appear here once your first billing cycle is complete.”

Invoice Detail (/billing/invoices/:id)

Clicking any invoice opens the detail page with:

• Invoice header — number, issue date, due date, status badge.
• Period — the date range this invoice covers.
• Merchant count — how many merchants were active during the period (the basis for any overage calculation).
• Fee breakdown — line items showing base fee, per-merchant overage (if any), tax (if applicable), and the totals.
• Totals — subtotal, tax, total amount.
• Payment status — whether the invoice has been reconciled.
• Payment history — any recorded bank transfer references, dates, and amounts.

Reconciling Invoices

Bank transfer is the only collection channel for partner invoices. To reconcile a payment:

1. Receive the invoice from SabiBooks (sent via your billing email).
2. Initiate the bank transfer using the account details on the invoice.
3. Email the bank transfer reference to your account manager.
4. SabiBooks records the payment against the invoice; status updates to Paid within 1 business day.

If a payment doesn’t reflect on /billing/invoices within 2 business days of transfer, contact your account manager with the bank transfer reference.

Common Tasks

Check next invoice amount before it’s generated

1. Open /billing (Billing Overview).
2. The Monthly Fee card’s Total is what the next invoice will reflect.
3. Cross-check against the Merchant Usage card — if you’re over the included count, the overage fee is included in the total.

Find an invoice for a specific period

1. Open /billing/invoices.
2. Use the status filter chips to narrow if you remember the status (e.g. Paid).
3. Page through the history to find the period you need.
4. Click the row to view the full breakdown.

Forecast overage fees for next month

1. Open /billing and check Merchant Usage for the current active count.
2. Estimate the count at month-end based on your onboarding pipeline.
3. Apply: (estimated_active − included) × per_merchant_rate from the Monthly Fee card.

Billing Troubleshooting

Problem	Possible Cause	Solution
Last Invoice shows “No invoices yet” but my contract is active	Contract started mid-month or first cycle hasn’t completed	Check the Next Invoice card for the date your first invoice will be generated.
Status filter shows zero invoices	No invoices match the selected status	Click All to see the full history.
Overage alert shows when I haven’t onboarded any new merchants	A previously inactive merchant became active again	Cross-check the active list at /merchants?status=active.
I paid but status is still Sent	Payment not yet reconciled by SabiBooks	Allow up to 2 business days, then contact your account manager with the bank transfer reference.
Cannot pay through the portal	Read-only by design	All partner payments are by bank transfer. The portal is for tracking only.

Related Pages

Customer Invoices The invoices your sponsored merchants issue to their own customers — distinct from your partner billing.

Partner Portal Overview Portal introduction, login, navigation, and roles.