8 Best APIs for International Card Payments in Nigeria

Flutterwave is one of Africa's most widely used payment infrastructure companies, providing a comprehensive API that enables businesses to accept payments locally across Africa and internationally in 150+ countries. Founded in 2016 and headquartered in San Francisco with major operations in Lagos, Flutterwave powers payments for over 1.3 million businesses across Africa. The platform is CBN-licensed, PCI DSS Level 1 certified, and handles billions of dollars in transactions annually. What the API Does The Flutterwave API provides a unified payment layer covering: card payments (Verve, Visa, Mastercard, AMEX, Discover); bank transfer checkout (USSD and direct NIP); mobile money (M-Pesa, MTN MoMo, Airtel Money, and more); virtual accounts for NGN collections; recurring billing and subscription management; split payments for marketplace revenue sharing; bulk transfers for mass payouts; multi-currency settlement in NGN, USD, GBP, EUR, and more; and payment links for no-code collections. How Developers Use It Developers sign up at flutterwave.com, obtain API keys from the Developer section of the dashboard, and integrate using the documentation at developer.flutterwave.com. Authentication uses Bearer token — secret key placed as "Authorization: Bearer sk_test_..." in request headers. Test mode keys only work in the test environment. SDKs are available for JavaScript, React, React Native, Flutter, Python, PHP, Node.js, and more. Inline checkout and redirect checkout are both supported. Webhooks deliver real-time transaction events to developer endpoints. Pricing Local transactions (cards, bank transfer, USSD, POS, Visa QR): 2% per transaction, broken down as 1.4% transaction fee + 0.6% platform fee. International cards (Visa, Mastercard, AMEX, Discover): 4.8% per transaction. Transfer fees: ₦10 for transfers up to ₦5,000; ₦25 for ₦5,001 to ₦50,000; ₦50 for transfers above ₦50,000. All fees are subject to 7.5% VAT. No monthly fee — only pay when you transact. By default, customers bear transaction charges but this can be adjusted in the dashboard. Authentication Bearer token using the secret key from your Flutterwave dashboard. Format: "Authorization: Bearer sk_test_{KEY}" for test, "Authorization: Bearer sk_live_{KEY}" for live. Never expose secret keys client-side. Rate Limits Flutterwave enforces rate limits and returns HTTP 429 (Too Many Requests) when exceeded. Specific thresholds are documented at developer.flutterwave.com/v3.0/docs/rate-limit. Compliance CBN-licensed, PCI DSS Level 1 certified. Flutterwave is registered with multiple African central banks and financial regulatory authorities. NDPR-compliant for Nigerian data protection. Challenges and Gotchas (1) The 0.6% platform fee on top of the 1.4% transaction fee makes the effective local rate 2% — ensure pricing models account for both components. (2) 7.5% VAT applies to all fees, not just the base rate. (3) International card chargeback risk requires careful implementation of refund and dispute handling. (4) Flutterwave has faced some regulatory challenges historically — stay current on their operational status. (5) Webhook endpoint verification (signature check) is mandatory in production. Company Background Flutterwave was founded by Olugbenga Agboola (GB) and co-founders in 2016. The company has raised over $500M in funding and is valued at over $3 billion, making it one of Africa's most valuable fintech companies. It operates in 34+ African countries and has processed over $26 billion in transactions. FAQs Q: What is the fee for local card payments in Nigeria? A: 2% per transaction (1.4% + 0.6% platform fee), subject to 7.5% VAT. No cap publicly published — verify on the pricing page. Q: Does Flutterwave support USSD payments? A: Yes. USSD is supported at the same 2% local rate. Q: Does Flutterwave support M-Pesa in Kenya? A: Yes. M-Pesa is supported for Kenya and other East African markets. Q: Is there a sandbox? A: Yes. Use test mode API keys (sk_test_...) for sandbox testing. Q: What is the transfer fee? A: ₦10 for transfers ≤₦5,000; ₦25 for ₦5,001–₦50,000; ₦50 for transfers above ₦50,000. All subject to VAT.

