How to Handle Subscriptions and Recurring Billing in a Nigerian SaaS

Recurring billing is the engine that keeps your SaaS alive. In Nigeria, you face unique challenges: payment gateway reliability, Naira volatility, bank card authentication rules, and high rates of failed transactions. Here is how to build a subscription system that works for Nigerian customers.

Choosing Your Payment Gateway: Paystack vs Flutterwave

Paystack is the best starting point for Nigerian subscriptions. It supports recurring charges through its subscription API, handles NGN and USD payments, and provides strong developer documentation. You can create plans, attach customers, and manage billing cycles with a few API calls. Paystack also supports USSD payments, which helps users who do not have international cards.

Flutterwave is a strong second option, especially if you plan to expand across West Africa. It covers Ghana (GHS), Kenya (KES), and other African currencies. Flutterwave also supports bank transfers and mobile money, which are popular outside Nigeria. Many SaaS products use both gateways: Paystack for Nigerian customers and Flutterwave for regional customers.

Do not rely on a single gateway. Payment processor downtime directly affects your revenue. Set up a fallback gateway so that if Paystack is down, Flutterwave processes the charge. This redundancy adds complexity but protects your subscription revenue.

Setting Up Recurring Charges the Right Way

Create pricing plans in your gateway before you start charging customers. Each plan defines the amount, currency, billing interval, and trial period. Store the gateway plan ID in your database and link it to the customer subscription record. This keeps your billing logic clean and makes it easy to switch plans later.

Use webhooks to track subscription events. Paystack sends webhooks for subscription creation, payment success, payment failure, and subscription expiration. Your application must listen for these events and update the customer status in your database. A missed webhook can leave a paying customer marked as inactive or an unpaid customer with full access.

Store the gateway reference for every transaction. When you need to investigate a billing issue, you can look up the exact transaction in the gateway dashboard. Nigerian banks sometimes flag recurring charges as fraud, and having the transaction reference speeds up resolution with customer support.

Handling Failed Payments With Dunning Emails

Failed payments are common in Nigeria. Cards expire, bank authentication fails, or the customer does not have sufficient funds. Your dunning workflow determines whether you keep or lose that customer. A good dunning system retries the payment automatically and sends reminders before you restrict access.

Set your retry schedule carefully. Retry the payment 3 days after the first failure, then 5 days, then 7 days. After each failed attempt, send an email and an SMS alert. Nigerian users respond better to SMS than email alone. Include a direct link to update their payment method so they can fix the issue in one click.

After three failed attempts, downgrade the account to a restricted state instead of canceling it. Keep their data accessible in read-only mode. This protects their work while preventing further charges. Send a final notification that their account will be suspended after 14 days if payment is not resolved. Most customers will update their card information during this grace period.

Proration: Fair Billing for Plan Changes

Proration handles what happens when a customer upgrades or downgrades mid-cycle. Without proration, customers feel cheated when they pay for a full month of a plan they used for only half the time. With proration, you charge or credit the exact amount for the days used on each plan.

When a customer upgrades, calculate the unused value of their current plan and apply it as a credit toward the new plan. Charge only the difference. This makes upgrades feel fair and instant. When a customer downgrades, issue a credit for the unused days on their current plan that applies to their next billing cycle.

Implement proration logic in your application rather than relying on the gateway alone. Store the proration calculation in your database and present it to the customer before you process the change. Transparency here builds trust. Let the customer see exactly what they will be charged or credited before they confirm the plan change.

Invoice Generation for Nigerian Businesses

Nigerian businesses need proper invoices for their accounting and tax filings. A receipt from Paystack is not enough. Generate professional PDF invoices that include your company name, CAC registration number, the customer's name and address, a unique invoice number, the billing period, the plan name, the amount charged in Naira, the VAT amount (if applicable), and the payment date.

Send the invoice by email immediately after a successful payment. Store invoices in your application so customers can download them anytime. Some businesses need invoices at the beginning of the billing period rather than after payment. Offer both options in your billing settings to reduce support requests from finance departments.

Include your VAT information if you are registered. Nigerian businesses that are VAT-registered need valid invoices to claim input VAT. If your SaaS is below the VAT threshold, state this clearly on the invoice. Proper invoicing makes your product look professional and helps your customers comply with tax regulations.

Compliance With CBN Recurring Debit Rules

The Central Bank of Nigeria requires that customers give explicit consent for recurring debit transactions. You must explain the amount, frequency, and duration of the charges before the customer authorizes the payment. Store a record of this consent, including timestamps and IP addresses, to prove compliance if questions arise.

Send a notification before every recurring charge. The notification must state the amount, the date of the charge, and instructions for canceling. Nigerian customers have the right to cancel recurring debits at any time. Make cancellation easy by providing a self-service option in your application. Do not force customers to email support to cancel a subscription.

Process refunds quickly when customers request them. The CBN expects merchants to handle disputes promptly. A slow refund process can lead to chargebacks and damage your reputation with payment gateways. Set a target of processing refunds within 48 hours of the request.

Frequently Asked Questions