Ìmọ̀-ẹ̀rọ · 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 lórí fóònù oníbàárà, à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 ok
Ì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.
Ibi tí ó ti ń hàn
Ìsopọ̀ kan ṣoṣo, lórí gbogbo ojú-ìbòjú tí àwọn oníbàárà rẹ ń lò.
API kan náà ló ń darí fóònù oníbàárà, ojú-ìwé ìsanwó, ẹ̀rọ ìsanwó ní kántà àti pátákó iṣẹ́ ilé-iṣẹ́.
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ẹ̀
6
Áàpù abínibí, ẹ̀rọ kan
4
Ọ̀nà — Áàpù · USSD · Wẹ́ẹ̀bù · API
100%
Ìwọlé ìlọ́po, ó dọ́gba nígbà gbogbo
Ṣé nǹkan kan dí ọ lọ́wọ́?
Àwọn onímọ̀-ẹ̀rọ wa ń dáhùn ìbéèrè nípa ìsopọ̀. Fi nọ́mbà ìtọ́kasí ìbéèrè náà ránṣẹ́ sí wa, a ó sì rí ìpè náà gẹ́lẹ́.
FAQ
Ìbéèrè, a dáhùn.
Ríra PesaBridge
Ṣé a lè bẹ̀rẹ̀ pẹ̀lú apá kan pẹpẹ náà?
Bẹ́ẹ̀ ni. Ètò Starter ní áàpù oníbàárà àti áàpù aṣojú pẹ̀lú ẹ̀ka ìṣàkóso àti KYC. Àwọn oníṣòwò, API fún olùgbéejáde, USSD, awin, ìfipamọ́ àti ìsanwó ọ̀pọ̀ ni a lè tàn lẹ́yìn náà lórí ìwé àkọsílẹ̀ kan náà, nítorí náà kò sí ohun tí a ó tún kọ́ bí ẹ ṣe ń dàgbà.
Báwo ni a ṣe ń ṣírò iye owó PesaBridge?
Ní ọ̀nà mẹ́rin: àwọn ètò Starter, Growth àti Enterprise, tàbí Àjọṣepọ̀ níbi tí ẹ kò ti san owó ìwé àṣẹ, tí a sì ń pín èrè àpapọ̀ dípò rẹ̀. Olùṣe àbá lórí ojúlé yìí ń fún yín ní iye owó gangan àti àkọsílẹ̀ àdéhùn ní nǹkan bí ìṣẹ́jú 10.
Kí ni ẹ nílò láti ọ̀dọ̀ wa láti ṣe ìfilọ́lẹ̀?
Ìwé àṣẹ, tàbí alábàáṣiṣẹ́pọ̀ tí ó ní ìwé àṣẹ tí ó ń tọ́jú owó àwọn oníbàárà; àwọn àkáǹtì ní ọ̀dọ̀ àwọn báńkì àti olùpèsè ìsanwó tí ẹ fẹ́ so pọ̀; àmì-ìdámọ̀ yín; àti àwọn owó iṣẹ́ yín. Nígbà tí àwọn ìwọlé olùpèsè bá dé, orílẹ̀-èdè àkọ́kọ́ sábà máa ń bẹ̀rẹ̀ iṣẹ́ láàárín ọ̀sẹ̀ 4 sí 12.
Ṣé a lè dán an wò kí a tó fọwọ́ sí i?
Bẹ́ẹ̀ ni. Béèrè àyè ìdánwò, ẹ ó sì gba àwọn áàpù Android fún àwọn ọjà tí ẹ yàn, àwọn ẹnu-ọ̀nà wẹ́ẹ̀bù àti àwọn ìwọlé ìdánwò lórí ímeèlì. Gbogbo rẹ̀ ń ṣiṣẹ́ nínú àyíká ìdánwò, nítorí náà kò sí owó gidi tí ó ń gbé. Àwọn olùgbéejáde lè ṣí àkáǹtì ìdánwò lórí ẹnu-ọ̀nà olùgbéejáde nígbàkígbà.
Irú ìrànlọ́wọ́ àti ìdálẹ́kọ̀ọ́ wo ni ẹ ń pèsè?
Gbogbo ètò ní ìrànlọ́wọ́: lórí ímeèlì nínú Starter, ìrànlọ́wọ́ àkọ́kọ́ nínú Growth, àti àdéhùn ìpele iṣẹ́ pẹ̀lú ìtọ́sọ́nà ìbẹ̀rẹ̀ nínú Enterprise. Nígbà ìfilọ́lẹ̀ a ń kọ́ àwọn ẹgbẹ́ ìṣàkóso, ìrànlọ́wọ́ àti nẹ́tíwọ́ọ̀kì aṣojú yín, àwọn ibùdó ìrànlọ́wọ́, ìtọ́sọ́nà àti ìwé API sì wà lórí ayélujára fún gbogbo ènìyàn.
Pẹpẹ 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. Lórí USSD, àwọn oníbàárà ń fi ránṣẹ́, ń yọ, ń san ọ̀ya, ń ra ọjà àti airtime, ń yẹ iye wọn wò, wọ́n sì ń gba ìwé-àkọsílẹ̀ kékeré, 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 àti iOS àbínibí mẹ́fà: áàpù Olùlò fún oníbàárà, áàpù Send fún fífi owó ránṣẹ́ sí òkè-òkun, áà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ú, áàpù Kàǹtá fún àwọn ṣọ́ọ̀bù à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ù.
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
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