Duplo is an API-first financial operating system for African businesses, providing a unified platform for B2B payments, expense management, virtual accounts, FX transfers, and NRS-compliant e-invoicing. Headquartered in Victoria Island, Lagos, Duplo is CBN PSSP-licensed, PCI DSS certified, ISO 27001 and 22301 certified, and NDPR-compliant. In early 2026, Duplo became one of the first Nigerian companies to secure dual NRS (Nigerian Revenue Service) licences for e-invoicing — a critical milestone as Nigeria moves toward mandatory digital invoicing for tax compliance. What the API Does The Duplo API enables businesses to: issue and manage virtual bank accounts; initiate bulk payments to up to 500 recipients simultaneously; process local and international card payments; perform FX conversions in 80+ currencies across 160+ countries; automate expense approval workflows with budget controls; perform auto-reconciliation of transactions; and generate NRS-compliant e-invoices. The platform is designed as both a business tool and an embeddable API layer for fintechs and platforms. How Developers Use It Developers access documentation at developers.tryduplo.com. Authentication uses API keys with clear environment prefixes: dp_test_ for test mode, dp_live_ for live mode. The API is REST-based with JSON payloads over HTTPS. All API calls must be made over HTTPS. Developers must complete compliance requirements before being granted live mode access. A sandbox environment is available for full testing. Pricing Local card transactions: 1.5% capped at approximately ₦1,200–₦1,300. International card transactions: 3.8%–4.0%. Custom volume tiers available for high-volume international processing. Contact Duplo for enterprise pricing. Authentication API keys are managed via the Duplo Dashboard. Test mode uses dp_test_ prefixed keys; live mode uses dp_live_ prefixed keys. Never share live keys publicly. Compliance CBN PSSP-licensed, PCI DSS, ISO 27001, ISO 22301, NDPR-compliant, and NRS dual-licensed for e-invoicing. Duplo is also expanding into South Africa via a partnership with Ozow for instant EFT payments. Challenges and Gotchas (1) Live mode requires completing compliance requirements — not instant. (2) Rate limits not publicly documented. (3) The NRS e-invoicing feature is relatively new and developers should check docs for current implementation status. (4) Duplo is B2B focused — not designed for high-volume consumer checkout flows. (5) International card fees (3.8–4%) are higher than local card fees. Company Background Duplo was founded in Nigeria by Yele Oyekola and Damola Ajao and is backed by prominent African and global VCs. The company is focused on solving the complexity of B2B financial operations in Africa, where businesses often manage payments through manual bank transfers, spreadsheets, and fragmented tools. Duplo consolidates this into a single API-first platform. FAQs Q: Does Duplo support bulk payments? A: Yes. Duplo supports bulk payments to up to 500 recipients in a single API call. Q: What is the fee for local card payments? A: 1.5% capped at approximately ₦1,200–₦1,300 per transaction. Q: Is there a sandbox? A: Yes. Test mode is available using dp_test_ API keys from your dashboard. Q: Does Duplo support e-invoicing for Nigerian tax compliance? A: Yes. Duplo holds NRS dual licences for NRS-compliant e-invoicing — one of the first Nigerian companies to do so. Q: Can Duplo handle international payments? A: Yes. Duplo supports 80+ currencies across 160+ countries with international card acceptance at 3.8–4.0%. Duplo's NRS-compliant e-invoicing capability supports Nigerian businesses' obligations under the Federal Inland Revenue Service's e-invoicing requirements, allowing platforms to generate and submit compliant electronic invoices as part of the B2B payment workflow rather than as a separate process.

