API Credits¶
Last reviewed: 2026-04-01 · Nnamdi
Status: Complete
Route: /api-credits
1. What is it?¶
API Credits is Finora's prepaid balance system for verification services. Businesses purchase credit packages and spend them on TIN Verification (checking supplier/customer Tax Identification Numbers against the NRS database), Employee NIN Verification (validating National Identification Numbers for PAYE onboarding), and Mono Bank API calls (connecting bank accounts for automatic transaction syncing). Credits cost ₦200 per verification, never expire, and are purchased via secure payment processing.
2. How does it work in Finora?¶
2.1 The API Credits page (/api-credits)¶
Header: - Heading: "API Credits" - Subtitle: "Manage your API credit balance for verification services. Credits never expire."
What are API Credits used for? (info section):
| Service | Description | Cost |
|---|---|---|
| TIN Verification | Verify supplier and customer Tax Identification Numbers with NRS database (Formerly FIRS) | ₦200 per verification |
| Employee NIN Verification | Verify employee National Identification Numbers when onboarding for PAYE tax purposes | ₦200 per verification |
| Mono Bank API | Connect bank accounts and sync transactions automatically via Mono API | ₦200 per API call |
"Your credits never expire - use them whenever you need!" Note: All credit packages are exclusive of 7.5% VAT. VAT will be added at checkout.
Current Balance section (test business):
| Field | Value |
|---|---|
| Current Balance | ₦0.00 |
| Verifications remaining | 0 |
| Status | "No credits remaining — Purchase credits to use TIN and bank verification services." |
Purchase Credits button — opens the purchase panel.
2.2 Purchase API Credits panel¶
Header: "Purchase API Credits" — shows current balance.
Step 1: Choose a Credit Package
| Package | Price | Verifications | Per Verification | Badge |
|---|---|---|---|---|
| Starter | ₦5,000 | 25 | ₦200 | — |
| Professional | ₦10,000 | 50 | ₦200 | Recommended |
| Enterprise | ₦20,000 | 100 | ₦200 | — |
All packages: "Perfect for small businesses" — ₦200 per verification across all tiers.
Secure Payment Processing note:
"You will be redirected to a secure payment page to complete your purchase. Your credits will be added automatically after payment confirmation."
Action buttons: - Cancel — closes the panel - Review & Pay — proceeds to payment (disabled until a package is selected)
2.3 Usage History section¶
Heading: "Usage History"
Filters:
| Filter | Options |
|---|---|
| Service | All Services / TIN Verification / NIN Verification / Bank Verification |
| Time Period | Last 7 days / Last 30 days (default) / Last 90 days / All time |
Empty state: "No usage history yet — Credit usage will appear here when you use verification services"
Each usage entry (when present) shows the service type, date, credits consumed, and reference.
3. Business rules & constraints¶
| Rule | Detail |
|---|---|
| Credits never expire | Purchased credits remain available indefinitely |
| ₦200 per verification (flat rate) | All three services cost the same per call |
| VAT added at checkout | Credit package prices are + 7.5% VAT |
| Auto-credited after payment | Credits are added to the balance automatically upon payment confirmation |
| Credits are non-refundable | Once purchased, credits cannot be refunded (escalate exceptions to Tier 2) |
| TIN Verification used throughout the app | When adding customers, suppliers, or employees, TIN/NIN verification consumes credits |
| Mono API calls are "Coming Soon" | The Mono bank connection feature is not yet live; credits for it are pre-sold |
4. Nigerian regulatory context¶
TIN Verification¶
Every Nigerian business and individual taxpayer has a Tax Identification Number (TIN) issued by NRS (formerly FIRS) or the relevant SIRS. Verifying a customer or supplier's TIN ensures: - Correct WHT certificate issuance (TIN required on certificates) - Accurate TaxPro-Max return schedules (TIN required for VAT/WHT returns) - Compliance with NRS record-keeping requirements
NIN Verification¶
The National Identification Number (NIN) is issued by the National Identity Management Commission (NIMC). For PAYE purposes: - Employees must have a valid NIN for tax payer registration - NIN verification during onboarding ensures the employee's identity and tax records are correct
Mono Bank API¶
Mono is a Nigerian open banking infrastructure provider. When live, the Mono integration will allow businesses to: - Connect bank accounts via bank login - Automatically sync daily transactions - Eliminate manual CSV/Excel statement uploads
5. Common customer questions¶
Q: "How do I verify a customer's TIN?"
When adding or editing a customer/supplier, enter their TIN and click "Verify TIN." This consumes 1 credit (₦200). You need credits in your balance before verification will work.
Q: "What happens if I run out of credits?"
Verification services will fail with a "no credits" error. Purchase more credits from the API Credits page.
Q: "Do credits expire?"
No — credits never expire. Use them whenever you need.
Q: "Why are all three packages ₦200 per verification? Is there a bulk discount?"
Currently all packages have the same per-verification rate. The packages differ in total credits purchased, not unit price.
Q: "I purchased credits but my balance didn't update."
If payment was confirmed but credits aren't showing, wait a few minutes for the system to process. If still not updated, escalate to Tier 2 with the payment reference.
6. Known edge cases¶
All packages have the same per-verification cost¶
There is no volume discount — Starter (₦5,000/25), Professional (₦10,000/50), and Enterprise (₦20,000/100) all cost ₦200 per verification. The package tiers are for convenience of purchase, not pricing advantage.
Mono API credits pre-sold¶
Credits for Mono Bank API calls are available for purchase even though the Mono integration is not yet live ("Coming Soon" on the Bank Accounts page). Customers who purchase credits for Mono will be able to use them once the feature launches.
"Perfect for small businesses" on all tiers¶
All three package cards show "Perfect for small businesses" — this is a display issue and should differentiate by tier.
7. Escalation trigger¶
Escalate to Tier 3 (Founder) if: - Credits were purchased and payment confirmed but balance not updated - Verification service fails despite having credits
Escalate to Tier 2 (Support Lead) if: - Customer needs a refund for purchased credits - Customer needs a larger custom credit package beyond Enterprise (₦20,000) - Customer's TIN/NIN verification returns incorrect results
8. Last reviewed¶
2026-04-01 — Nnamdi. Verified against production. API Credits page for COA Test School Academy: Current Balance ₦0.00 / 0 verifications remaining. Three services listed: TIN Verification (₦200), Employee NIN Verification (₦200), Mono Bank API (₦200). Credits never expire noted. VAT added at checkout noted. Purchase Credits panel captured: Starter ₦5,000 (25 verifications) / Professional ₦10,000 (50, Recommended) / Enterprise ₦20,000 (100). All ₦200/verification. Secure payment redirect noted. Cancel + Review & Pay buttons confirmed. Usage History: filters (All Services / TIN / NIN / Bank) + time period (7d/30d/90d/all). Empty state confirmed.