Imibhalo yabathuthukisi

Yakha nge-API ye-PesaBridge.

Imihlahlandlela yokuqoqa imali, ukukhokha, ikhasi lokukhokha elilungisiwe nama-webhook, nezibonelo ongazinamathisela ngqo ku-terminal yakho. Konke kuhlolwa ku-sandbox kuqala.

I-URL eyisisekelo

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

Ama-endpoint angu-53 · OpenAPI 3 · JSON nge-HTTPS

Qala lapha

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.

Qala umhlahlandlela osheshayo

Ukuqala

Authentication

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

Imizuzu engu-4 yokufundaFunda

Ukuqala

Testing in the sandbox

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

Imizuzu engu-3 yokufundaFunda

Imali engenayo

Accept payments

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

Imizuzu engu-7 yokufundaFunda

Imali engenayo

Hosted checkout and payment links

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

Imizuzu engu-3 yokufundaFunda

Imali ephumayo

Send money (payouts)

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

Imizuzu engu-6 yokufundaFunda

Ukusebenza ngokoqobo

Webhooks

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

Imizuzu engu-6 yokufundaFunda

Ukusebenza ngokoqobo

Transactions and reversals

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

Imizuzu engu-3 yokufundaFunda

Ukusebenza ngokoqobo

Errors

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

Imizuzu engu-3 yokufundaFunda

Ukusebenza ngokoqobo

Go-live checklist

What to confirm before you switch to live keys.

Imizuzu engu-3 yokufundaFunda

Amathuluzi

Konke okudingayo eceleni kwemihlahlandlela

Isihloli se-API

Zama yonke i-endpoint kusiphequluli ngokhiye bakho be-sandbox bese ukopisha ikhodi ekhiqiziwe.

Incazelo ye-OpenAPI 3

Isivumelwano esifundeka ngomshini. Khiqiza i-client nganoma yiluphi ulimi.

Ikhonsoli yomthuthukisi

Okhiye, ama-webhook, amarekhodi, ithimba nesicelo sokuqala ukusebenza, konke endaweni eyodwa.

Thola okhiye be-sandbox

Vula i-akhawunti yomthuthukisi mahhala bese uthola okhiye bokuhlola ngokushesha.

Isikhombo se-API

Isici esincane, esilindelekile.

POST/oauth/tokenShintshanisa iziqinisekiso zeklayenti ngethokheni.

POST/partner/stkSunduza inkokhiso (isicelo-sokukhokha) kwikhasimende.

GET/partner/statusHlola isimo senkokhiso.

GET/partner/balanceBuza ibhalansi ye-akhawunti yokuqoqa.

POST/biz/requestIsicelo-sokukhokha somthengisi.

POST/ussdUmbiko obuyayo we-gateway yemenyu ye-USSD.

Ama-rail nokuhlanganiswa

Xhuma kuphela lokho imakethe yakho ekudingayo.

Ama-rail angama-adapter angena kalula anesixhumi esisodwa — qoqa, khokha, ibhalansi nokubuyayo — ukuze umxhumanisi omusha ungathinti umgogodla.

Amabhange

Ukubhadala kwe-RTGS / ACH / SWIFT / SEPA nokuphathwa kwe-nostro.

Imali yeselula

Abahlinzeki bemali yeselula kuzo zonke izimakethe, ngama-adapter e-rail.

Amakhadi nama-PSP

Ukwamukela amakhadi amanethiwekhi amakhulu amakhadi nokuhlanganiswa nabacubunguli.

Abakhokhisi ne-telco

Izinsiza zomphakathi, i-TV, uhulumeni, izimali zesikole nokufaka i-airtime.

Yakhelwe imali

I-API ephatha njengesistimu yezinkokhelo.

Ama-API amaningi ahambisa idatha. Le ihambisa imali — ngakho ayiphindwa, isayiniwe, futhi yakhelwe umjikelezo wempilo wenkokhiso ongawethemba.

Ukuqinisekisa yi-OAuth2 client-credentials: ushintshanisa ukhiye nemfihlo ngethokheni yesikhashana. Wonke ubizo olushintsha isimo luphethe ukhiye we-idempotency, ukuze ukuphinda kwenethiwekhi kubhadale kanye kuphela — impahla ebaluleke kunazo zonke lapho imali yangempela ibandakanyeka.

Ukuqoqa yinkokhiso. Uyayisunduzela enombolweni yekhasimende; isicelo-sokukhokha sifika efonini yalo; baqinisekisa nge-PIN. Inkokhiso idlula kwilindiwe → egunyaziwe → eqediwe (noma enqatshelwe / ephelelwe yisikhathi / ehlulekile), kanti ufunda umphumela ngezindlela ezimbili: hlola i-endpoint yesimo, noma — kangcono — thola i-webhook ngomzuzu eshintsha.

Ama-webhook asayinwe nge-HMAC-SHA256 ngokumelene nemfihlo ephethwe nguwe ne-PesaBridge kuphela, futhi aphindwa nge-backoff kuze kube i-endpoint yakho iyaqinisekisa — ukuze wakhe kuwo ngaphandle kokwesaba umcimbi ophuthile noma okhohlisiwe. I-endpoint yebhalansi neyokwenziwe ivala umjikelezo wokuhlanganisa, kanti i-sandbox iqhuba inkontileka efanayo, ukuze uthumele ngethemba.

Umjikelezo wempilo wenkokhiso

pendingauthorisedcompleteddeclinedexpiredfailed

webhook · charge.completed

{
  "event": "charge.completed",
  "charge_ref": "STK9F2A",
  "amount": 250.00,
  "currency": "KES",
  "state": "completed",
  "signature": "hmac-sha256…"
}

Ukuphepha nokulandela imithetho

Ukwethenjwa kungumkhiqizo.

Izinsiza zezimali ziphila noma zife ngokulunga nokulawula. I-PesaBridge ifaka kokubili emgogodleni.

Umbhalo-kabili ngokwakheka

Konke ukuhamba kufaka amadebithi namakhredithi abhalansayo — amabhuku ahlanganela ku-zero, njalo.

I-PIN, i-KYC nemikhawulo

Amazinga e-KYC alungiswayo, imikhawulo yomsebenzi ngamunye neyansuku zonke, imizamo ye-PIN nokukhiya isikhwama.

Ayiphindwa futhi ibuyiseleka

Okhiye be-idempotency bavimba ukukhokhiswa kabili; injini eyodwa yokubuyisela ihlehlisa noma yisiphi isigaba.

Ama-webhook asayiniwe

Izisayino ze-HMAC-SHA256 nokuphinda ukuze izistimu zozakwethu zithembe wonke umbiko obuyayo.

Umkhondo ophelele wokuhlola

Okufakiwe kwe-ledger okungaguqulwa nomlando wokwenziwa kwabalawuli nezimpikiswano.

Ukulandela imithetho ngezwe ngalinye

Izinhlobo ze-ID, imithetho ye-KYC namanani kushintsha nemakethe, kusuka ekulungiseni.

Kukhona okukubambile?

Onjiniyela bethu baphendula imibuzo yokuxhuma. Sithumelele inombolo yereferensi yesicelo, sizothola ucingo oluqondile.

Xhumana nosizo Uhlolojikelele lwabathuthukisi