Money movement, built into your product
Create customers, issue NGN virtual accounts, collect payments, send payouts, and manage stablecoin wallets through one production API.Start building
Follow a complete flow from your production API key to a verified live payment.
Explore the API
Find request fields, response schemas, and executable examples for every endpoint.
One API for every money flow
Collect payments
Create dedicated NGN virtual accounts and receive real-time deposit webhooks.
Send payouts
Resolve bank accounts, calculate fees, and send traceable NGN payouts.
Power wallets
Give each customer an individual NGN or stablecoin wallet and track its balance.
Make your first request
Create the customer before provisioning their wallet. The returned customer ID connects the rest of the payment flow.Create a customer
Create a customer
Review the complete request body, response fields, and playground for this endpoint.
A clear path to your first payment
1
Authenticate securely
Create a production key in the dashboard and send it in the
x-api-key header.2
Create the customer and wallet
Create the customer first, then use the returned customer ID to provision their individual wallet.
3
Configure webhooks
Add your webhook URL and secret before initiating a payment so your application can verify every event.
4
Validate with a small live amount
Make a controlled production payment, verify the webhook, and retrieve the transaction record.
Go deeper
Understand FossaPay
Learn how the platform’s customers, wallets, transfers, and webhooks fit together.
Authentication
Protect production keys, authenticate requests, and prevent duplicate operations.
Webhooks
Verify signatures and build reliable, idempotent event handlers.
Get production API access
Create a FossaPay account, complete verification, and generate your production key.