> ## Documentation Index
> Fetch the complete documentation index at: https://finconnect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<CardGroup cols={2}>
  <Card title="Quick Start" icon="bolt" href="/quickstart">
    Install FinConnect and process your first payment in minutes.
  </Card>

  <Card title="Configuration" icon="gear" href="/configuration">
    Set up provider credentials and environment variables.
  </Card>
</CardGroup>