NairaBridge
A cross-chain off-ramp. Sell tokens from Arbitrum, Base, Ethereum, Solana or NEAR and receive naira in a Nigerian bank account.
Four working demo apps that show how to put FossaPay's collections, payouts, wallets, identity checks and webhooks into products people actually use, plus a guide that explains every integration pattern.
Each demo is a complete Next.js app that runs offline in sandbox mode, and maps onto the real FossaPay API in live mode. Open the source, or run it in under a minute.
A cross-chain off-ramp. Sell tokens from Arbitrum, Base, Ethereum, Solana or NEAR and receive naira in a Nigerian bank account.
Escrow for WhatsApp and Instagram sellers. The buyer's money is held until they confirm the item, with a dispute desk for the rest.
Split a group bill. Every friend pays their share into their own account, and the total lands in the host's bank in one payout.
A digital Ajo / Esusu savings circle. Members are identity-verified, get dedicated deposit accounts, and take turns receiving the pot.
FossaPay is production-only: there is no sandbox, and a live key moves real money. So every demo talks to a shared client that can run against an in-memory ledger or the real API, with no change to your product code.
Keys derive from your own business IDs, so a retry after a crash can never pay twice.
Both documented signature schemes, timing-safe comparison, de-duplication, and failure to a closed door when no secret is set.
Whole-naira requests, kobo-integer maths, and remainder-safe splitting.
Node.js 20+ is all you need.
git clone https://github.com/Penivera/fossapay-demo.git
cd fossapay-demo
npm install
npm run build --workspace=packages/fossapay-client
npm run dev:safedeal # http://localhost:3001
npm run dev:squadpay # http://localhost:3002
npm run dev:ajosphere # http://localhost:3003
npm run dev:offramp # http://localhost:3000
FOSSAPAY_MODE=live, a key and a webhook secret. Forms go blank and simulators disappear. Read the checklist first.Written to be followed, not skimmed. Start at the top, or jump to what you need.
Run it, sandbox vs live, environment variables.
Envelopes, idempotency, whole-naira amounts, checkouts, payouts, KYC.
Verify signatures, de-duplicate, reconcile, test locally.
How each demo maps a product idea to FossaPay calls.
The mock ledger, contract tests, and no-sandbox strategy.
What separates a demo from a product that holds money.
New to FossaPay itself? See the official API documentation, the Node SDK and the dashboard.