Developers
Integrate Supapay into your product
Third-party apps use Supapay to collect payments, pay out to Nigerian banks, and stay aligned with a ledger-first wallet. You own the product experience; Supapay moves the money.
What you can build
Collect
Payment intents, hosted checkout, and account-number collections that settle to your business wallet.
Events
Signed webhooks for successful collections, failed attempts, and payout status you can trust in production.
Test and live
Separate API keys for test and live. Runtime mode follows the key you use, not a duplicate environment.
Standard flow
From intent to webhook in four steps
You pass the final amount and collection currency. Supapay handles rails, settlement, and wallet posting. Do not reimplement settlement rules in your app.
- 01
Create a payment intent
Send amount, currency, destination wallet, and your order reference. Supapay returns what the customer needs to pay.
- 02
Present checkout
Use hosted checkout, the payment widget, or the SDK. Customers pay by bank transfer or card where enabled.
- 03
Listen for webhooks
Confirm success in your system when Supapay posts a signed event. Use idempotency keys on every create call.
- 04
Reconcile in your dashboard
Match webhook references to orders or invoices. Payouts and balances stay visible in the merchant dashboard.
Technical docs
Guides and API reference
- IntroductionAuthentication, environments, and how Supapay fits your stack.Read guide
- Payment widgetEmbed hosted checkout on your site or in your app.Read guide
- JavaScript SDKControl the payment lifecycle from your frontend.Read guide
- API referenceREST resources for intents, collections, payouts, and webhooks.Read guide
Need help wiring webhooks or test keys? Visit support or contact us.
View pricing