Vivid Connect
Business login

What Vivid Connect is

Vivid Connect turns an internet line you already pay for into a business. You point a MikroTik router at the platform, set your own prices, and customers nearby buy internet from you, paying with Mobile Money or a card on their phone and getting connected automatically, with their voucher on WhatsApp as a backup. Their device is remembered until the plan ends, so they come back on without a code.

You keep control of the things that are yours: your prices, your packages, your customers and your earnings. The platform handles the parts that are tedious to build and easy to get wrong: taking payments, enforcing how much data or time each customer actually gets, sending the messages, and paying your earnings into your own account.

A word on how the internet gets shared

Vivid Connect uses RADIUS, the same standard that internet providers and large WiFi networks have used for decades to decide who is allowed online and for how long. In practice it means two useful things for you:

What you need

WhatNotes
A MikroTik routerRunning RouterOS 7.1 or newer. A hAP-series unit is plenty to start; ask us if you are unsure which to buy, or see our buyer's guide: Which router to buy. Most units sold today already have RouterOS 7. Older stock still ships with RouterOS 6, and that is fine: onboarding notices and updates it (see RouterOS version below).
A WiFi access pointOptional at first. The MikroTik's own WiFi is fine for your first customers.
An internet lineStarlink, fibre, fixed wireless, anything with bandwidth to spare.
Your phone or a computerTo onboard the router: the Vivid Connect app (Google Play or the App Store) does it in one tap, or use the onboarding kit on a Mac, Windows or Linux computer. Afterwards your dashboard runs in any browser, phone included.
A WhatsApp number for the businessVouchers and alerts are sent from it. Use a number you are happy to give customers.
A MoMo wallet or bank accountWhere your earnings are paid. It must be registered in the business owner's name.

Create your account

  1. Sign up. Go to the sign-up page and register your business.
  2. Verify your account. Follow the verification step so we know the account is really yours.
  3. Pick the free trial package. Once your account is verified, choose the free trial from the package list. That is what starts your 14 days: no platform fee at all, one router, nothing charged and no card required. When the 14 days end your account moves to Pay As You Earn by itself. We send you a WhatsApp to say so; there is no plan to choose and selling carries on. Pay As You Earn is 6% of each online sale, and the same rate on cash and voucher sales you record, and nothing else: no setup fee, no monthly fee, and the payment provider's charge on online sales is on us, so you keep 94%. The package page then only lists add-ons: an extra router (GH₵150 once, one more router on your account) and assisted onboarding (GH₵150 once; we arrange it with you on WhatsApp after you buy it), with more to come.
  4. Tell us where your money should go. Add the MoMo wallet or bank account that should receive your earnings. You can do this now or before your first sale.
About the payout account. The name registered on the MoMo line or bank account has to match what our payment provider can verify. If a payout account is edited later it may need verifying again. If earnings ever stop arriving, that is the first thing to check with us. One more thing if you earn from businesses that pay through their own gateway: your share from them sits on a subaccount on their Paystack account, so when you change your payout account they have to verify the new one on their dashboard before that share flows again. Their sales continue and your share is held until they do. Changing your account is allowed at any time, but the platform is not responsible for share delayed or lost while a business has not verified it.

Onboard your router

Onboarding is what connects your router to your account. It is done once per router, from the Vivid Connect app on your phone or from a computer, and it configures the hotspot, the secure tunnel to Vivid Connect, the customer login page and the authentication link for you. If the router is still on RouterOS 6 it is updated to RouterOS 7 during the same run; you never touch the router's own software.

Whichever way you go, prepare the router the same way first:

  1. Always start from a freshly factory-reset router. Onboarding expects a clean device. Do this even for a brand-new router, and especially if an earlier attempt stopped partway (a power cut or lost connection): factory-reset it again before trying once more. A router carrying an old or half-finished configuration is a common cause of trouble.
  2. Cable the internet into port 1 (ether1) and wait for the port light to come on. This can take up to five minutes on a fresh line. Do not start the next step before the light is on. This is the single most common reason onboarding fails.
  3. Leave port 3 free. It becomes your hotspot port; your customers' WiFi access point plugs in there when setup is done.

