General
What is BirrPay?
BirrPay is a payment orchestration processor. It sits between your apps and gateways like Flutterwave, Paystack, KoraPay and PayPal, giving you one API, one dashboard, and signed webhooks for every app — even when your providers allow only a handful of webhook URLs.
Do I need my own merchant accounts?
Yes. BirrPay is not an aggregator. Each tenant brings their own provider accounts (e.g. one Paystack account, one Flutterwave account) and registers them in the dashboard. BirrPay then routes all your apps through those accounts.
Apps
How do multiple apps share one provider account?
Every app you create on BirrPay gets its own API keys, its own webhook endpoint and its own checkout configuration. BirrPay multiplexes all of them over your single provider account and fans provider events back to the right app.
Checkout
Does the inline checkout redirect my customers away?
No. The BirrPay inline widget runs in a secure overlay inside your own page. Your customers never leave your website. A hosted checkout page is also available when you prefer redirects.
Security
How are my provider credentials stored?
Provider credentials are encrypted at rest with AES-256-GCM (field-level encryption in the database). They are decrypted only in memory, only when a charge or verification needs them, and are never returned by any API.
How do I verify that a webhook really came from BirrPay?
Every delivery carries an X-BirrPay-Signature header (t=timestamp,v1=hmac). Compute HMAC-SHA256 over "{t}.{rawBody}" with your app webhook secret and compare in constant time. The docs include ready-to-copy verification code.
Webhooks
What happens if my server is down when a webhook fires?
BirrPay retries with exponential backoff up to 8 attempts, then parks the delivery as dead. You can replay any dead delivery from the dashboard at any time.
Payments
Which currencies are supported?
NGN, GHS, KES, ZAR, USD, GBP and EUR depending on the provider. The dashboard shows a capability matrix and BirrPay automatically routes sessions to a provider that supports the requested currency and channels.
Is there a test mode?
Yes. Test mode uses your providers' test credentials, never moves real money, and is fully separated from live data — keys, transactions, webhooks and analytics.
Billing
What does BirrPay charge?
By default 1.5% + a small flat fee per successful transaction, capped. The exact fee per app is visible in your dashboard and configurable by platform operators. Provider-side fees remain your agreement with the provider.