ErcasPay is a CBN PSSP-licensed, PCI DSS-certified, and NDPA-compliant multicurrency payment gateway built specifically for Nigerian businesses. The platform supports 8 currencies — NGN, USD, GBP, EUR, CAD, GHS, GMD, and KES — enabling Nigerian merchants to accept both local and international payments through a single API integration. ErcasPay processes transactions from 5,000+ businesses and has offices in Lagos, Abuja, and Ibadan. What the API Does The ErcasPay REST API enables developers to: initiate and process local card payments (Verve, Visa, Mastercard), bank transfers, USSD, and QR code payments; accept international card payments in 7 foreign currencies; issue and manage virtual account numbers for NGN collections; generate payment links; and create invoices. The API uses separate sandbox and live environments with distinct base URLs. How Developers Use It Developers create an account at ercaspay.com, obtain API keys from the dashboard under developer settings, and integrate using the documentation at docs.ercaspay.com. Authentication uses Bearer tokens with secret keys prefixed ECRS-TEST-SK (sandbox) and ECRS-LIVE-SK (live). Sandbox base URL: api-staging.ercaspay.com/api/v1. Live base URL: api.ercaspay.com/api/v1. All requests require Accept: application/json and Content-Type: application/json headers. Pricing Local transactions (cards, bank transfer, QR, USSD): 1.4% per transaction, capped at ₦2,000. International card transactions: 4.8% per transaction. International payments first settle to a USD wallet; conversion to NGN is triggered from there. A 10% rolling reserve is applied on international card transactions, held for 180 days — refundable if no chargebacks occur. No monthly subscription fee. Authentication Bearer token authentication. Secret key placed in the Authorization header as "Bearer {SECRET_KEY}". Separate keys for test and live modes. Keys managed from the ErcasPay Dashboard. Compliance CBN PSSP-licensed, PCI DSS certified, and compliant with the Nigeria Data Protection Act (NDPA). Multi-location presence in Lagos, Abuja, and Ibadan. Challenges and Gotchas (1) 10% rolling reserve on international card transactions held 180 days can be a significant cash flow constraint for new merchants. (2) International payments do not settle directly in NGN — they go to a USD wallet first. (3) No recurring billing or split payment support currently. (4) Rate limits not publicly documented — confirm with ErcasPay before high-volume implementations. Company Background ErcasPay is operated by ErcasPay Nigeria Limited, headquartered in Lagos with offices in Abuja and Ibadan. The company targets Nigerian businesses of all sizes needing a reliable, multi-currency alternative payment gateway. FAQs Q: What is the fee for local card payments? A: 1.4% capped at ₦2,000 per transaction. Q: Does ErcasPay support USSD payments? A: Yes. USSD is supported at the same 1.4% (capped ₦2,000) local rate. Q: What currencies can I accept through ErcasPay? A: NGN, USD, GBP, EUR, CAD, GHS, GMD, and KES — 8 currencies total. Q: Is there a sandbox? A: Yes. Sandbox at api-staging.ercaspay.com/api/v1 using ECRS-TEST-SK keys. Q: What is the rolling reserve? A: A 10% hold on international card transaction amounts, retained for 180 days. It is refunded in full if no chargebacks are filed during that period. ErcasPay's multi-currency acceptance — NGN plus USD, GBP, EUR, CAD, and additional international currencies — enables Nigerian merchants to accept payments from both domestic customers paying in naira and international customers paying in their home currency. This dual-currency capability in a single gateway integration eliminates the need for separate domestic and international payment gateway relationships, reducing integration complexity and ongoing vendor management for Nigerian businesses serving both local and global customer segments. PCI DSS certification at ErcasPay ensures that card data handling meets international security standards, protecting Nigerian merchants from the liability and reputational risk of card data breaches. For Nigerian SMEs that lack the resources to implement independent PCI compliance infrastructure, using a certified gateway like ErcasPay allows them to accept card payments within a compliant infrastructure environment without bearing the cost and complexity of independent certification.