RouterOS version

The router must run RouterOS 7.1 or newer. Onboarding talks to the router over its REST API, which only exists from RouterOS 7.1, and the private tunnel to Vivid Connect is WireGuard, which only exists in RouterOS 7. Most routers sold today already run 7. Older stock still ships with RouterOS 6.49, and both onboarding tools check for that first:

You do not need to update the router yourself, and we do not recommend logging into it to try. Both onboarding tools do the update for you; all the router needs is internet on port 1. If the update stops partway (a power cut, the line dropping mid-download), factory-reset the router and run onboarding again; it will pick up the update from the start. After the update the router is on RouterOS 7.1 or newer, which is what the tools install.

With the app on your phone (recommended)

  1. Get the phone onto the router. If the router has built-in WiFi, join its WiFi (the name starts with MikroTik). If it does not, plug your WiFi access point into port 2 or port 4 and join the access point's WiFi.
  2. Tap Test router connection. Setup will not start until the app can actually see the router, so a cabling or WiFi mistake is caught before anything begins. On an iPhone, if the test keeps failing, check that Local Network access is allowed for the app in Settings; iOS asks once and silently blocks everything if it was declined.
  3. Have the router's password ready. The app tries the factory defaults itself. If your router shipped with a password printed on its sticker, the app asks you to type it, once, and never stores it.
  4. Open the Routers tab and tap Set up a router. The app guides you from there; one tap does the rest, and it tells you the moment the router is live on your account.
If setup stops partway - a power cut, a dropped connection, anything - factory-reset the router and start over from the beginning. Nothing is lost and nothing is counted against your account by an unfinished attempt. If you retry very soon after the reset, the app may pause on "waiting for its factory reset to finish" - that is normal; the router takes a minute to finish applying its reset, and the app simply waits it out.
Once a router is live, the app gives you its everyday controls: power-cycle it, choose which ports carry the hotspot, and switch its device mode. If a router dies, you do not repair anything: onboard the replacement the same way and move on.
No token is needed on the phone path. The app arranges its own onboarding token behind the scenes. Generating tokens by hand eats into your account's limited token allowance and can block the app from arranging its own.

