BillingPaying
Paying for Pro
Pro is $5 a month, charged in Naira through Flutterwave's hosted page by card or bank transfer. How the Naira price is set, how monthly renewal and the 7-day grace period work, cancelling and resuming, invoices and the emails owners get.
Who pays
Only the team's owners can pay for Pro, cancel or resume it, and see invoices and the card on file. Admins and members see which plan the team is on. Paying needs an owner signed in to the web app: API tokens can read the billing state but never change it.
The price in Naira
Pro is $5 a month. You pay in Naira:
- The Naira price is the dollar price at a rate Orbits sets, rounded up to a whole ₦100. The billing page and the upgrade prompt show it.
- When you start paying, that amount is locked on the invoice, and it's exactly what's charged, even if the rate changes before you finish.
- If the price changes between the moment you saw it and the moment you press pay, Orbits stops and shows you the new price instead of charging something you didn't see.
Pay for Pro
- On the team's billing page, choose to upgrade to Pro. The Naira price is shown.
- You're sent to Flutterwave's hosted payment page. Pay by card or bank transfer.
- Flutterwave sends you back to Orbits, which checks the payment.
- When Flutterwave confirms it, the team is on Pro. Everything Pro includes works at once.
A card payment usually confirms in seconds. A bank transfer can take longer to arrive: the page says the payment is pending, and the team becomes Pro as soon as the money lands, even if you closed the page.
Nothing is granted until Flutterwave confirms the payment for the full amount on the invoice, in Naira. If a payment fails or isn't for the right amount, nothing changes and you can try again, which starts a new payment.
Your month
A paid month runs from the day you pay to the same day of the next month (Lagos time). Short months are clamped: a month bought on 31 January runs to 28 February, then to 31 March.
Paying again while Pro is still running buys the month after the current one.
Renewal
Pro renews by itself each month.
- 3 days before the month ends, Orbits makes the renewal invoice, at that day's rate. Its amount doesn't change after that. Owners get an email saying the renewal is coming and whether the card will be charged or they need to pay.
- When the month ends, the saved card is charged.
- If that fails, it's tried again 1, 3 and 5 days after the month ended.
Each try has its own reference, and a charge is never repeated while an earlier one is still being processed, so a card is never charged twice for one month.
The grace period
If the card fails, Pro keeps working for a 7-day grace period from the end of the month, while the tries above run. Owners get a "payment failed" email on the first failure and a reminder the day before grace ends. If nothing is paid by the end of grace, the team goes back to Free (see when Pro ends). Nothing is deleted, and paying again brings everything back.
If you paid by bank transfer
A bank transfer leaves no card to charge, so teams that pay by transfer renew by paying on the billing page. The owners are told when the renewal is due, and Pro runs on through the grace period while they pay. The same goes for a card that can't be charged without your approval each time.
Paying a renewal early or late
The billing page can pay an open renewal at any time, at its locked price. Paying early renews early: the new month starts from the end of the one already paid. Paying during grace starts the new month from the day you pay.
Paying a renewal by card makes that card the one on file. Changing the card any other way isn't available yet.
Cancel and resume
Cancel stops Pro renewing. The team keeps Pro until the end of the month already paid, then goes back to Free. The renewal invoice is voided and nothing more is charged.
Resume, before that month ends, undoes the cancellation: Pro renews again as before. After the month has ended, the plan is gone; upgrade again to start a new one.
Cancelling doesn't delete anything. A plan Orbits granted itself can't be cancelled.
Invoices and receipts
The billing page lists the team's invoices, newest first: payments made for Pro. Payments started but never finished aren't listed.
Each invoice shows:
| Kind | A first purchase, a renewal, or a payment made by hand |
| Amount | The dollar price, the Naira amount charged and the rate it was converted at |
| Period | The month it paid for |
| How it was paid | Card (with its brand and last four digits) or bank transfer |
| Reference, paid on | The payment's reference and date |
Open one to see it as a receipt: who paid, for which team, what for, and the card. There's no PDF; the receipt is a page you can print. Invoices are kept for good, even if the team is deleted, because they're the record of money taken.
Emails
Owners get, at most once for each invoice:
| When | |
|---|---|
| Receipt | A payment went through |
| Renewal coming up | 3 days before the month ends, saying whether the card will be charged or you need to pay |
| Payment failed | The first time a renewal charge fails |
| Grace ending | 1 day before the grace period ends |
| Back on Free | The team went back to Free |
Owners also see a notice about the plan while a renewal is coming up, a payment has failed, Pro is set to end, or for 30 days after the team went back to Free.
Plan changes, cancellations, resumes and failed payments are lines in the team's activity feed.
From the API
Owners only, signed in:
| Call | |
|---|---|
GET /v1/teams/{team}/billing | The plan, status (free, active or past_due in grace), the current period, the next charge, the card (owners) and the notice. Any member can read it |
POST .../billing/checkout | Start paying. Body: expected_ngn (the price you were shown) and return_path. Answers with Flutterwave's page. 409 price_changed if the price moved |
POST .../billing/verify | With tx_ref, after returning from Flutterwave: paid, pending or failed |
POST .../billing/cancel, .../resume | Cancel at the end of the month, or undo it |
GET .../billing/invoices, .../invoices/{invoice} | Invoices, and one as a receipt |
A 503 billing_unavailable means Pro can't be bought or checked right now; try again shortly. See API › Billing.