GTPay is the online payment gateway from Guaranty Trust Bank (now Guaranty Trust Holding Company — GTCo), one of Nigeria's largest and most recognized tier-1 banks. GTPay enables Nigerian merchants to accept card payments online from customers using Interswitch (Verve), Visa, and Mastercard — both locally issued and international cards. The gateway is backed by GTBank's banking infrastructure and has been serving Nigerian e-commerce merchants since the early days of online payments in Nigeria. What GTPay Does GTPay processes card-present-not-required (CNP) transactions for online merchants, collecting payment from customers and settling into the merchant's GTBank business account. The gateway supports NGN (currency code 566) and USD (currency code 840) transactions, making it usable for both local NGN e-commerce and international USD billing. How Developers Use It Developers obtain a Merchant ID and Hash Key by physically visiting any GTBank branch nationwide and registering as a GTPay merchant. After registration, integration is done using the technical parameters documented at ibank.gtbank.com/gtpay/IntegrationAPI/mman-tech.html. Key parameters include: gtpay_mert_id (merchant identifier), gtpay_tranx_id (unique transaction ID from merchant), gtpay_tranx_amt (amount in kobo or cents), and gtpay_tranx_curr (ISO currency code — 566 for NGN, 840 for USD). The Hash Key is used to generate a transaction hash for request signing. Pricing Local card transactions: 1.5% fee capped at ₦2,000. Contact GTBank for the full fee schedule including international card rates. Authentication Merchant ID and Hash Key pair obtained from GTBank branch. Transactions are signed using the Hash Key to generate a security hash that GTBank validates before processing. Compliance GTPay is operated by Guaranty Trust Bank (CBN-licensed), ensuring full CBN compliance for all payment processing. PCI DSS compliant for card data handling. Important Note on Legacy Status GTCo (formerly GTBank) has since launched Squad (squadco.com) as their modern, developer-first payment platform under HabariPay Limited. Squad offers a comprehensive REST API with sandbox, webhooks, virtual accounts, and full documentation. For new integrations, Squad is the recommended modern alternative to GTPay. GTPay remains operational for existing merchants. Challenges and Gotchas (1) Merchant registration requires a physical GTBank branch visit — not self-serve online. (2) GTPay is a legacy product — documentation is older and less comprehensive than modern gateways. (3) No bank transfer, USSD, or recurring billing support. (4) Integration is form-post based rather than modern REST JSON API. (5) New projects should seriously consider Squad (HabariPay) instead. FAQs Q: How do I get a GTPay Merchant ID? A: Visit any GTBank branch nationwide with your business documents to register as a GTPay merchant. Q: Is GTPay still active? A: Yes, GTPay remains operational for existing merchants but GTCo's newer platform Squad is the recommended modern alternative. Q: Does GTPay support USSD or bank transfer? A: No. GTPay only supports card payments (Interswitch/Verve, Visa, Mastercard). Q: What currencies does GTPay support? A: NGN (566) and USD (840). GTPay's backing by Guaranty Trust Bank (GTBank) — consistently ranked among Nigeria's top tier-1 banks — provides GTPay merchants with the financial security and institutional credibility that bank-affiliated payment infrastructure carries. For Nigerian businesses where their payment gateway provider's financial stability is a selection criterion — particularly for merchants holding float or awaiting settlement — a bank-affiliated gateway provides assurance that is difficult for independent fintech providers to match. The settlement process for GTPay transactions credits merchant accounts within GTBank's settlement cycle, with same-day or next-day settlement available for GTPay merchants who also hold GTBank business accounts. This tight integration between payment gateway and bank account reduces settlement float and simplifies reconciliation for merchants whose primary banking relationship is with GTBank, one of the largest retail and commercial banking relationships in Nigeria.

