FinConnect: Unified East African Payments SDK

FinConnect is a TypeScript SDK that unifies East Africa fintech companies’ mobile payment services behind a single API, eliminating per-provider auth flows and payload differences for Node.js apps.

FinConnect provides a single interface for processing payments across multiple East African fintech platforms. Without it, you would need to manage different authentication flows (OAuth2 for PesaPal, JWT for ClickPesa), learn each provider’s payload structure, and write custom error handling for every API. FinConnect abstracts all of that behind one consistent API so you can swap or add providers without rewriting your integration.

Key features

• Provider-agnostic API — one interface (FintechSDK) works across all supported providers
• Multi-auth support — OAuth2 and JWT authentication handled transparently per provider
• TypeScript-first — full type definitions and compile-time safety out of the box
• USSD push payment initiation — trigger mobile money payments directly from your server
• IPN/webhook support — register Instant Payment Notification endpoints to receive real-time payment events
• Consistent error handling — providers surface errors with uniform messages so you handle one error pattern, not several

Supported providers

Provider	Auth method	Region	Status
PesaPal	OAuth2 (Bearer token)	East Africa	Available
ClickPesa	JWT	East Africa	Available
AzamPay	Bearer/Secret	Tanzania	Available
ZenoPay	Bearer/Secret	Tanzania	Planned

Next steps

Quick Start

Install FinConnect and process your first payment in minutes.

Configuration

Set up provider credentials and environment variables.