PesaBridge
Ìwé fún àwọn olùgbéṣẹ́

Kọ́ pẹ̀lú API PesaBridge.

Àwọn ìtọ́sọ́nà fún gbígba owó, sísan owó jáde, ojú-ìwé ìsanwó tí a ti pèsè àti webhooks, pẹ̀lú àwọn àpẹẹrẹ tí o lè lẹ̀ tààrà sínú terminal rẹ. Gbogbo nǹkan ni a kọ́kọ́ ń dán wò nínú sandbox.

URL ìpìlẹ̀

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

Endpoints 53 · OpenAPI 3 · JSON lórí HTTPS

Ì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.

Ọ̀nà àti ìsopọ̀

So ohun tí ọjà rẹ nílò nìkan pọ̀.

Àwọn ọ̀nà jẹ́ adápítà tí o lè fi kún pẹ̀lú ìsopọ̀ kan — gbà, san, iye àti ìpè-padà — kí olùsopọ̀ tuntun má ṣe fọwọ́kan ẹ̀rọ náà.

Àwọn báǹkì

Ìsanwó RTGS / ACH / SWIFT / SEPA àti ìṣàkóso nostro.

Owó alágbèéká

Àwọn olùṣàkóso owó alágbèéká ní gbogbo ọjà, nípasẹ̀ adápítà ọ̀nà.

Káàdì àti PSP

Ìgbà káàdì àwọn nẹ́tíwọ̀ọ̀kì káàdì ńlá àti ìsopọ̀ olùṣàkóso.

Olùsanwó àti tẹ́líkò

Iṣẹ́-ìlú, TV, ìjọba, owó ilé-ẹ̀kọ́ àti ìkúnwọ́ airtime.

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…"
}

Àà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ọ.

Ṣé 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ẹ́.