Paystack is Nigeria's most widely adopted payment gateway API and is a subsidiary of Stripe, the global payments infrastructure company that acquired Paystack in 2020. Founded in 2015 by Shola Akinlade and Ezra Olubi, Paystack was part of Y Combinator's 2016 batch and quickly became the default payment choice for Nigerian developers and businesses. The company is CBN-licensed and PCI-DSS compliant, and currently serves thousands of businesses across Nigeria, Ghana, South Africa, and Kenya. The Paystack API is RESTful and uses Bearer Token authentication. Every request must include an Authorization header with the format: Authorization: Bearer sk_live_xxxx (for production) or Authorization: Bearer sk_test_xxxx (for sandbox). API keys are obtained from the Paystack dashboard at dashboard.paystack.com. Paystack provides both public keys (used in client-side code to initialize the checkout) and secret keys (used server-side for all API calls). Developers must never expose the secret key in client-side code. The standard Paystack integration flow involves three steps: initialize a transaction server-side using the /transaction/initialize endpoint (passing email, amount in kobo, and optional metadata), redirect the user to the returned authorization URL or embed the Paystack inline popup using the JavaScript SDK, then verify the transaction on your server using /transaction/verify/:reference after the customer is redirected back. This three-step flow ensures transactions are validated server-side before fulfilling orders, preventing fraud and order manipulation. Paystack supports the widest range of payment channels of any Nigerian gateway: Verve, Visa, and Mastercard debit cards; bank transfer (pay by transfer); USSD (for customers without smartphones); mobile money (in Ghana); and QR code payments. The Paystack Checkout modal intelligently displays only the channels available for the customer's device and location. In terms of pricing, local card transactions cost 1.5% plus ₦100, capped at ₦2,000 per transaction. The ₦100 flat fee is waived for transactions of ₦2,500 or less. This means very small transactions (micro-payments) are effectively charged at 1.5% only. International card transactions cost 3.9% plus ₦100, with no cap. Bank transfers (receiving payments via bank account) are charged flat: ₦10 for amounts up to ₦5,000; ₦25 for ₦5,001 to ₦50,000; and ₦50 for amounts above ₦50,000. Outgoing transfers (disbursements) are: ₦10 for ₦0–₦5,000; ₦25 for ₦5,001–₦50,000; ₦50 for above ₦50,000. There are no setup fees and no monthly platform fees. Businesses processing more than ₦10 million per month are eligible for volume-based discounts by contacting Paystack enterprise support. The Paystack sandbox environment mirrors production exactly — all features available in live mode are available in test mode. This is a critical advantage for Nigerian developers who need to test subscription billing, split payments, and bulk transfers without using real money. Test mode uses test card numbers provided in the Paystack documentation and simulates bank transfer payments via a confirmation prompt. Paystack also provides a Subscriptions API that allows developers to create subscription plans with daily, weekly, monthly, or annual billing cycles. When a customer first pays, a subscription authorization token is generated and stored securely by Paystack. Subsequent charges happen automatically without requiring the customer to re-enter card details. This is the foundation for building SaaS billing, membership platforms, and digital subscription products in Nigeria. The Split Payments (multi-split) feature allows marketplace operators to automatically split collected revenue between multiple subaccounts at the time of transaction — specifying percentages or flat amounts for each recipient. This is commonly used by Nigerian food delivery platforms, logistics aggregators, and gig economy apps. The Bulk Transfers API enables disbursement to hundreds of Nigerian bank accounts in a single API call by submitting a list of transfer recipients. This is used for payroll, agent commissions, loan disbursements, and customer refunds. From a compliance standpoint, Paystack is PCI-DSS Level 1 certified — the highest level of payment card security certification. All card data is encrypted and processed on Paystack's infrastructure. Merchants are not required to be PCI-DSS certified themselves. Paystack operates under CBN supervision and complies with the Nigerian Data Protection Regulation (NDPR). Webhook events from Paystack must be validated using the HMAC-SHA512 signature sent in the X-Paystack-Signature header. Developers should validate this signature before processing any webhook event. Paystack retries failed webhooks for up to 72 hours. Known challenges for Nigerian developers: (1) International card transactions have no cap on the 3.9% fee — high-value international payments can be expensive. (2) Bank transfer payments can take up to 30 minutes during bank downtime, so developers must handle pending states gracefully. (3) BVN and NIN verification are not built into Paystack directly — these require Dojah or Smile Identity as a separate integration. Frequently Asked Questions: Can I use Paystack without a registered business? Yes — individuals can create a starter account and start accepting payments. However, you will need to provide CAC documents to unlock higher transaction limits and settlements. Does Paystack support USD payments? Paystack processes international cards in USD, but settlements are in NGN after conversion. USD settlement is available only for Paystack International accounts. Can I process recurring payments automatically? Yes — use the Subscriptions API to save a customer authorization token and charge them on any schedule automatically. Is the test environment exactly like production? Yes — Paystack test mode has full feature parity with live mode, including subscriptions, splits, and bulk transfers.

