Providers & Routing
BirrPay orchestrates four gateways: Flutterwave, Paystack, KoraPay and PayPal. Bring your own merchant account for each; add the credentials in the dashboard (tenant-level defaults and per-app overrides).
Credential scopes
| Provider | What BirrPay stores (encrypted at rest) |
|---|---|
| Flutterwave | Secret key, encryption key, secret hash |
| Paystack | Secret key |
| KoraPay | Secret key |
| PayPal | Client id, client secret, webhook id |
Routing rules
- If the session pins
provider, that provider is used (must be configured). - Else the app's default provider (if configured and capable).
- Else the first configured provider, in your priority order, that supports the currency and channels.
Capability matrix (currencies)
| Provider | Currencies |
|---|---|
| Flutterwave | NGN, GHS, KES, ZAR, USD, GBP, EUR, XOF, XAF |
| Paystack | NGN, GHS, ZAR, USD |
| KoraPay | NGN, GHS, KES, USD |
| PayPal | USD, GBP, EUR |
Test mode credentials come from each provider's test environment; BirrPay keeps test and live traffic strictly separated.
Ready to take your first payment?
Create account