Engineering · 11 minti karatu
Ga masu haɓakawa
API mai tsafta don tarawa da biya.
Maɓallan OAuth2, filin gwaji, nemo-don-biya irin ta Daraja, da webhook masu sa hannu — haɗawa cikin yamma guda.
Maɓallan filin gwaji kyauta cikin mintuna. Maɓallan aiki na gaske bayan ɗan bita.
# 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 ✓
Jagorar gaggawa
Daga sifili zuwa odar da aka biya cikin matakai huɗu
Komai yana gudana a filin gwaji da maɓallan gwaji, don haka ka gina dukan tsarin kafin kuɗi na gaske ya motsa.
- 1
Buɗe asusu
Yi rajista a dashbod na mai haɓakawa. Ana ba da maɓallan gwaji da na aiki nan take.
/developer/signup - 2
Sami token
Musanya maɓallanka biyu da token na Bearer da ke aiki na awa ɗaya.
POST /oauth/token - 3
Nemi biya daga waya
Aika buƙatar biya. Abokin ciniki yana amincewa a wayarsa da PIN ɗinsa.
POST /partner/stk - 4
Karɓi webhook
Taron charge.completed da aka sa hannu yana sanar da sabar ka cewa an biya odar.
charge.completed ✓
Abin da za ka iya ginawa
API ɗaya don kuɗi mai shigowa, kuɗi mai fita da duk abin da ke kewaye
Endpoints 53 a ƙungiyoyi 12, da hanya ɗaya ta tabbatarwa da tsarin kuskure ɗaya.
An tsara don kuɗi
API da ke aiki kamar tsarin biyan kuɗi.
Yawancin API suna motsa bayanai. Wannan yana motsa kuɗi — don haka ba a maimaita shi, mai sa hannu ne, kuma an gina shi kewaye da rayuwar caji da za ka iya dogaro da shi.
Tabbatarwa ita ce OAuth2 client-credentials: kana musaya maɓalli da sirri don ɗan gajeren bearer token. Kowace kira mai canza yanayi tana ɗauke da maɓallin idempotency, don haka sake gwadawar hanyar sadarwa yana sasantawa daidai sau ɗaya — mafi muhimmancin dukiya idan kuɗi na gaske na ciki.
Tarawa caji ce. Kana turo ta zuwa lambar abokin ciniki; nemo-don-biya ya sauka a wayarsa; ya tabbatar da PIN. Cajin yana motsi ta pending → authorised → completed (ko declined / expired / failed), kuma kana koyon sakamakon ta hanyoyi biyu: duba matsayin endpoint, ko — mafi kyau — karɓi webhook lokacin da ya canza.
Ana sa hannu kan webhook da HMAC-SHA256 a kan sirrin da kai da PesaBridge kaɗai kuke rabawa, kuma ana sake gwadawa da backoff har sai endpoint ɗinka ya amince — don ka gina a kansu ba tare da tsoron rasa ko ƙirƙira wani abu ba. Ma'auni da endpoint na mu'amala suna rufe zagayen don daidaitawa, kuma filin gwaji yana gudanar da kwangila iri ɗaya, don ka fitar da amincewa.
Rayuwar caji
pendingauthorisedcompleteddeclinedexpiredfailed
webhook · charge.completed
{
"event": "charge.completed",
"charge_ref": "STK9F2A",
"amount": 250.00,
"currency": "KES",
"state": "completed",
"signature": "hmac-sha256…"
}Kayan aiki
Fiye da API: kayan aikin da ke kewaye da shi
Bincika, gwada kuma gyara haɗinka ba tare da rubuta lambar yar da ko kafa sabar ba.
Nassin API
Fanni ƙarami, mai iya faɗi.
POST
/oauth/tokenMusaya bayanan abokin ciniki don bearer token.POST
/partner/stkTuro caji (nemo-don-biya) zuwa abokin ciniki.GET
/partner/statusDuba yanayin caji.GET
/partner/balanceBincika ma'auni na asusun tarawa.POST
/biz/requestNeman-biya na ɗan kasuwa.POST
/ussdCallback na ƙofar menu na USSD.Tsaro & bin doka
Amana ita ce samfurin.
Sabis na kuɗi na rayuwa ko mutuwa a kan daidaito da iko. PesaBridge yana toya duka a cikin tushe.
Shigar-biyu ta gini
Kowane motsi yana sanya debit da credit daidaitattu — littattafan suna daidaita zuwa sifili, koyaushe.
PIN, KYC & iyaka
Matakan KYC masu saitawa, iyakar kowace mu'amala da yau da kullun, ƙoƙarin PIN da kulle walat.
Ba a maimaita & ana mayarwa
Maɓallan idempotency suna hana caji sau biyu; injin mayarwa guda yana warware kowace sashe.
Webhook masu sa hannu
Sa hannun HMAC-SHA256 da sake gwadawa don tsarin abokan haɗin gwiwa su amince da kowane callback.
Cikakken rikodin bincike
Shigarwar ledger da ba a canzawa da tarihin mu'amala ga masu kula da takaddama.
Bin doka kowace ƙasa
Nau'ikan ID, ƙa'idojin KYC da farashi suna canzawa da kasuwa, daga saiti.
Fara aiki na gaske
Daga filin gwaji zuwa aiki na gaske ba tare da sake rubuta layi ɗaya ba
Lamba ɗaya tana aiki a yanayi biyu; maɓallin da ka yi amfani da shi ne ke yanke hukunci. Idan haɗinka ya shirya, nemi damar aiki na gaske ka sauya maɓallai.
Filin gwajiBitaAiki na gaske
- Ana tabbatar da sa hannun webhooks, tare da taga lokaci
- Maɓallin idempotency a kowane biya da biyan kuɗi
- Maɓallan sirri a sabar ka kaɗai
- Endpoint na webhook na aiki na gaske mai sirrin sa hannu na kansa
- Daidaitawa ta kullum da API na ma'amaloli
190+
Ƙasashen da za ka iya ƙaddamarwa
4
Manhajoji na asali, dandali guda
4
Hanyoyi — Manhaja · USSD · Yanar gizo · API
100%
Shigar-biyu, daidaitacce koyaushe
Tambayoyi
Tambayoyi, an amsa.
PesaBridge dandali ne da nake rabawa, ko nawa ne?
Naka ne. PesaBridge samfuri ne da BridgeERP ke sake sayarwa — kowane mai aiki yana samun nasa aiki, an yi masa alama da saiti. Babu bayanai guda, babu babban admin guda.
Waɗanne ƙasashe da kuɗi ake tallafawa?
Kowanne. Ƙasa, kuɗi, harshe da ƙa'idojin KYC saiti ne da aka zana daga cikakken saitin ISO — ba a hardcode ba. Muna da kasuwanni masu rai yau kuma muna kafa sababbi ba tare da sake rubutawa ba.
Yana aiki a kan wayoyin fasali?
Ee. Cikakken walat yana gudana ta USSD — aikawa, cirewa, biyan kuɗi, sayen kaya, katin waya, ma'auni da bayanai — yana sasantawa a kan ledger iri ɗaya da manhajoji.
Zan iya haɗa nawa bankuna da hanyoyin biyan kuɗi?
Ee. Hanyoyi adaftoci ne masu haɗawa — bankuna, kuɗin wayar hannu, katuna da PSP — don ka haɗa abin da kasuwarka ke buƙata kaɗai.
Da sauri nawa za mu iya zama kai tsaye?
Makonni, ba shekaru ba. Saita alamarka da ƙasarka, haɗa hanyoyinka, sannan ka fitar da manhajojinka, lambar USSD da tashoshin yanar gizo daga dandali guda.
Yana da tsaro kuma ana iya duba shi?
Kowane motsi shigar-biyu ne kuma an daidaita zuwa sifili, mai kariyar PIN da KYC, da webhook masu sa hannu da cikakken rikodin bincike ga masu kula.
Waɗanne manhajoji masu aiki da abokan cinikinsu ke samu?
Manhajojin Android huɗu na asali: manhajar Mai amfani don abokan ciniki, manhajar Wakili / Babban wakili don saka kuɗi, cire kuɗi da float, manhajar Ɗan kasuwa don karɓar biya da daidaitawa, da manhajar Kamfani don biyan kuɗi da yawa tare da amincewar mutane biyu, wadda kuma ke aiki a matsayin tashar yanar gizo. Nau'ikan iOS suna cikin shiri.
Yaya sasantawa da daidaitawa ke aiki?
Kuɗi yana sasantawa zuwa walat mai dacewa nan take. Kowace mu'amala tana samar da shigarwar ledger daidaitattu da za ka iya daidaitawa, tare da bayanai da fitarwa, da gadar GL don tsarin lissafinka.
Zai iya sarrafa rance, ajiya da kuɗin ƙungiya?
Ee — bashin overdraft, rancen MFI da jadawali da hadarin fayil, ajiyar manufa, da ƙungiyoyin ajiya (chama / merry-go-round) sassa ne na dandalin kuma suna kunna kowace kasuwa.
Kuna tallafa wa rarraba kuɗi mai yawa don albashi, tallafi ko tallafin biya?
Eh. Tashar Kamfanoni da API suna biyan kuɗi da yawa zuwa dubban walat tare da amincewar maker/checker, jerin masu karɓa, tsara lokaci da cikakken sulhu.
Me ake buƙata don gudanar da shi kullum?
Console na gudanarwar mai aiki guda yana gudanar da alama, farashi, KYC, cibiyar wakilai da 'yan kasuwa, ledger, mayarwa, tallafi da KPI — babu lamba da ake buƙata don ayyukan yau da kullun.
Wa ke da aikin da bayanan?
Kai. Kowane mai aiki yana gudanar da nasa aiki da nasa bayanai — an yi masa alama da saiti. Samfuri ne da kake sake sayarwa a matsayin naka, ba mai haya SaaS guda ba.
Ƙarin karatu
Jagorori daga ƙungiyar PesaBridge
Labaran suna cikin Turanci.
Ci gaba da bincike
Ina za a je a gaba
A shirye don ƙaddamar da walat ɗinka?
Nemo nuni mu kafa maka alama, ƙasa da hanyoyi — mu bi ka ta manhajoji, gudanarwa da API.
Ka fi son magana? Kira +254 746 883809