4 Best APIs for Subscriptions in Nigeria

Square API is a comprehensive payment and commerce platform API from Square, Inc. (now Block, Inc.) that enables developers to build custom point-of-sale applications, online payment flows, inventory management systems, subscription billing, and retail commerce solutions. Square provides a deeply integrated suite of commerce APIs covering payments, orders, inventory, customer management, loyalty programs, and employee management that work together to provide a complete retail and services business management platform. IMPORTANT NOTE FOR NIGERIAN DEVELOPERS: Square does not currently operate in Nigeria and does not support Nigerian merchants registering for Square accounts, processing NGN transactions, or receiving settlements to Nigerian bank accounts. Square operates in the United States, Canada, United Kingdom, Australia, Japan, France, Spain, and Ireland only. Nigerian businesses looking for equivalent payment processing capabilities should use Nigerian-licensed alternatives such as Paystack, Flutterwave, Monnify, or Kora. Despite not supporting Nigeria directly, Square API is documented here for several relevant reasons. First, Nigerian tech professionals working for international companies, remote contractors, and developers building products for non-Nigerian markets frequently work with Square. Second, Nigerian developers building applications for clients in Square-supported markets need API documentation to understand the integration requirements. Third, the architectural patterns used by Square — particularly their Payments API, Web Payments SDK, and order management system — are studied by Nigerian developers learning payment system design. The Square Payments API processes card-not-present payments through the Web Payments SDK (a JavaScript library that renders a PCI-compliant card entry form in web browsers) and the In-App Payments SDK (for iOS and Android native apps). These SDKs handle card data capture and tokenization in the browser or app, then pass a payment token to the backend which makes a charge call to the Square Payments API without sensitive card data ever touching the developer's servers. This architecture demonstrates PCI compliance best practices relevant to payment developers globally. Square Orders API provides comprehensive order lifecycle management: creating orders with line items, modifiers, and taxes, updating order status, applying discounts, processing partial fulfillments, and attaching payments to orders. This orders-centric model — where payments fulfill orders rather than existing independently — is architecturally different from many payment APIs and represents a more complete retail commerce model that connects inventory, pricing, and payment into a unified order record. Square Inventory API tracks product stock levels across multiple locations, providing real-time inventory counts, adjustment tracking, and low-stock alerting. For developers building multi-location retail management systems in Square-supported markets, the inventory API enables the stock synchronization between physical and online sales channels that prevents overselling and allows accurate availability display. Square Subscriptions API handles recurring billing, creating subscription plans with billing cadences, trial periods, and pricing tiers, and automatically charging customers on schedule. Subscription webhooks notify the integrating application of billing events, failed payments, and subscription status changes. This recurring billing infrastructure is used by subscription box services, membership businesses, and SaaS products operating in Square markets. Square Loyalty API builds customer loyalty programs directly into the payment flow, automatically awarding points on eligible purchases, tracking redemption history, and applying loyalty discounts at checkout. For businesses in Square-supported markets wanting to reward repeat customers without separate loyalty program infrastructure, the integrated loyalty system captures purchase data automatically through the normal payment flow. Nigerian developers can access Square's sandbox environment freely for learning and testing purposes, using test credentials to exercise all API endpoints without processing real payments.

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.