With a computer

  1. Connect the computer to the router. A computer with a LAN port cables into port 2 or port 4; this is the most reliable way. A WiFi-only computer joins the router's built-in WiFi if it has one; if the router has no WiFi either, plug your access point into port 2 or port 4 and join the access point's WiFi.
  2. Generate an onboarding token. In your dashboard, open Onboard New Router and pick the With a computer tab; the token buttons are in step 1 there. An unused token stays copyable on the tokens page until it is used, so you never need to generate a second one because you forgot to copy the first.
  3. Open the terminal. Mac: press Cmd+Space, type Terminal, press Enter. Windows: press the Start key, type PowerShell, press Enter (PowerShell, not Command Prompt). Linux: any terminal.
  4. Paste one line and press Enter. The same page shows it with a copy button. It fetches the latest onboarding kit and starts it; there is nothing to download and nothing for macOS or Windows to block.
    Mac / Linux: bash -c "$(curl -fsSL https://isp.vividsolutionstech.com/onboard.sh)"
    Windows: iex (irm https://isp.vividsolutionstech.com/onboard.ps1)
    Python 3 is needed; the kit checks for it and, if it is missing, offers to install it for you (Mac: Homebrew or the python.org installer; Windows 10 and 11: winget; Linux: your package manager), then continues. If your Mac asks whether Terminal may access the local network, click Allow: that is how the kit reaches the router.
  5. Follow the prompts. Paste your token, give the router a recognizable name, and let it finish. The summary at the end includes the router's new admin password. For the next router, paste the same line again; it always fetches the latest kit.
  6. Watch your dashboard. The router appears as online when it has finished. That is onboarding complete.
The script behaves the same way the app does: it tries the factory login itself and asks for the sticker password only when the router has one, it waits patiently if the router was reset moments ago, and if a run fails partway the recovery is always the same - factory-reset the router and run it again. An unfinished attempt costs you nothing.

Connect WhatsApp

WhatsApp is how your business talks to customers, and how it talks to you. Connect it early: customers expect their voucher to arrive the moment they pay.

What your customers receive

What you receive

To set it up, open the WhatsApp section of your dashboard and follow the pairing steps with the phone holding your business number. Messages then come from your own number, in your own business name.

How the connection works, and why we recommend a dedicated number

Vivid Connect sends WhatsApp messages through the Baileys architecture - the same device-sync mechanism behind WhatsApp Web and "Linked devices" on your phone. That is what lets your business message customers automatically from your own number, with no API key and no per-message fees. The trade-off is honest: linking works by sharing your WhatsApp session with the platform, the same way linking WhatsApp Web to a browser does.

For that reason we recommend you create a fresh WhatsApp (or WhatsApp Business) account on a dedicated SIM for the business, and link that - not your personal number. Your personal chats stay entirely yours, the business number can be handed to staff later, and if you ever want to sever the link you can simply log the device out from WhatsApp's Linked devices screen at any time.

Use a number you will keep. Customers reply to it, and changing it later means re-pairing.

The mobile app

Everything in this guide can also be done from the Vivid Connect app for Android, and some things are easiest there. It is the fastest way to onboard a router (one tap, no token, no computer), and it carries the business in your pocket: live sales, who is online right now, packages, vouchers, customer top-ups and your income.

Don't have the app yet? Search for Vivid Connect on Google Play or the App Store, or use the badges on our home page. On iPhone the app is sign-in only: open your business on the web first, then sign in to the app with the same details.

Build your packages

A package is what a customer buys. You choose what it includes and what it costs. There are a few shapes to work with, and most businesses sell a mix:

ShapeGood for
Time (unlimited data for a set period)Day passes, evening passes, weekly access. Simple to explain.
Data (a fixed amount of data)Customers who want their bundle to last, not expire.
Time and data togetherProtecting a shared line: the bundle ends at whichever limit comes first.
Unlimited day plansBusy locations where simplicity sells better than precision.
Night or off-peak plans (a package that only works inside a window, for example 10pm to 6am)Selling the hours your line is idle. The window is enforced by the router itself: at 6am the customer is off, whatever is left on the bundle.

Every package also carries its own speed (see Set customer speeds) and the number of devices it may be used on at once. Customers can buy their next package before the current one ends and it queues behind it; registered customers can also pause, switch and resume.

Practical advice on pricing

Sell PPPoE (wired and fibre customers)

Hotspot is for people who walk in and buy on their phone. PPPoE is for a place you wire up: a home, an office, a school or a shop with its own router. That router dials into your MikroTik with a username and password and stays connected for as long as the plan runs, the way a fibre or cable subscription works. Vivid Connect sells both from the same router and the same customer list. PPPoE is a feature we switch on per account; message us if the PPPoE menu is not on yours yet.

The whole flow, in order

  1. Provision a port once. Open the router in your dashboard and press Provision PPPoE. Pick the port (or the bridge, which covers every port in it) your PPPoE customers will be wired to, keep the suggested addresses unless they collide with something on your network, and press Provision. The router now runs a PPPoE server on that port that checks every sign-in against your customer accounts. The internet uplink and the management tunnel are refused automatically, so you cannot provision the wrong port. Running it again is safe; it only fixes what drifted.
  2. Build PPPoE packages under Services → PPPoE Plans: a speed profile, a price and a validity (a monthly unlimited plan is the usual shape, but time or data budgets work too). The speed and any limit are enforced on the customer's session by the router.
  3. Give the customer an account. Create them under Customers (or let them register on the portal). Their account username and password are their PPPoE login; there is nothing separate to set. A customer who needs a fixed IP address (a camera system, a small office server) gets it on their customer profile and the router honours it on every session.
  4. Run a line to their router. From the provisioned port, straight or through a switch, one cable per customer into the WAN port of their router. A point-to-point wireless bridge to their roof works the same way, because it carries the same Ethernet frames.
  5. They buy a PPPoE package on the customer portal or in the app, with Mobile Money or a card, from anywhere: their home line does not need to be up to pay. (Hotspot packages are different: those can only be bought while connected to the hotspot WiFi.) You can also recharge them yourself from the dashboard or the app.
  6. They set their router's WAN to PPPoE and type the username and password, once. Every TP-Link, Tenda, Huawei or MikroTik home router and every ONT has this setting. The router dials in and every phone, TV and laptop in the house is online through it, with no login page and nothing to type again.

The order of the last two steps does not matter: a router set up before the first purchase simply keeps retrying and connects the moment a plan is active. When the plan expires the session is cut and the next dial is refused until they pay again; after payment the router reconnects by itself within a minute. Nobody touches the router settings again. The renewal reminders on WhatsApp matter more here than on hotspot, because a PPPoE customer whose plan has run out sees no page telling them why; they just lose internet until they renew.

What PPPoE is not. There is no login page. A phone or laptop that joins an access point's WiFi cannot use a PPPoE package (phones have no PPPoE client); those are hotspot customers. PPPoE is for the customer's own router on a wired line or a wireless bridge.

A note on authentication: the server offers PAP and CHAP, which every home router and ONT supports. It deliberately does not offer MS-CHAPv2. That method cannot be completed through our platform and would leave a customer router stuck reconnecting, so it is left off rather than left half-working.

Set customer speeds

Every package sells a speed, and the speed comes from a speed profile (dashboard: Internet Plan → Bandwidth; app: Packages → Speed profiles). A profile has one required part - the rate - and an optional part that makes cheap plans feel expensive: burst. This section explains both, with numbers you can copy.

The rate: what you are actually selling

Download and Upload are entered separately (e.g. 5M down, 2M up). This is the sustained speed the customer gets, full stop. If you set nothing else, the profile is done and it works. Everything below is optional polish.

What burst is, in one picture

Most of what people do on WiFi happens in short pulls: a page loads, a photo downloads, a chat syncs - two seconds of traffic, then silence. Burst lets those short pulls run FASTER than the plan's rate, then settles heavy use (streaming, big downloads) back down to the rate. The customer feels a fast connection; your uplink is still protected from sustained hogging.

The router decides who is "bursting" with a simple rule: it watches each customer's average speed over the last Burst Time seconds. While that average is below the Burst Threshold, the customer may run at the Burst Limit. Once their average climbs past the threshold - which only happens if they keep pulling hard - they drop back to the plan's rate until they go quiet again.

Presets: pick one, the numbers follow the rate

You do not enter burst numbers by hand any more. Both the dashboard and the app offer three presets built from the rate you typed, so they move with it: change a 5M plan to 8M and the burst follows.

Every preset ends the boost once the customer's 16-second average passes three quarters of the rate, and guarantees half the rate when the router is full. On a 5M / 1M plan, Standard therefore reads: burst to 10M / 2M, threshold 3750k / 750k, time 16/16, limit at 2500k / 500k.

Custom, with guard rails

Custom unlocks the raw fields for the cases the presets do not cover (an asymmetric boost, a longer window). What each one means:

Those rules are checked before anything is saved, because a burst that breaks the router's two hard rules (limit below the rate, limit-at above it) makes RouterOS refuse to build the queue, and that refusal fails the whole login: the customer pays and gets no internet. If an old profile somehow carries such a burst, the login server drops the burst and sends the flat rate instead, and logs it so you can fix the profile.

How long does a boost last? Roughly Burst Time × Threshold ÷ Burst Limit.

Getting it right

Protect your line

Speed profiles control each customer. Three more controls, on the router's own page (dashboard: your router → edit; app: Routers → your router), protect the LINE itself - the thing all your customers and your own devices share. Set them once per router; they matter more as you get busier.

The smart queue (CAKE)

When an internet line is completely full, everything on it goes bad at once: pages hang, video calls stutter, and one heavy download can make twenty light users miserable. The smart queue fixes this. Tell the router your line's REAL speed, and it runs a fairness algorithm called CAKE at the bottleneck: the line stays responsive even when it is completely full, and no single user can stall everyone else.

  1. Measure the line honestly. Run a speed test at a quiet time, on a device close to the router.
  2. Enter about 90% of the result - download and upload separately. The router must be the bottleneck for fairness to work, which is why you shave the 10% off.
  3. Save. The queue is pushed to the router immediately.
Set it AT or ABOVE the line's true speed and it silently does nothing - the congestion happens upstream where the router cannot see it. When your provider speed changes (a Starlink plan change, a fibre upgrade), re-measure and update. 0 switches it off.

Owner priority

For when the line is shared with your own devices on the router's LAN ports - a shop's POS, cameras and office machines, or simply your own home devices if you are selling your spare bandwidth. Set the number of Mb your side is guaranteed: your devices jump the queue and claim that slice the instant they need it, and customers use the entire line whenever your devices are idle. Nobody pays for a slice that just sits there.

Capacity cap

The maximum number of customers allowed online at once on this router. Selling internet is selling an experience: fifty people on a 20M line all get a bad one, and the forty-ninth customer's cedi is not worth the other forty-eight walking away. When the cap is reached, new buyers are told the WiFi is full rather than being sold a connection that cannot deliver.

A starting rule of thumb: divide your line's download speed by the sustained speed of your most popular plan, then add a little - short bursts share better than the raw division suggests. A 20M line selling mostly 2M plans comfortably carries 12-15 people; watch how it feels at your busiest hour and adjust. 0 means no cap.

Speeds and fair use

Each package can carry its own speed. This is how you protect a shared line and how you create something worth paying more for.

Set speeds using what your line actually delivers, not what it is sold as. Test the real speed first, then leave headroom. Selling more than the line can carry is the fastest way to unhappy customers.

Show packages to customers

When someone connects to your WiFi, they land on your login page. What they see there is up to you.

  1. Mark a package as sellable to guests. Only packages you flag this way appear on the login page. Anything not flagged stays private, for you to sell by hand.
  2. Check the order and wording. The list is a shopfront, and the first package gets the most sales.
  3. Try it yourself. Connect a phone that is not already logged in and buy the cheapest package with real money. It is the only way to know the whole journey works.

Customers do not need an app or an account. They pick a package, approve the Mobile Money prompt on their phone (or pay by card), and they are connected automatically. Their device is remembered until the plan ends, so they come back on without a code, and the voucher on WhatsApp gets them on from another device.

Make the page yours. Under Settings → Business Settings you can put your own logo on the portal, pick your brand color (buttons and highlights follow it, all the way through the payment screens), and add a one-line welcome under your business name. Leave any of them empty and the standard look is used. The colour and the welcome line can also be changed from the app (Manage → Portal branding); the logo is uploaded on the web.

Bringing customers from another system? The customer list has an Import button that takes a CSV file: one upload moves your whole subscriber book over, duplicates are skipped rather than overwritten, and anyone without a password gets a fresh code generated. There is a template to download so the columns are never a guess.

Many customers at once. Tick several customers on the list and the With selected bar does the rest: send them a message, export them, set their status, Change Plan (move everyone you ticked onto another package free of charge - for a price restructure or a renamed bundle; what they have left is untouched and anyone online reconnects on the new plan), Extend Days (add days to every active package, the honest answer to an outage), or delete them. Every bulk action is written to your Activity Log with the counts.

Vouchers and cash sales

Not every customer wants to pay online, and you should not lose those sales.

Getting paid

Every online sale is split the moment the customer pays. Your earnings are separated out immediately and are on their way to you without anyone approving anything.

If earnings look delayed, check the payout state in your dashboard first. It distinguishes money still with the payment provider from money that has actually landed. If something is genuinely stuck, contact us with the date and we will trace it.

Cash and vouchers run the other way

Online money splits automatically. Cash is the reverse: the money is already in your hand, so what remains open is the platform's share of it.

Your own gateway

Prefer full control? Switch to your own Paystack account from Settings → Payments (Paystack only, for now): turn on "Use my own gateway keys", paste your secret key and save. Customer payments then land directly in your own Paystack account, Paystack's charge on each sale is yours, and because of that the platform fee on those sales is 4% instead of 6%. The fee still leaves at the moment of each sale: a "Vivid Connect (platform commission)" subaccount and split are placed on your account, so there is nothing to settle by hand. One step is yours: verify that subaccount in your Paystack dashboard (Subaccounts → select it → Verify), then press "I have verified it". Sales open once it is verified. Every ten minutes we check that the subaccount and split are still as agreed; if either is changed, sales pause until it is restored. Switch back any time and you return to platform-managed payments at 6% with the payment provider's charge on us.

Accounting and statements

The Accounting page is the one reconciled view of every stream: online, cash, voucher, own gateway and referral earnings, with any partner share shown as its own column and what has actually been paid out against each sale. Filter by date range, source or payout state, then export exactly what you filtered: a CSV for spreadsheets, or a branded PDF statement for your records, your accountant or a partner.

Referral earnings

The referral program is by invitation. When it is enabled on your account, you get a personal signup link and code to share, and every business that joins through it earns you a share of their online sales, for life.

Interested? Message us and we will talk it through.

Working with a partner

A partner is a technician or installer we have approved to set businesses up on their clients' behalf. If your account was opened by one, you will see them named under Business Settings. Here is what that means for you.

If your partner proposes a revenue share

A partner may propose a revenue share with you for any reason, up to half of your online sales. A common one is financing the equipment: "I buy the router, we split the sales until it is paid off". That agreement is between you and them; the platform only carries it out, and only once you approve it:

  1. You get a WhatsApp saying what was proposed (the percentage and the partner's note), and a banner in your dashboard until you act on it.
  2. Open Business Settings, press Send me a code, enter the 6 digits from your WhatsApp and press Approve. Or press Decline. A partner working inside your account cannot approve it for you.
  3. Once approved, that percentage of each online sale is paid to the partner by us at the moment of sale, out of your side. Our commission does not change. Every sale under My Income shows the partner share as its own line.
  4. It is an agreement between you and your partner, so it is not ended by one side alone: your partner can give up their share at any time; you can ask to end it from the same page (with a code) and it continues until they agree or Vivid Connect decides; a change to the percentage or the end date is reviewed by us and then needs your acceptance again. Cash and voucher sales are outside it.

If your account was opened by the partner with a share already proposed, you will see this before anything else when you first sign in, and the business starts selling only once you have accepted it (or the partner has withdrawn it). Removing your partner's access is separate from the share and now also asks for a code.

Selling through agents

An agent is someone who sells your vouchers for cash in the field: the shop next to your router, a market seller, a trusted neighbour. Vivid Connect keeps the arrangement on the books instead of in anyone's head.

  1. Add the agent. From Agents on the web dashboard or in the app: their name, their WhatsApp number, and their commission percentage. Their sign-in arrives on their WhatsApp, and when they log in to the Vivid Connect app they get the agent view, not yours. Agents are always added by you; there is no public agent signup, because they will be holding your stock and your cash.
  2. Issue them voucher stock. Pick a package and a quantity; those codes are now carried by that agent. Unused codes are inventory, not sales, and the screens say so.
  3. They sell, the books follow. The moment a customer redeems one of their vouchers, the sale lands under the agent's name with their commission worked out. No self-reporting.
  4. They remit, you confirm. Each agent carries a live to remit balance (sales, minus their commission, minus what they have already handed over). When they send you money they submit the amount with the MoMo or bank reference, and it only counts once you confirm it. You can also reject one with a note.

You can change an agent's commission, pause them, or see their full history at any time. Agent sales are cash sales, so the platform commission on them goes on your ledger the same way your own cash sales do. If the Agents menu is not on your account yet, message us and we switch it on, free.

Staff access

Agents sell in the field; staff work inside your dashboard. From the Staff page you add people with their own sign-in, limited to their job:

You add each account yourself (their sign-in arrives on their WhatsApp) and you can deactivate or reset it at any time. There is no public staff signup. Everything staff do is recorded in your Activity Log under their own name. If the Staff menu is not on your account yet, message us and we switch it on, free.

Keeping an eye on things

Getting help

We onboard every operator personally. If you are stuck, ask us rather than guessing.

Useful things to include when you write in: your business name, the router involved, and roughly when the problem started.