Open source · MIT · TypeScript

Real products, built on FossaPay.

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.

Four products, four patterns

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.

NairaBridge: sell crypto and receive naira

NairaBridge

A cross-chain off-ramp. Sell tokens from Arbitrum, Base, Ethereum, Solana or NEAR and receive naira in a Nigerian bank account.

PayoutsBank enquiryIdempotent retrySSE
SafeDeal: escrow for social commerce

SafeDeal

Escrow for WhatsApp and Instagram sellers. The buyer's money is held until they confirm the item, with a dispute desk for the rest.

CheckoutsWallet transfersPayoutsState machine
SquadPay: split a bill with friends

SquadPay

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.

Many checkoutsKobo-safe mathsWebhooksLive board
AjoSphere: a digital savings circle

AjoSphere

A digital Ajo / Esusu savings circle. Members are identity-verified, get dedicated deposit accounts, and take turns receiving the pot.

BVN / NIN KYCDedicated accountsDeposit webhooksScheduled payout
Running them yourself: the demos are not hosted. They are meant to be cloned and run locally (see Quick start), where sandbox mode needs no account, no key and no money.

One client, two transports

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.

your app code | FossaPayClient |-- mock --> in-memory ledger | offline, free, signs webhooks '-- live --> api-production.fossapay.com

Idempotency everywhere

Keys derive from your own business IDs, so a retry after a crash can never pay twice.

Signed webhooks, done right

Both documented signature schemes, timing-safe comparison, de-duplication, and failure to a closed door when no secret is set.

Money without floats

Whole-naira requests, kobo-integer maths, and remainder-safe splitting.

Quick start

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
  1. Run in sandbox. No configuration. Click through a whole journey, including simulated payments and webhooks.
  2. Read the code. Each demo's store file is the integration, in one place.
  3. Go live carefully. Set FOSSAPAY_MODE=live, a key and a webhook secret. Forms go blank and simulators disappear. Read the checklist first.

The integration guide

Written to be followed, not skimmed. Start at the top, or jump to what you need.

New to FossaPay itself? See the official API documentation, the Node SDK and the dashboard.