FinConnect: East African Payments in One SDK

FinConnect is a TypeScript SDK that unifies PesaPal and ClickPesa under one API, handling OAuth2 and JWT auth for East African mobile payment processing.

FinConnect gives you a single, unified interface for processing payments across multiple East African fintech platforms. Instead of learning each provider’s authentication flow, payload structure, and error handling separately, you write one integration and FinConnect handles the rest.

Quick Start

Install FinConnect and process your first payment in minutes.

Configuration

Set up your provider credentials and environment settings.

PesaPal Guide

Accept payments via PesaPal with OAuth2 authentication.

ClickPesa Guide

Initiate USSD push payments through ClickPesa with JWT auth.

IPN & Webhooks

Register IPN endpoints to receive real-time payment notifications.

API Reference

Full reference for the FintechSDK class and all provider methods.

How it works

1. Install the SDK

   Add FinConnect to your Node.js project via npm.

2. Configure your provider

   Set your provider credentials (PesaPal, ClickPesa) in environment variables.

3. Initialize FintechSDK

   Create an instance with your chosen provider and config, using ProviderFactory under the hood.

4. Process payments

   Call sdk.pay() with the payment details. FinConnect authenticates, formats, and routes the request to the provider automatically.

Supported providers

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

All API calls are made over HTTPS. Never hard-code credentials — use environment variables as shown in the Configuration guide.