Stripe is the world's leading developer-first payment infrastructure platform, offering a comprehensive suite of APIs for accepting payments, managing subscriptions, running marketplaces, issuing cards, and managing financial operations across 195+ countries. Stripe processes hundreds of billions of dollars annually for millions of businesses globally and is widely regarded as setting the gold standard for payment API design, documentation quality, and developer experience. CRITICAL NOTE FOR NIGERIAN BUSINESSES: Stripe does not currently support merchant account registration for Nigeria-incorporated businesses, NGN settlement to Nigerian bank accounts, or local Nigerian payment methods (bank transfers, USSD, Verve cards). Nigerian businesses cannot register a Stripe account as a Nigerian entity. Nigerian businesses needing local payment processing should use CBN-licensed alternatives: Paystack (Stripe subsidiary, Nigeria-optimized), Flutterwave, Monnify, Kora, or other Nigerian-licensed payment processors. However, Stripe remains highly relevant to the Nigerian tech ecosystem in several important capacities. Paystack — Nigeria's leading payment gateway and most developer-loved fintech API — was acquired by Stripe in 2020 and has adopted many of Stripe's API design conventions. Nigerian developers who learn Stripe's patterns (idempotency keys, webhook signature verification, payment intent lifecycle, connect architecture) will find this knowledge directly transferable when building on Paystack or other modern payment APIs. Diaspora and cross-border cases: Nigerian-founded companies incorporated in the United States, United Kingdom, or other Stripe-supported markets can register Stripe accounts under those foreign entities and use Stripe to charge international customers. This is a common path for Nigerian SaaS founders who incorporate in Delaware (for US market access or investor requirements) and use Stripe to charge global subscribers. The Nigerian individual may build and operate the product, but the contracting entity is foreign-incorporated. Stripe Connect is Stripe's marketplace and platform payment architecture, allowing a platform business to facilitate payments between buyers and sellers or service providers with automatic split payment, commission deduction, and payout management. For Nigerian developers building marketplace products intended for international markets — freelance platforms, services marketplaces, SaaS reseller programs — Stripe Connect provides the payment infrastructure to handle multi-party money flows between international participants. Stripe Billing handles subscription management, recurring payment scheduling, proration for mid-cycle plan changes, invoice generation, retry logic for failed payments, and metered billing for usage-based pricing. For SaaS products serving international markets, Stripe Billing reduces subscription payment infrastructure development from months to days while handling edge cases like payment method expiration, card declines, and dunning flows automatically. Stripe Radar is an AI-powered fraud detection system that scores every payment request in real time and can automatically block suspicious transactions based on customizable rules. For platforms handling international transactions that include potentially high-fraud regions or payment patterns, Radar provides machine learning-based fraud prevention without building custom fraud detection infrastructure. Stripe's documentation is widely considered the best in the payments industry — comprehensive, accurate, with full API reference, extensive guides for common integration patterns, and code examples in multiple languages. Nigerian developers studying payment API design use Stripe documentation as a reference model for understanding best practices in API design, error handling, webhook architecture, and payment security that apply across any payment provider.