Engineering · 11 ìṣẹ́jú kíkà
Fún àwọn dẹ́fẹ́lọ́pà
API tó mọ́ fún ìkójọ àti ìsanwó.
Kọ́kọ́rọ́ OAuth2, sandbox, ìtọ́ka-láti-san bíi Daraja, àti wẹ́bùhúùkù tí a fọwọ́sí — so pọ̀ ní ọ̀sán kan.
Kọ́kọ́rọ́ sandbox ọ̀fẹ́ láàárín ìṣẹ́jú díẹ̀. Kọ́kọ́rọ́ live lẹ́yìn àyẹ̀wò kúkúrú.
# 1. Exchange your key pair for a 1-hour token curl -s https://pesa-bridge.com/api/bridgepay/v1/oauth/token \ -H "Content-Type: application/json" \ -d '{"client_id":"pk_test_…","client_secret":"sk_test_…"}' # 2. Push a payment prompt to the customer's phone curl -s https://pesa-bridge.com/api/bridgepay/v1/partner/stk \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"payer_msisdn":"254708374149","amount":250, "reference":"INV-1001","idem":"inv-1001-1"}'← 200 {"charge_ref":"STK0000123","state":"pending"}→ webhook charge.completed KES 250.00 ✓
Ìtọ́sọ́nà kíákíá
Láti òfo dé àṣẹ tí a ti sanwó rẹ̀ ní ìgbésẹ̀ mẹ́rin
Gbogbo nǹkan ń ṣiṣẹ́ nínú sandbox pẹ̀lú kọ́kọ́rọ́ ìdánwò, nítorí náà o lè kọ́ gbogbo ìlànà kí owó gidi tó yí padà.
- 1
Ṣí àkáǹtì
Forúkọsílẹ̀ nínú pánẹ́lì olùgbéṣẹ́. A ń fún ọ ní kọ́kọ́rọ́ ìdánwò àti live lẹ́sẹ̀kẹsẹ̀.
/developer/signup - 2
Gba token
Pààrọ̀ kọ́kọ́rọ́ méjèèjì rẹ fún token Bearer tí ó wà fún wákàtí kan.
POST /oauth/token - 3
Béèrè ìsanwó láti fóònù
Fi ìbéèrè ìsanwó ránṣẹ́. Oníbàárà fọwọ́ sí i lórí fóònù tirẹ̀ pẹ̀lú PIN rẹ̀.
POST /partner/stk - 4
Gba webhook
Ìṣẹ̀lẹ̀ charge.completed tí a fọwọ́ sí sọ fún sáfà rẹ pé a ti san owó àṣẹ náà.
charge.completed ✓
Ohun tí o lè kọ́
API kan fún owó tó ń wọlé, owó tó ń jáde àti gbogbo ohun tó yí wọn ká
Endpoints 53 nínú ẹgbẹ́ 12, pẹ̀lú ọ̀nà kan ṣoṣo láti jẹ́rìísí àti ọ̀nà kan ṣoṣo fún àṣìṣe.
A ṣe é fún owó
API tí ó ń hùwà bíi ẹ̀rọ ìsanwó.
Ọ̀pọ̀ API ń gbé dátà. Èyí ń gbé owó — nítorí náà kò ní ìlọ́po, a fọwọ́sí, a sì kọ́ ọ yíká ìwàláàyè ìdíyelé tí o lè gbẹ́kẹ̀lé.
Ìfọwọ́sí jẹ́ OAuth2 client-credentials: o pààrọ̀ kọ́kọ́rọ́ àti àṣírí fún tọ́kẹ̀nì bearer olùgbà-àkókò-kúkúrú. Gbogbo ìpè tó ń yí ipò padà ń gbé kọ́kọ́rọ́ ìlọ́po, kí ìtúndán nẹ́tíwọ́ọ̀kì lè dúró ẹ̀ẹ̀kan ṣoṣo — ìwà tó ṣe pàtàkì jù nígbà tí owó gidi bá kàn.
Ìkójọpọ̀ jẹ́ ìdíyelé. O tì í sí nọ́ńbà oníbàárà; ìtọ́ka-láti-san dé fóònù wọn; wọ́n fọwọ́sí pẹ̀lú PIN. Ìdíyelé náà ń kọjá láti dídúró → tí a fọwọ́sí → tí a parí (tàbí tí a kọ̀ / tí ó pé / tí ó kùnà), o sì rí àbájáde ní ọ̀nà méjì: yẹ endpoint ipò wò, tàbí — dáradára — gba wẹ́bùhúùkù nígbà tí ó bá yí.
A fi HMAC-SHA256 fọwọ́sí wẹ́bùhúùkù sí àṣírí tí ìwọ àti PesaBridge nìkan pín, a sì tún dán an pẹ̀lú ìdúró títí endpoint rẹ yóò fi jẹ́wọ́ — kí o lè kọ́ lórí wọn láìbẹ̀rù ìṣẹ̀lẹ̀ tí ó sọnù tàbí tí a hù. Endpoint iye owó àti ìdúnàdúrà ń parí ìlaàpọ̀, sandbox sì ń ṣiṣẹ́ pẹ̀lú àdéhùn kan náà, kí o fi ìgbọ́kànlé fi ránṣẹ́.
Ìwàláàyè ìdíyelé
pendingauthorisedcompleteddeclinedexpiredfailed
webhook · charge.completed
{
"event": "charge.completed",
"charge_ref": "STK9F2A",
"amount": 250.00,
"currency": "KES",
"state": "completed",
"signature": "hmac-sha256…"
}Irinṣẹ́
Ju API lọ: àwọn irinṣẹ́ tó yí i ká
Ṣàwárí, dán wò, kí o sì ṣàtúnṣe ìsopọ̀ rẹ láìkọ kóòdù ìjùsílẹ̀ tàbí gbé sáfà kalẹ̀.
Ìtọ́ka API
Ojú-ẹ̀rọ kékeré, tí a lè sọtẹ́lẹ̀.
POST
/oauth/tokenPààrọ̀ ìwé-ẹ̀rí client fún tọ́kẹ̀nì bearer.POST
/partner/stkTì ìdíyelé (ìtọ́ka-láti-san) sí oníbàárà.GET
/partner/statusYẹ ipò ìdíyelé wò.GET
/partner/balanceBéèrè iye àkáǹtì ìkójọ.POST
/biz/requestÌbéèrè-láti-san oníṣòwò.POST
/ussdÌpè-padà gateway àkójọ USSD.Ààbò àti ìbámu
Ìgbẹ́kẹ̀lé ni ọjà náà.
Iṣẹ́ ìnáwó ń yè tàbí kú lórí ìtọ́ àti ìdarí. PesaBridge ń fi méjèèjì sínú ẹ̀rọ náà.
Ìwọlé-ìlọ́po látàrí ìṣẹ̀dá
Gbogbo ìṣíkiri ń fi gbèsè àti ìtẹ̀wọ́gbà dídọ́gba sí — ìwé náà ń dọ́gba sí òdo, nígbà gbogbo.
PIN, KYC àti àlà
Ìpele KYC olùyí, àlà ìdúnàdúrà àti ojoojúmọ́, ìdánwò PIN àti títì àpò owó.
Aláìní-ìlọ́po tí a lè dápadà
Kọ́kọ́rọ́ ìdẹ́kùn-ìlọ́po ń dí ìdíyelé ìlọ́po; ẹ̀rọ ìpadàsí kan ń tú ẹ̀ka yòówù ká.
Wẹ́bùhúùkù tí a fọwọ́sí
Ìfọwọ́sí HMAC-SHA256 àti ìtúndán kí ẹ̀rọ alábàáṣepọ̀ lè gbẹ́kẹ̀ gbogbo ìpè-padà.
Ìtọpa àyẹ̀wò pípé
Ìwọlé ìwé-ìṣirò àti ìtàn ìdúnàdúrà tí kò lè yí padà fún alátùnṣe àti àríyànjiyàn.
Ìbámu fún orílẹ̀-èdè kọ̀ọ̀kan
Irú ìdánimọ̀, òfin KYC àti owó-orí ń yí padà pẹ̀lú ọjà, láti àtòjọ.
Bíbẹ̀rẹ̀ iṣẹ́ gidi
Láti sandbox dé iṣẹ́ gidi láìtún ìlà kan kọ
Kóòdù kan náà ń ṣiṣẹ́ ní ipò méjèèjì; kọ́kọ́rọ́ tí o lò ló ń pinnu. Nígbà tí ìsopọ̀ rẹ bá ṣetán, béèrè ààyè live kí o sì pààrọ̀ kọ́kọ́rọ́.
SandboxÀyẹ̀wòLive
- A ń jẹ́rìísí ìbuwọ́lù webhooks, pẹ̀lú fèrèsé àkókò
- Kọ́kọ́rọ́ idempotency lórí gbogbo ìsanwó àti ìsanwó jáde
- Kọ́kọ́rọ́ àṣírí wà lórí sáfà rẹ nìkan
- Endpoint webhook live tó ní àṣírí ìbuwọ́lù tirẹ̀
- Àtúnṣe ojoojúmọ́ pẹ̀lú API ìdúnàádúrà
190+
Orílẹ̀-èdè tí o lè bẹ̀rẹ̀ níbẹ̀
4
Áàpù abínibí, ẹ̀rọ kan
4
Ọ̀nà — Áàpù · USSD · Wẹ́ẹ̀bù · API
100%
Ìwọlé ìlọ́po, ó dọ́gba nígbà gbogbo
FAQ
Ìbéèrè, a dáhùn.
Ṣé PesaBridge jẹ́ ẹ̀rọ tí mo pín, tàbí tèmi?
Tìrẹ. PesaBridge jẹ́ ọjà tí BridgeERP ń tà — olùṣàkóso kọ̀ọ̀kan ń rí ìdásílẹ̀ tirẹ̀, tí a fi àmì àti àtòjọ ṣe fún wọn. Kò sí dátábésì tí a pín, kò sí súpà-ààbójútó tí a pín.
Orílẹ̀-èdè àti owó wo ni a ṣàtìlẹ́yìn fún?
Yòówù. Orílẹ̀-èdè, owó, èdè àti òfin KYC jẹ́ àtòjọ láti àkópọ̀ ISO pípé — kìí ṣe àkọsínú. A ní ọjà tó ń ṣiṣẹ́ lóde òní, a sì ń dá tuntun sílẹ̀ láìsí àtúnkọ́.
Ṣé ó ń ṣiṣẹ́ lórí fóònù rírọrùn?
Bẹ́ẹ̀ ni. Àpò owó pípé ń ṣiṣẹ́ lórí USSD — fi ránṣẹ́, yọ, san ọ̀ya, ra ọjà, airtime, iye àti ìwé-àkọsílẹ̀ — tí ó ń dúró lórí ìwé-ìṣirò kan náà pẹ̀lú áàpù.
Ṣé mo lè so báǹkì àti ọ̀nà ìsanwó tèmi pọ̀?
Bẹ́ẹ̀ ni. Àwọn ọ̀nà jẹ́ adápítà tí o lè fi kún — báǹkì, owó alágbèéká, káàdì àti PSP — kí o so ohun tí ọjà rẹ nílò nìkan.
Báwo ni a ṣe lè bẹ̀rẹ̀ kíákíá tó?
Ọ̀sẹ̀ díẹ̀, kìí ṣe ọdún. Ṣe àtòjọ àmì àti orílẹ̀-èdè rẹ, so àwọn ọ̀nà rẹ pọ̀, kí o sì fi áàpù, kóòdù USSD àti pọ́tà wẹ́ẹ̀bù rẹ ránṣẹ́ láti ẹ̀rọ kan.
Ṣé ó ní ààbò tí a sì lè ṣàyẹ̀wò?
Gbogbo ìṣíkiri jẹ́ ìwọlé-ìlọ́po tí ó dọ́gba sí òdo, tí PIN àti KYC dáàbò bò, pẹ̀lú wẹ́bùhúùkù tí a fọwọ́sí àti ìtọpa àyẹ̀wò pípé fún alátùnṣe.
Áàpù wo ni olùṣàkóso àti oníbàárà wọn ń rí?
Áàpù Android àbínibí mẹ́rin: áàpù Olùlò fún oníbàárà, áàpù Aṣojú / Aṣojú àgbà fún fífi owó sí, gbígba owó jáde àti float, áàpù Oníṣòwò láti gba ìsanwó àti yanjú, àti áàpù Ilé-iṣẹ́ fún ìsanwó púpọ̀ pẹ̀lú ìfọwọ́sí ẹni méjì, tí ó tún ń ṣiṣẹ́ gẹ́gẹ́ bí ẹnu-ọ̀nà wẹẹbù. Ẹ̀dà iOS wà nínú ètò.
Báwo ni ìsanwó àti ìlaàpọ̀ ṣe ń ṣiṣẹ́?
Owó ń san sí àpò owó tó yẹ ní àkókò gidi. Gbogbo ìdúnàdúrà ń dá ìwọlé ìwé-ìṣirò dídọ́gba tí o lè laàpọ̀, pẹ̀lú ìwé-àkọsílẹ̀ àti ìtẹ̀jáde, àti afárá GL fún ẹ̀rọ ìṣirò rẹ.
Ṣé ó lè ṣàkóso àwìn, ìfowópamọ́ àti owó ẹgbẹ́?
Bẹ́ẹ̀ ni — àwìn ọ̀fẹ̀dì, àwìn MFI pẹ̀lú àkókò àti PAR, ìfowópamọ́ àfojúsùn, àti ẹgbẹ́ ìfowópamọ́ (chama / merry-go-round) jẹ́ apá ẹ̀rọ náà, wọ́n sì ń tan fún ọjà kọ̀ọ̀kan.
Ṣé ẹ ṣàtìlẹ́yìn fún ìsanwó pọ̀ fún ọ̀ya, ìrànwọ́ tàbí ìsanwó?
Bẹ́ẹ̀ni. Ẹnu-ọ̀nà Ilé-iṣẹ́ àti API ń san owó lọ́pọ̀ sí ẹgbẹẹgbẹ̀rún àpò-owó pẹ̀lú ìfọwọ́sí maker/checker, ìwé olùgbà, ìṣètò àkókò àti ìbáramu kíkún.
Kí ni ó gbà láti ṣàkóso rẹ̀ lójoojúmọ́?
Ìdarí ààbójútó olùṣàkóso kan ń ṣàkóso àmì, owó-orí, KYC, nẹ́tíwọ́ọ̀kì aṣojú àti oníṣòwò, ìwé-ìṣirò, ìpadàsí, àtìlẹ́yìn àti KPI — kò sí kóòdù tí a nílò fún iṣẹ́ ojoojúmọ́.
Ta ni ó ní ìdásílẹ̀ àti dátà náà?
Ìwọ ni. Olùṣàkóso kọ̀ọ̀kan ń ṣàkóso ìdásílẹ̀ tirẹ̀ pẹ̀lú dátábésì tirẹ̀ — tí a fi àmì àti àtòjọ ṣe fún wọn. Ọjà tí o ń tà bíi tìrẹ ni, kìí ṣe àpọ́nlé SaaS tí a pín.
Ìwé kíkà síwájú sí i
Àwọn ìtọ́sọ́nà láti ọ̀dọ̀ ẹgbẹ́ PesaBridge
Àwọn àpilẹ̀kọ wà ní èdè Gẹ̀ẹ́sì.
Tẹ̀síwájú láti ṣàwárí
Ibo ni kí o lọ báyìí
Ṣé o ti ṣetán láti bẹ̀rẹ̀ àpò owó rẹ?
Ṣe àyẹ̀wò a óò dá àmì, orílẹ̀-èdè àti ọ̀nà rẹ sílẹ̀ — a óò sì mú ọ kọjá áàpù, ààbójútó àti API.
Ṣé o fẹ́ kí a sọ̀rọ̀? Pè +254 746 883809