Engineering · 11 dakika za kusoma
Kwa wasanidi
API safi kwa ukusanyaji na malipo.
Funguo za OAuth2, sandbox, ombi-la-kulipa la mtindo wa Daraja, na webhook zilizosainiwa — unganisha katika mchana mmoja.
Funguo za sandbox bure ndani ya dakika chache. Funguo za live baada ya ukaguzi mfupi.
# 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 ✓
Mwongozo wa haraka
Kutoka sifuri hadi oda iliyolipwa kwa hatua nne
Kila kitu kinaendeshwa kwenye sandbox kwa funguo za majaribio, kwa hivyo unajenga mtiririko wote kabla pesa halisi hazijahama.
- 1
Fungua akaunti
Jisajili kwenye dashibodi ya msanidi. Funguo za majaribio na za live hutolewa papo hapo.
/developer/signup - 2
Pata tokeni
Badilisha jozi yako ya funguo kuwa tokeni ya Bearer inayodumu saa moja.
POST /oauth/token - 3
Tuma ombi la malipo
Tuma ombi la malipo kwa simu ya mteja. Mteja anaidhinisha kwenye simu yake kwa PIN yake.
POST /partner/stk - 4
Pokea webhook
Tukio la charge.completed lililosainiwa linaambia seva yako kuwa oda imelipwa.
charge.completed ✓
Unachoweza kujenga
API moja kwa pesa kuingia, pesa kutoka na kila kinachozunguka
Endpoints 53 katika makundi 12, kwa njia moja ya uthibitishaji na muundo mmoja wa makosa.
Imeundwa kwa pesa
API inayotenda kama mfumo wa malipo.
API nyingi huhamisha data. Hii huhamisha pesa — hivyo haina mgongano, imesainiwa, na imejengwa kuzunguka mzunguko wa malipo unaoweza kuamini.
Uthibitishaji ni OAuth2 client-credentials: unabadilishana ufunguo na siri kupata tokeni ya muda mfupi. Kila mwito unaobadili hali hubeba ufunguo wa kutokugongana, hivyo jaribio la kurudia la mtandao hukaa mara moja tu — sifa muhimu zaidi wakati pesa halisi inahusika.
Ukusanyaji ni malipo. Unayasukuma kwa nambari ya mteja; ombi-la-kulipa hutua kwenye simu yao; wanathibitisha kwa PIN. Malipo hupitia kusubiri → kuidhinishwa → kukamilika (au kukataliwa / kuisha muda / kushindwa), na unajua matokeo kwa njia mbili: chunguza sehemu ya hali, au — bora zaidi — pokea webhook mara inapobadilika.
Webhook husainiwa kwa HMAC-SHA256 dhidi ya siri unayoshiriki na PesaBridge tu, na hurudiwa kwa kuchelewesha hadi sehemu yako ithibitishe — hivyo unaweza kujenga juu yake bila hofu ya tukio lililokosekana au bandia. Sehemu za salio na miamala hufunga mzunguko wa upatanishi, na sandbox huendesha mkataba ulesawa, hivyo unapeleka kwa uhakika.
Mzunguko wa malipo
pendingauthorisedcompleteddeclinedexpiredfailed
webhook · charge.completed
{
"event": "charge.completed",
"charge_ref": "STK9F2A",
"amount": 250.00,
"currency": "KES",
"state": "completed",
"signature": "hmac-sha256…"
}Zana
Zaidi ya API: zana zinazoizunguka
Chunguza, jaribu na tatua muunganisho wako bila kuandika msimbo wa kutupa au kuweka seva.
Marejeleo ya API
Uso mdogo, unaotabirika.
POST
/oauth/tokenBadilisha client credentials kwa tokeni ya mbeba.POST
/partner/stkSukuma malipo (ombi-la-kulipa) kwa mteja.GET
/partner/statusChunguza hali ya malipo.GET
/partner/balanceUliza salio la akaunti ya ukusanyaji.POST
/biz/requestOmbi-la-kulipa la mfanyabiashara.POST
/ussdMwito wa kurudi wa lango la menyu ya USSD.Usalama na utii
Uaminifu ndiyo bidhaa.
Huduma za kifedha huishi au hufa kwa usahihi na udhibiti. PesaBridge huweka vyote katika msingi.
Uandikishaji-mara-mbili kwa muundo
Kila mwendo huandika madeni na mikopo iliyosawazishwa — vitabu hupatana hadi sifuri, daima.
PIN, KYC na mipaka
Viwango vya KYC vinavyoweza kusanidiwa, mipaka ya kila-muamala na kila siku, majaribio ya PIN na kufunga pochi.
Isiyogongana na inayotenduka
Funguo za kutokugongana huzuia malipo ya mara mbili; injini moja ya kutendua hutendua idara yoyote.
Webhook zilizosainiwa
Sahihi za HMAC-SHA256 na majaribio ili mifumo ya washirika iamini kila mwito wa kurudi.
Rekodi kamili ya ukaguzi
Uandikishaji wa leja usiobadilika na historia ya miamala kwa wadhibiti na migogoro.
Utii kwa kila nchi
Aina za kitambulisho, kanuni za KYC na ushuru hubadilika na soko, kutoka usanidi.
Kwenda hewani
Kutoka sandbox hadi uzalishaji bila kuandika upya mstari mmoja
Msimbo uleule unafanya kazi katika hali zote mbili. Funguo unayotumia ndiyo inayoamua. Muunganisho wako ukiwa tayari, omba ufikiaji wa live na ubadilishe funguo.
SandboxUkaguziLive
- Sahihi za webhooks zinathibitishwa, pamoja na dirisha la muda
- Ufunguo wa idempotency kwenye kila malipo na kila malipo ya kutuma
- Funguo za siri zinakaa kwenye seva yako tu
- Endpoint ya webhook ya live yenye siri yake ya kusaini
- Upatanisho wa kila siku dhidi ya API ya miamala
190+
Nchi unazoweza kuzindua ndani yake
4
Programu asili, jukwaa moja
4
Njia — Programu · USSD · Wavuti · API
100%
Uandikishaji-mara-mbili, daima sawa
Maswali
Maswali, yaliyojibiwa.
Je, PesaBridge ni jukwaa ninaloshiriki, au langu mwenyewe?
Lako mwenyewe. PesaBridge ni bidhaa BridgeERP inayouza tena — kila mwendeshaji hupata usambazaji wake mwenyewe, wenye chapa na uliosanidiwa kwa ajili yake. Hakuna hifadhidata ya pamoja, hakuna msimamizi mkuu wa pamoja.
Ni nchi na sarafu zipi zinazoungwa mkono?
Yoyote. Nchi, sarafu, lugha na kanuni za KYC ni usanidi unaotolewa kutoka seti kamili ya ISO — si uliowekwa msimbo. Tuna masoko hai leo na tunaanzisha mapya bila kuandika upya.
Je, inafanya kazi kwenye simu za kawaida?
Ndiyo. Pochi kamili huendesha kupitia USSD — tuma, toa, lipa bili, nunua bidhaa, muda, salio na taarifa — ikikaa kwenye leja ilesawa na programu.
Je, ninaweza kuunganisha benki na njia zangu za malipo?
Ndiyo. Njia ni adapta zinazoweza kuunganishwa — benki, pesa za simu, kadi na PSP — hivyo unaunganisha kile tu soko lako linahitaji.
Ni haraka kiasi gani tunaweza kuwa hai?
Wiki, si miaka. Sanidi chapa na nchi yako, unganisha njia zako, kisha peleka programu, msimbo wa USSD na tovuti zako kutoka jukwaa moja.
Je, ni salama na inayoweza kukaguliwa?
Kila mwendo ni uandikishaji-mara-mbili na umesawazishwa hadi sifuri, umelindwa kwa PIN na KYC, na webhook zilizosainiwa na rekodi kamili ya ukaguzi kwa wadhibiti.
Ni programu zipi waendeshaji na wateja wao hupata?
Programu nne asilia za Android: programu ya Mtumiaji kwa wateja, programu ya Wakala / Wakala Mkuu kwa kuweka na kutoa pesa na float, programu ya Mfanyabiashara kupokea malipo na kulipwa, na programu ya Kampuni kwa malipo ya wingi yenye idhini ya watu wawili, ambayo pia inafanya kazi kama tovuti. Matoleo ya iOS yamo kwenye mpango.
Je, malipo na upatanishi hufanyaje kazi?
Fedha hukaa kwenye pochi husika kwa wakati halisi. Kila muamala huzalisha uandikishaji wa leja uliosawazishwa unaoweza kupatanisha, na taarifa na kuhamisha, na daraja la GL kwa mfumo wako wa uhasibu.
Je, inaweza kushughulikia mikopo, akiba na fedha za kikundi?
Ndiyo — mkopo wa overdraft, mikopo ya MFI yenye ratiba na hatari ya kwingineko, akiba ya lengo, na vikundi vya akiba (chama / merry-go-round) ni sehemu ya jukwaa na huwashwa kwa kila soko.
Je, mnaunga mkono malipo ya wingi kwa mishahara, misaada au ruzuku?
Ndiyo. Lango la Kampuni na API hufanya malipo ya jumla kwa maelfu ya pochi kwa idhini ya maker/checker, orodha za wapokeaji, ratiba na upatanisho kamili.
Inachukua nini kuiendesha kila siku?
Kidhibiti kimoja cha msimamizi wa mwendeshaji huendesha chapa, ushuru, KYC, mtandao wa mawakala na wafanyabiashara, leja, marejesho, usaidizi na KPI — hakuna msimbo unaohitajika kwa operesheni za kila siku.
Ni nani anayemiliki usambazaji na data?
Wewe. Kila mwendeshaji huendesha usambazaji wake mwenyewe na hifadhidata yake mwenyewe — wenye chapa na uliosanidiwa kwa ajili yake. Ni bidhaa unayouza tena kama yako mwenyewe, si mpangaji wa SaaS wa pamoja.
Soma zaidi
Miongozo kutoka kwa timu ya PesaBridge
Makala ziko kwa Kiingereza.
Endelea kuchunguza
Uende wapi baadaye
Uko tayari kuzindua pochi yako?
Panga onyesho na tutaanzisha chapa, nchi na njia zako — na kukuongoza kupitia programu, msimamizi na API.
Ungependa kuzungumza? Piga +254 746 883809