1 Best APIs for Transaction Status Query in Nigeria

The Nigeria Inter-Bank Settlement System (NIBSS) is the central financial market infrastructure of Nigeria, responsible for managing the country's national payment clearing and settlement systems. Incorporated in 1993 and commencing operations in June 1994, NIBSS is jointly owned by the Central Bank of Nigeria (CBN) and all licensed Nigerian banks. It is the backbone upon which every bank transfer, USSD payment, POS transaction, and interbank settlement in Nigeria operates. NIBSS provides a suite of APIs and infrastructure services — collectively referred to as NIBSS APIs — that allow CBN-licensed financial institutions and certified payment application developers to connect directly to Nigeria's national payment rails. Unlike most APIs on this platform, NIBSS APIs are not intended for general startup developers: access is restricted to licensed financial institutions (commercial banks, microfinance banks, mortgage banks) and certified fintech entities holding CBN payment licenses (PSSP, PTSP, or equivalent). Startups and independent developers typically access NIBSS services indirectly through licensed payment aggregators like Paystack, Flutterwave, Interswitch, or Mono. **Core API Products** 1. **NIBSS Instant Payment (NIP)** — Launched in 2011, NIP is Nigeria's real-time interbank payment system, enabling instant fund transfers between accounts at different Nigerian banks. NIP processes millions of transactions daily and underpins every bank-to-bank transfer made via mobile banking apps, internet banking, USSD, POS terminals, and agent banking networks across Nigeria. The NIP API allows licensed institutions to initiate transfers, query transaction status, and handle incoming credit notifications in real time. 2. **Bank Verification Number (BVN) Validation** — The BVN system, launched in 2014, is a biometric identity database containing over 64 million records linking Nigerian bank customers to their fingerprints and facial biometrics. The NIBSS BVN Validation API allows licensed institutions to verify a customer's BVN in real time — checking that the BVN is legitimate, active, and matches the customer's submitted personal details (name, date of birth, phone number). This is the gold standard for identity verification in Nigerian financial services and is a mandatory component of many CBN-mandated KYC processes. 3. **NIBSS Direct Debit (NDD)** — NDD is Nigeria's national direct debit mandate system, enabling recurring payment collection from customers who have provided a formal payment mandate. It is widely used by lending institutions for loan repayment collections, by utilities for bill payments, and by insurance companies for premium collections. NDD allows authorized institutions to debit customer accounts on a predetermined schedule without requiring the customer to manually authorize each payment. 4. **Nigeria Central Switch (NCS)** — Launched in 2007, the NCS is the interoperability layer connecting all licensed Nigerian banks and mobile payment operators. It enables transactions initiated on one bank's channel (e.g., a GTBank POS terminal) to route correctly to another bank's account (e.g., an Access Bank account). The NCS also connects ATM networks, enabling nationwide ATM interoperability. **Authentication & Security** NIBSS APIs use enterprise-grade mutual authentication combining SSL (Secure Sockets Layer) encryption and HMAC256 digital signatures. Every API request must be signed with the institution's secret key using the HMAC256 algorithm, providing message integrity verification in addition to transport-level encryption. API credentials are issued only after the full NIBSS certification process is completed. **Sandbox Environment** NIBSS maintains a sandbox environment at vi-nibsssandbox.nibss-plc.com.ng, available to institutions and developers who have been approved for the certification process. The sandbox replicates NIP and other NIBSS services in a test environment, allowing certified developers to validate their integration before going live on the national network. **Access & Certification Process** Gaining direct NIBSS API access is a formal, multi-week process: 1. Submit a Letter of Intent to the NIBSS Managing Director detailing the application, device specifications, compliance standards, and intended use 2. NIBSS Certification Team evaluates the Letter of Intent 3. Legal Team reviews all required documents (Certificate of Incorporation, Memorandum and Articles of Association, Director Particulars, 3-year Tax Clearance) 4. NIBSS provides test specifications for the application/device 5. Rigorous testing against CBN-defined requirements and international payment standards 6. Certification issued (valid for 24 months, renewable) or defects identified for remediation **Pricing** NIBSS does not publish a public fee schedule. Transaction fees for NIP and other services are established through institutional agreements and CBN regulatory guidelines. Licensed member banks pay per-transaction fees to NIBSS based on negotiated volume tiers. Independent developers seeking to use NIBSS services should work through licensed aggregators rather than applying for direct access. **Who Can Use NIBSS APIs Directly** - Commercial banks, merchant banks, microfinance banks licensed by the CBN - Payment service providers holding CBN PSSP or PTSP licenses - Payment terminal service aggregators certified by NIBSS - Mobile money operators licensed by the CBN **Who Cannot Use NIBSS APIs Directly** - Startups without a CBN license - Independent software developers - Businesses that are not registered financial service providers in Nigeria **For Developers Without a CBN License** Most Nigerian developers do not access NIBSS directly. Instead, they build on top of licensed payment infrastructure providers whose APIs abstract the NIBSS layer: - Use Paystack or Flutterwave for NIP-based transfers (they are licensed NIBSS members) - Use Mono, Okra replacements, or Youverify for BVN verification (as licensed data processors) - Use Interswitch or eTranzact for NCS-connected switching services **Frequently Asked Questions** Q: Can a startup developer use NIBSS APIs directly? A: Not without a CBN license. NIBSS access is restricted to licensed financial institutions. Startups should access NIBSS services through licensed aggregators. Q: What is the BVN API and why is it important? A: The BVN Validation API allows licensed institutions to verify a customer's identity against Nigeria's 64M+ biometric database — the regulatory standard for KYC in Nigerian financial services. Q: How long does the NIBSS certification process take? A: Typically several weeks to months, depending on the complexity of the application and the completeness of submitted documents. Q: Is there a sandbox for testing NIBSS APIs? A: Yes — vi-nibsssandbox.nibss-plc.com.ng — available to institutions that have initiated the certification process.