Case study
IbomTax
How a state moved its tax payments online: one portal where Akwa Ibom taxpayers register, pay, file and verify, now serving 34,200 taxpayers and over ₦31.77bn in payments.
- Client
- Akwa Ibom State Internal Revenue Service
- Role
- Team Lead
- Year
- 2025
- Stack
- Next.js · Node.js · MongoDB
- Live
- ibomtax.net

01 — The problem
Why it needed building.
Paying tax in Akwa Ibom used to be an analogue process. Taxpayers had to go to a bank in person, queue to pay, and then wait for a receipt. Getting a Tax Clearance Certificate meant yet more trips and more waiting.
That cost taxpayers hours of their working day for something as routine as paying a bill, and every trip was another reason to put it off. With IbomTax, people pay from the comfort of their homes, get a receipt in under six minutes, and get their Tax Clearance Certificate online too.
02 — Who it serves
Four kinds of taxpayer, one portal.
Individuals
Register with their NIN, get a Taxpayer ID straight away, estimate what they owe, then pay and file online.
Companies
Run PAYE from a dashboard: upload an employee list from a CSV template, then file and pay for the whole payroll at once.
Tax consultants
Handle filings and compliance for their clients from a single account.
Guest payers
Pay a bill without creating an account and still get a receipt immediately.
03 — The product
The whole tax journey, online.
- 01
Verified registration
Individuals and companies sign up in minutes. Individuals are checked against their NIN, and each taxpayer gets a Taxpayer ID on the spot.
- 02
Tax calculator
Estimates personal income tax for a chosen assessment year before anyone commits to paying.
- 03
Payments & receipts
Taxpayers pay online, with or without an account, and get a receipt the moment the payment clears.
- 04
Filing & assessments
Returns are filed online, and taxpayers get automated assessments and e-alerts.
- 05
Bulk PAYE
Companies download a CSV template, fill it in and upload a whole workforce in four steps, with no rows typed in by hand.
- 06
TCC verification
Anyone can check that a Tax Clearance Certificate is genuine, which makes forged certificates harder to pass off.
04 — My role
Leading the build.
As team lead, I coordinated the build and was the team's main contact with the third-party service providers the portal depends on. I worked with them to integrate their services, resolve issues and keep each integration running smoothly.
I also worked hands-on: I built parts of the frontend, and I was responsible for securing most of the administrative side, the part of the system that revenue staff use to manage taxpayers and their records.
05 — The hard parts
Where the real work was.
Depending on systems we didn't control
Identity checks and payments both run through outside providers, so the portal is only as reliable as those integrations. A big part of my job was working with each provider through setup, testing and go-live, and getting problems on their side fixed quickly when they showed up for taxpayers.
Securing the administrative side
Taxpayers see only their own account, but the administrative side can reach everyone's records. That makes it the part of the system an attacker would want most. I took responsibility for securing most of it, so that staff can reach only what their job requires and taxpayer data stays protected.
One portal for very different users
An individual paying personal income tax, a company filing PAYE for its whole staff, a consultant managing several clients and a guest paying a one-off bill all need different journeys. The challenge was keeping each journey simple without splitting the portal into four separate products.
06 — Results
What changed.
- <6 minfrom home to receipt, with no trip to the bank
- 34.2kregistered taxpayers
- ₦31.77bnin tax payments collected
IbomTax taught me that software for government is built on trust. Taxpayers have to trust that their money landed and their data is safe, and the revenue service has to trust every figure it reports. Leading the team, and working closely with the providers we depended on, showed me that good communication matters as much as good code when the stakes are this real.