A Paystack payment gateway for FOSSBilling (and the BoxBilling it forked from). It lets FOSSBilling accept one-time invoice payments via Paystack — cards and mobile money (MoMo) — with separate test and live modes.
Community adapter — not an official integration from Paystack or FOSSBilling.
- One-time invoice payments through Paystack (cards, mobile money)
- Live and test modes (separate public/secret keys)
- Configurable transaction charge (%)
- Optional automatic invoice processing after a successful payment
- Webhook (IPN) handling with signature verification
- Renders inline (loads in an iframe)
Recurring/subscription billing is not supported.
- FOSSBilling (or legacy BoxBilling)
- PHP 8.1+ with the cURL extension enabled
- A Paystack account and API keys (Paystack Dashboard → Settings → API Keys & Webhooks)
-
Copy the adapter into your FOSSBilling payment-adapters directory:
cp src/Paystack.php <fossbilling>/library/Payment/Adapter/Paystack.php
(Optional: add a
paystack.pnglogo to your payment-gateway assets so it shows at checkout.) -
In the FOSSBilling admin, go to System → Payment gateways, find Paystack, and enable it.
-
Configure it:
Setting Description Live Public Key / Live Secret Key From your Paystack dashboard Test Public Key / Test Secret Key For sandbox testing Transaction Charge (%) Optional fee added at checkout Process invoice after payment Yes/No -
(Recommended) In the Paystack dashboard, set your webhook URL to your FOSSBilling IPN endpoint so payments are confirmed automatically. Incoming webhooks are validated against the
x-paystack-signatureheader.
Once enabled, Paystack appears as a payment option on client invoices. Customers pay by card or mobile money; on a successful transaction the payment is recorded against the invoice (and the invoice is auto-processed if that option is on).
composer install
composer test # runs the PHPUnit suiteSamuel Apraku