Question 1

What does Monnify do?

Accepted Answer

Monnify is a Nigerian payment gateway and payment infrastructure provider operated by Moniepoint Inc, a CBN-licensed payment solutions company and one of Nigeria's largest agent banking networks. Originally launched as a standalone product by TeamApt, Monnify was rebranded under the Moniepoint brand as the company expanded. Monnify provides Nigerian businesses with APIs for accepting payments via local debit cards, bank transfers, USSD, and direct debit, as well as disbursing funds to bank accounts across all Nigerian banks.

The Monnify API is RESTful and uses JSON for all request and response payloads. Developers can authenticate using Basic Auth — by encoding the API key and secret key as a base64 string — or by exchanging credentials for an OAuth Bearer Token via the /auth/login endpoint. Most implementations prefer Bearer Token authentication for production use, obtaining a token at server startup and refreshing as needed. The Monnify dashboard is available at app.monnify.com and provides API credentials, transaction history, settlement reports, and webhook configuration.

Payment collection works by initializing a transaction with a unique reference and an amount, then displaying the payment modal to the customer. The Monnify SDK handles the checkout experience, allowing customers to choose between card, bank transfer, USSD, or direct debit. For bank transfers, Monnify generates a reserved virtual account number for the customer — they transfer any amount to that account and the payment is automatically matched and settled to the merchant. This is particularly powerful for recurring or subscription-like payment flows.

In terms of pricing, Monnify charges 1.5% per transaction for local card payments, USSD payments, and bank transfers, with a cap of ₦2,000 per transaction. An alternative flat fee of ₦500 may apply for certain bank transfer transactions. International card payments attract a 4% fee. Cash collection is also charged at 4%. There are no setup fees and no monthly platform fees. Payouts (disbursements to Nigerian bank accounts) are charged at flat rates: ₦10 for transfers below ₦10,000, ₦20 for transfers between ₦10,000 and ₦49,999, and ₦40 for transfers of ₦50,000 and above. All fees are exclusive of VAT.

A key differentiator for Monnify is its settlement speed. Transactions are settled to merchants same-day by 10pm, and businesses can trigger up to 3 on-demand express settlements per day outside the standard settlement window. This is important for Nigerian e-commerce and service businesses that need immediate access to collected revenue.

The Monnify sandbox environment is a full replica of the production environment. Developers can create a free sandbox account at developers.monnify.com without any business registration documents. The sandbox provides test card numbers, simulated bank transfer flows, and test USSD responses. Moving from sandbox to live requires completing the standard CBN KYC process, including submitting CAC documents, director BVN, and business bank account details.

Rate limits for the Monnify API are not publicly published. However, for high-volume integration partners, Monnify support can provide guidance on expected throughput limits. The Webhook system sends real-time notifications for transaction completion, refunds, and disbursements — developers must validate the webhook hash to confirm the event originated from Monnify, and must respond with HTTP 200 within a defined timeout.

From a compliance standpoint, Monnify is CBN-licensed and operates under the same regulatory framework as all Nigerian payment service providers. Moniepoint Inc holds a Payment Service Bank license and a Switching and Processing license from the CBN. Monnify is also PCI-DSS certified, which is required for handling card payment data in Nigeria. Merchants are not required to be PCI-DSS certified themselves, as card data is processed on Monnify servers rather than the merchant's infrastructure.

The BVN verification endpoint available through Monnify allows developers to verify a customer's Bank Verification Number — returned with name, date of birth, and phone number — which is a CBN requirement for KYC compliance in lending and financial services.

Common challenges Nigerian developers face with Monnify include webhook delivery delays during peak traffic (Black Friday, end-of-month), and the need to handle cases where bank transfer payments arrive outside the transaction expiry window. Developers should set generous expiry windows for bank transfer transactions, and use the transaction status query endpoint to confirm payment before fulfilling orders, rather than relying solely on webhook delivery.

Moniepoint Inc, the parent company, is headquartered in Lagos, Nigeria and has expanded operations across several African markets. It was voted the fastest-growing company in Africa by the Financial Times in 2023 and has raised over $100 million in funding. Notable investors include QED Investors, Lightrock, and Google. The Monnify gateway is used by thousands of Nigerian businesses including e-commerce platforms, SaaS companies, and lending products.

Frequently Asked Questions:

Can I use Monnify without CAC registration? You can test the API freely on the sandbox with just an email. However, to go live and receive real settlements, full CBN KYC including CAC registration is required.

Does Monnify support NGN only? Yes, Monnify primarily settles in Nigerian Naira (NGN). International card transactions are charged at 4% but are settled in NGN after currency conversion.

Does Monnify have a no-code payment link? Yes, Monnify supports payment links and invoice generation from the dashboard — no coding required.

What happens if my webhook fails? Monnify retries failed webhook deliveries. However, developers should use the transaction status API (/api/v1/merchant/transactions/query) as a fallback to confirm payment independently.

Question 2

How much does Monnify cost?

Accepted Answer

Monnify is free to integrate, with fees charged per transaction (commission-based). Local cards/USSD: 1.5% capped ₦2,000. Bank transfer/Direct Debit: 1.5% capped ₦2,000 (or ₦500 flat). International cards: 4%. Payouts: ₦10 (<₦10K), ₦20 (₦10K–₦49,999), ₦40 (₦50K+). No setup/monthly fees. Rates exclude VAT.

Question 3

How do I authenticate with the Monnify API?

Accepted Answer

Basic Auth (base64 of apiKey:secretKey) OR OAuth Bearer Token

Question 4

Is there a rate limit on Monnify?

Accepted Answer

Not publicly specified

Question 5

Does Monnify offer a sandbox or test mode?

Accepted Answer

Yes — Monnify provides a sandbox or test environment so you can integrate and test before going live.

Question 6

What is Monnify best suited for?

Accepted Answer

Nigerian businesses, SaaS platforms, and fintechs that prioritize same-day settlement, competitive bank transfer fees, and a well-documented API from Moniepoint's CBN-licensed payment infrastructure.

Question 7

Is there anything else I should know before integrating Monnify?

Accepted Answer

Monnify is operated by Moniepoint Inc (CBN-licensed). Supports both Basic Auth and OAuth Bearer Token. Same-day settlement by 10pm daily with 3 on-demand express settlements. No setup or monthly fees. Rates exclude VAT. BVN/NIN verification endpoints also available.

Question 8

Where can I find Monnify's documentation?

Accepted Answer

The official API documentation is at https://developers.monnify.com/. The provider's website is https://monnify.com.

Question 9

Does Monnify support Nigerian developers?

Accepted Answer

Yes — Monnify explicitly supports Nigerian developers/use cases.

Monnify

Features Included

Not Supported

Key Highlights

Required Access Documents

Use Cases

Ask question or give feedback

Sign in to participate

Discover similar API's

Ask question or give feedback

Sign in to participate