Injiniyanci · 11 minti karatu
Ga masu haɓakawa
API mai tsafta don tarawa da biya.
Maɓallan OAuth2, filin gwaji, nemo-don-biya a wayar abokin ciniki, 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 ok
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.
Inda yake bayyana
Haɗi ɗaya, a kowane allo da abokan cinikinku ke amfani da shi.
API ɗaya ce ke tafiyar da wayar abokin ciniki, shafin biyan kuɗi, na'urar biyan kuɗi a kanta da kuma dashboard na kasuwanci.
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
6
Manhajoji na asali, dandali guda
4
Hanyoyi — Manhaja · USSD · Yanar gizo · API
100%
Shigar-biyu, daidaitacce koyaushe
Ka makale a wani wuri?
Injiniyoyinmu suna amsa tambayoyin haɗawa. Aiko mana da lambar bayanin buƙatar, za mu nemo ainihin kiran.
Tambayoyi
Tambayoyi, an amsa.
Sayen PesaBridge
Za mu iya farawa da wani ɓangare na dandalin?
Ee. Tsarin Starter ya ƙunshi manhajojin abokin ciniki da na wakili tare da tsarin gudanarwa da KYC. 'Yan kasuwa, API na masu haɓakawa, USSD, lamuni, ajiya da biyan kuɗi da yawa ana kunna su daga baya a kan littafin lissafi ɗaya, don haka babu abin da za a sake ginawa yayin da kuke girma.
Yaya ake ƙayyade farashin PesaBridge?
Ta hanyoyi huɗu: tsare-tsaren Starter, Growth da Enterprise, ko Haɗin gwiwa inda ba ka biyan kuɗin lasisi, maimakon haka muna raba ribar da ta rage. Mai shirya tayin da ke wannan shafin yana ba ka ainihin farashinka da daftarin kwangila cikin kusan minti 10.
Me kuke buƙata daga gare mu don ƙaddamarwa?
Lasisi, ko abokin hulɗa mai lasisi da ke riƙe kuɗin abokan ciniki; asusu a bankuna da masu ba da sabis na biyan kuɗi da kuke so ku haɗa; alamar kasuwancinku; da farashin ayyukanku. Da zarar bayanan shiga na masu ba da sabis sun iso, ƙasa ta farko yawanci tana fara aiki cikin makonni 4 zuwa 12.
Za mu iya gwada shi kafin mu sa hannu?
Ee. Nemi damar gwaji kuma za ka karɓi manhajojin Android na samfuran da ka zaɓa, shafukan yanar gizo da bayanan shiga na gwaji ta imel. Komai yana gudana a muhallin gwaji, don haka babu kuɗi na gaske da ke motsawa. Masu haɓakawa na iya buɗe asusun gwaji a shafin masu haɓakawa a kowane lokaci.
Wane tallafi da horo kuke bayarwa?
Kowane tsari ya ƙunshi tallafi: ta imel a Starter, tallafi na fifiko a Growth, da yarjejeniyar matakin sabis tare da jagoranci a Enterprise. A lokacin ƙaddamarwa muna horar da ƙungiyoyinku na gudanarwa, tallafi da hanyar sadarwar wakilai, kuma cibiyar taimako, jagorori da takardun API suna nan a kan layi ga kowa.
Dandalin
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. Ta USSD, abokan ciniki suna aikawa, cirewa, biyan kuɗi, sayen kaya da katin waya, duba ma'aunin su da samun ƙaramin bayani, 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 da iOS shida na asali: manhajar Mai amfani don abokan ciniki, manhajar Send don aika kuɗi zuwa ƙasashen waje, manhajar Wakili / Babban wakili don saka kuɗi, cire kuɗi da float, manhajar Ɗan kasuwa don karɓar biya da daidaitawa, manhajar kanti don shaguna da manhajar Kamfani don biyan kuɗi da yawa tare da amincewar mutane biyu, wadda kuma ke aiki a matsayin tashar yanar gizo.
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.
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