PesaBridge
Developer documentation

Build with the PesaBridge API.

Guides for collections, payouts, hosted checkout and webhooks, with examples you can paste straight into your terminal. Everything runs in the sandbox first.

Base URL

https://pesa-bridge.com/api/bridgepay/v1

POST/oauth/token
POST/partner/stk
GET/partner/status
POST/partner/b2c
POST/checkout/create
POST/partner/webhooks/endpoints

53 endpoints · OpenAPI 3 · JSON over HTTPS

Start here

Quickstart: your first payment

Get a token, push a payment prompt to a phone and receive the signed result on your server, all with sandbox keys.

Start the quickstart
Get started

Authentication

Test and live keys, one-hour Bearer tokens, rotation and keeping secrets safe.

4 min readRead
Get started

Testing in the sandbox

Build end to end with test keys: simulated payments, a hosted webhook receiver and live logs.

3 min readRead
Money in

Accept payments

Prompt-to-pay, dynamic QR, till and pay bill (C2B), invoices, standing orders and business-to-business requests.

7 min readRead
Money in

Hosted checkout and payment links

A ready-made payment page: create a session, redirect the customer, get the result.

3 min readRead
Money out

Send money (payouts)

Pay customers, businesses and tax authorities from your settlement account, with an optional second factor and async results.

6 min readRead
Run in production

Webhooks

Signed, retried event deliveries: endpoints, event types, verification in four languages, testing and replay.

6 min readRead
Run in production

Transactions and reversals

Look up any transaction, reconcile a period, and request governed reversals.

3 min readRead
Run in production

Errors

One error shape, clear HTTP statuses, and when it's safe to retry.

3 min readRead
Run in production

Go-live checklist

What to confirm before you switch to live keys.

3 min readRead

Tools

Everything you need beside the guides

API explorer

Try every endpoint in the browser with your sandbox keys and copy the generated code.

OpenAPI 3 spec

The machine-readable contract. Generate a typed client in any language.

Developer console

Keys, webhooks, logs, team members and your go-live request in one place.

Get sandbox keys

Create a free developer account and get test keys straight away.

Stuck on something?

Our engineers answer integration questions. Send us the request reference and we'll find the exact call.

Contact supportDeveloper overview