2 Best APIs for Agent Banking in Nigeria

Paga is one of Nigeria's oldest and largest mobile money platforms, founded in 2009 by Tayo Oviosu. Paga is operated by Pagatech Limited, a subsidiary of Paga Group Ltd (UK), and holds a CBN Mobile Money Operator license — one of the most comprehensive payment licenses in Nigeria. Paga also has NDIC (Nigerian Deposit Insurance Corporation) insurance coverage, meaning customer funds are protected up to ₦500,000. With over 20 million registered users and more than 30,000 agents across Nigeria, Paga has built deep financial infrastructure that it has opened to developers via the Paga Business API. The Paga Business API is a RESTful API accessed at developer-docs.paga.com. Unlike most Nigerian payment APIs that use standard Bearer tokens, Paga uses a custom authentication scheme based on SHA-512 HMAC hashing. Each API request requires three custom headers: principal (the organization's public ID), credentials (the organization password), and hash (an SHA-512 hash computed from specific request parameters combined with a secret hash key provided by Paga). This non-standard auth scheme means developers must implement the hashing algorithm correctly or all requests will fail — a common gotcha for developers new to the Paga API. The Paga Business API supports a wide range of financial operations beyond just payment collection. The moneyTransfer endpoint allows sending money to any Nigerian bank account or Paga account. The depositToBank endpoint specifically handles bank-to-bank transfers. The airtimePurchase endpoint buys airtime or data bundles for any major Nigerian network (MTN, Airtel, Glo, 9mobile). The merchantPayment endpoint enables payment to registered Paga merchants. The billPayment endpoint covers utilities and service payments including DSTV, GoTV, EKEDC, and other billers. The accountBalance endpoint retrieves current balance, and registerCustomer allows platforms to programmatically onboard new customers to Paga. A powerful feature is bulk transaction support — the Bulk Transfer API allows sending up to 300 transfer instructions in a single API call. This makes Paga highly efficient for Nigerian companies that run regular payroll, commission disbursements, or refund processing at scale. Paga also offers a Collect API — a payment request mechanism where a business generates a payment request for a specific customer, and the customer receives a notification to approve the payment from their Paga account or via USSD. This is similar to a payment link but operates within the Paga network. The Direct Debit API enables businesses to set up recurring debit mandates on customer accounts, allowing automatic deductions for subscriptions, loan repayments, and installment payments — a critical feature for Nigerian lending platforms and SaaS businesses. Pricing is competitive: P2P transfers between Paga accounts are free, making Paga attractive for platforms where both payer and recipient use Paga. Transfers to Nigerian bank accounts cost 1.5% of the transfer amount for card-funded transactions. A minimum fee of ₦10 applies. Enterprise API partners may negotiate custom pricing based on volume. The sandbox environment is available at beta.mypaga.com with test credentials. Live APIs run at mypaga.com. Moving from sandbox to production requires completing Paga's business onboarding process, which includes submitting your use case description, CAC registration documents, and director KYC. From a compliance perspective, Paga holds a CBN Mobile Money Operator license and is NDIC-insured. All transactions are processed within the CBN regulatory framework. Paga is also registered with the NDPR as a data processor. Paga has been operating since 2009 — one of the longest-standing fintech licenses in Nigeria. Known challenges: The SHA-512 HMAC authentication is non-standard and requires careful implementation. The API documentation uses older REST conventions that may feel less intuitive compared to Paystack or Flutterwave. Paga's coverage is strongest in regions where Paga agents are concentrated (North, Southwest Nigeria). Integration support is primarily email-based. Frequently Asked Questions: Why does Paga use SHA-512 hashing instead of Bearer tokens? Paga's authentication predates the widespread adoption of JWT Bearer tokens. The SHA-512 HMAC scheme ensures request integrity and authenticity without requiring TLS-only trust. Can I use Paga API without a Nigerian business? Paga requires a registered Nigerian business account for API access. The CBN licensing requirements mandate that only registered entities can access the Paga Business API. Does Paga support USSD payments? Yes — Paga's agent and consumer USSD product (*242#) is widely used. The Collect API leverages USSD as a notification and payment confirmation channel.

Onafriq (formerly MFS Africa) is Africa's largest digital payments gateway, operating across 40+ African countries and reaching over 500 million mobile wallets and bank accounts on the continent. In Nigeria, Onafriq operates the Baxi super-agent network — a branded agency banking network with over 460,000 active agents nationwide, covering both urban and rural areas. Baxi is one of Nigeria's largest super-agent networks and is used by streaming platforms, utilities, government agencies, and fintech companies to collect payments from and disburse to cash-preferred Nigerian consumers. Onafriq provides a unified API that connects businesses to its full collection and disbursement infrastructure across Nigeria and Africa. The API documentation is at docs.onafriq.com, and Onafriq Nigeria Payments Ltd holds a CBN Payment Service Provider license for all Nigerian operations. The Collections API enables businesses to receive payments through multiple channels: mobile money wallets (pan-African, where applicable), bank account transfers, debit cards, and cash payments via Baxi agents. This multi-channel collection capability is the core value proposition — a single API integration enables a business to collect from tech-savvy card users, bank transfer users, and cash-paying offline customers all at once. This is particularly powerful for Nigerian companies serving a diverse customer base that spans different income levels and digital adoption stages. For bill payments, Onafriq's Baxi network integrates with over 248 billers including electricity DISCOs (EKEDC, IKEDC, AEDC, and others), DSTV and GOtv subscription management, water corporation payments, and various government agencies. Businesses can integrate the Biller API to let their users pay any of these billers from within their application. The Disbursements API enables fast, secure payouts to bank accounts and mobile wallets across Nigeria. This is used by social protection programs (conditional cash transfers), agricultural buyers (paying farmers at harvest), insurance companies (claims payouts), and any platform that needs to send money to Nigerian recipients who may not have traditional bank accounts. A significant 2026 milestone was Onafriq's PAPSS (Pan-African Payment and Settlement System) integration, launched in partnership with Nigerian banks and mobile money operators. This enables wallet-based outbound payments from Nigeria to Ghana — a first step toward real-time pan-African interoperable payments using local currencies, bypassing USD correspondent banking for intra-African transfers. In January 2026, Showmax partnered with Baxi by Onafriq to offer Nigerian subscribers a new payment option for streaming subscriptions — allowing users to pay in person at any Baxi agent point without needing a bank card or mobile banking app. This demonstrates the commercial value of the Baxi network for digital businesses that want to capture Nigeria's large cash-preferred segment. Authentication for the Onafriq API uses Bearer Token or API Key credentials obtained through the developer portal. Enterprise integration partners may have specific authentication flows depending on their market and product. A sandbox environment is available for testing. Known challenges: Onafriq's developer documentation is less self-service-oriented than Paystack or Flutterwave — enterprise integration partnerships are the primary onboarding path. Nigeria-specific Baxi agent banking integration may require additional operational setup beyond just API access. Pricing is negotiated per partnership rather than published on a public pricing page. Frequently Asked Questions: Can I use the Baxi agent network without building a full integration? Baxi provides physical agent points where end customers can pay using reference codes — the integration generates a reference code that the customer presents at the Baxi agent. Full API integration is required to generate reference codes and reconcile payments. Is Onafriq the same as Baxi? Baxi is Onafriq's Nigeria-specific super-agent brand. Onafriq is the pan-African parent. The API covers all Onafriq products including Baxi. Does Onafriq support mobile money in Nigeria? Onafriq's mobile money expertise is strongest in East Africa (Kenya, Tanzania) and West Africa (excluding Nigeria, where mobile money adoption has been slower than agent banking). In Nigeria, the focus is on bank transfers and Baxi cash agents.