mamuaminu/verify-naija

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 …