mamuaminu/verify-naija
Domaine:
digital infrastructureType de record:
softwaretools
Créateur:
mam
HĂ´te:
Nigerian KYC Verification API — BVN, NIN, Bank Account verification microservice
# VerifyNaija 🇳🇬
> Nigerian KYC Verification API — Instantly verify BVN, NIN, Bank Accounts, and Phone Numbers
**VerifyNaija** is a micro-SaaS API that provides instant KYC verification for Nigerian identities. Built for fintechs, payment platforms, e-commerce businesses, and any Nigerian digital business that needs to verify user identity.
---
## 🚀 Features
- **BVN Verification** — Bank Verification Number lookup with full identity data
- **NIN Verification** — National Identity Number verification
- **Bank Account Verification** — Account name and status check for any Nigerian bank
- **Phone Number Verification** — Carrier detection, line status, portability across MTN/Airtel/Glo/9mobile
- **Name Matching** — Verify if a name matches BVN records
- **Credit System** — Pay-per-verification with free tier
- **Caching** — 24-hour result caching to reduce costs
- **JWT + API Key Auth** — Two authentication modes
---
## đź’° Revenue Model
| Verification Type | Cost |
|---|---|
| BVN | ₦50 |
| NIN | ₦100 |
| Bank Account | ₦20 |
| Phone | ₦30 |
| Name Match | ₦20 |
**Pricing Tiers:**
- **Free**: 10 credits (signup bonus)
- **Pay As You Go**: Buy credits at ₦50/1K — ₦35K/1M
- **Business**: ₦45,000/month — 5,000 credits + SLA
- **Enterprise**: Custom volume + white-label
---
## 🔌 Quick Start
### 1. Clone & Install
```bash
git clone github.com
cd verify-naija/backend
npm install
```
### 2. Start Server
```bash
cp .env.example .env # optional
node server.js
```
Server starts on `localhost` (or `PORT` from env).
### 3. Try the API
```bash
# Check API status
curl localhost
# Verify a BVN
curl localhost \
-H "x-api-key: vna_demo_key_123456789"
# Verify a Bank Account
curl localhost \
-H "x-api-key: vna_demo_key_123456789"
```
---
## 📡 API Reference
### Authentication
Pass your API key via header …