PesaBridge
ለገንቢዎች

ለስብስቦችና ክፍያዎች ንጹህ API።

OAuth2 ቁልፎች፣ ሳንድቦክስ፣ የDaraja-አይነት ጥያቄ-ለክፍያ፣ እና የተፈረሙ webhooks — በአንድ ከሰዓት በኋላ ያዋህዱ።

ሰነዶቹን ያንብቡየሳንድቦክስ ቁልፎች ያግኙየAPI ማጣቀሻ

ነፃ የሳንድቦክስ ቁልፎች በደቂቃዎች ውስጥ። የቀጥታ ቁልፎች ከአጭር ግምገማ በኋላ።

# 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  ✓

ፈጣን መጀመሪያ

ከዜሮ እስከ የተከፈለ ትዕዛዝ በአራት ደረጃዎች

ሁሉም ነገር በሙከራ ቁልፎች በሳንድቦክስ ውስጥ ይሠራል፣ ስለዚህ እውነተኛ ገንዘብ ከመንቀሳቀሱ በፊት ሙሉውን ሂደት መገንባት ይችላሉ።

  1. 1

    መለያ ይፍጠሩ

    በገንቢ ኮንሶል ይመዝገቡ። የሙከራ እና የቀጥታ ቁልፎች ወዲያውኑ ይሰጣሉ።

    /developer/signup
  2. 2

    ቶከን ያግኙ

    የቁልፍ ጥንድዎን ለአንድ ሰዓት በሚቆይ የBearer ቶከን ይቀይሩ።

    POST /oauth/token
  3. 3

    ከስልክ ክፍያ ይጠይቁ

    የክፍያ ጥያቄ ይላኩ። ደንበኛው በራሱ ስልክ በPIN ያጸድቃል።

    POST /partner/stk
  4. 4

    webhook ይቀበሉ

    የተፈረመ charge.completed ክስተት ትዕዛዙ እንደተከፈለ ለሰርቨርዎ ይነግራል።

    charge.completed ✓
ፈጣን መጀመሪያውን ይከተሉ የሳንድቦክስ ቁልፎች ያግኙ

ምን መገንባት ይችላሉ

ለገንዘብ መቀበል፣ ለገንዘብ መላክ እና በዙሪያቸው ላለው ሁሉ አንድ API

በ12 ቡድኖች ውስጥ 53 endpoints፣ በአንድ የማረጋገጫ መንገድ እና በአንድ የስህተት ቅርጸት።

14 endpoints

ክፍያ መቀበል

የክፍያ ጥያቄ፣ ተለዋዋጭ QR፣ Till እና Pay Bill፣ ደረሰኞች እና ቋሚ ትዕዛዞች።

መመሪያውን ያንብቡ
2 endpoints

የተዘጋጀ የክፍያ ገጽ

ዝግጁ የክፍያ ገጽ እና ሊጋሩ የሚችሉ የክፍያ አገናኞች፣ ያለ front-end ሥራ።

መመሪያውን ያንብቡ
5 endpoints

ክፍያ መላክ

ለቦርሳዎች፣ ለንግዶች እና ለግብር ባለሥልጣናት ይክፈሉ፣ ከአማራጭ ሁለተኛ ማረጋገጫ ጋር።

መመሪያውን ያንብቡ
8 endpoints

Webhooks

እንደገና ሙከራ፣ የሙከራ መላክ፣ የአቅርቦት ምዝግብ እና እንደገና መላክ ያላቸው የተፈረሙ ክስተቶች።

መመሪያውን ያንብቡ
3 endpoints

ግብይቶች እና ተመላሾች

እያንዳንዱን እንቅስቃሴ ይፈልጉ እና ያስታርቁ። ተመላሽ ሁለተኛ አጽዳቂ ይፈልጋል።

መመሪያውን ያንብቡ
14 endpoints

ቁልፎች እና ደህንነት

የሙከራ እና የቀጥታ ቁልፎች፣ የአንድ ሰዓት ቶከኖች፣ የቁልፍ መቀየር እና የቡድን መዳረሻ።

መመሪያውን ያንብቡ
4 endpoints

የሳንድቦክስ መሣሪያዎች

የማስመሰል ክፍያዎች፣ የተስተናገደ webhook ተቀባይ እና የቀጥታ ምዝግብ ማስታወሻዎች።

መመሪያውን ያንብቡ

ወደ ሥራ መግባት

አጭር የማረጋገጫ ዝርዝር፣ ከዚያ ወደ ቀጥታ ቁልፎች ይቀይሩ። ሌላ ምንም አይለወጥም።

መመሪያውን ያንብቡ

ለገንዘብ የተነደፈ

እንደ የክፍያ ስርዓት የሚሠራ API።

አብዛኞቹ APIዎች ዳታ ያንቀሳቅሳሉ። ይህ ገንዘብ ያንቀሳቅሳል — ስለዚህ idempotent፣ የተፈረመ፣ እና ሊታመንበት በሚችል የክፍያ የሕይወት ዑደት ዙሪያ የተገነባ ነው።

ማረጋገጫ OAuth2 client-credentials ነው፦ ቁልፍና ሚስጥር ለአጭር-ጊዜ bearer token ይለውጣሉ። እያንዳንዱ ሁኔታ-የሚቀይር ጥሪ የidempotency ቁልፍ ይይዛል፣ ስለዚህ የመረብ ድግግሞሽ በትክክል አንድ ጊዜ ይሰፍራል — እውነተኛ ገንዘብ ሲኖር በጣም አስፈላጊው ባህሪ።

ስብስብ ማለት ክፍያ ነው። ወደ ደንበኛ ቁጥር ይገፉታል፤ ጥያቄ-ለክፍያ በስልካቸው ላይ ይደርሳል፤ በPIN ያረጋግጣሉ። ክፍያው በመጠባበቅ ላይ → ተፈቅዷል → ተጠናቋል (ወይም ተከልክሏል / ጊዜው አልፏል / አልተሳካም) ይንቀሳቀሳል፣ እና ውጤቱን በሁለት መንገድ ያውቃሉ፦ የሁኔታ endpoint ያጣሩ፣ ወይም — የተሻለ — በሚቀየርበት ቅጽበት webhook ይቀበሉ።

Webhooks እርስዎና PesaBridge ብቻ በሚጋሩት ሚስጥር በHMAC-SHA256 የተፈረሙ ናቸው፣ እና endpointዎ እስኪያረጋግጥ ድረስ በኋላ-መልስ ይደገማሉ — ስለዚህ ያመለጠ ወይም የተጭበረበረ ክስተትን ሳይፈሩ በላያቸው ላይ መገንባት ይችላሉ። የቀሪ ሒሳብ እና የግብይት endpointዎች ለማስታረቅ ዑደቱን ይዘጋሉ፣ እና ሳንድቦክስ ተመሳሳዩን ውል ያንቀሳቅሳል፣ ስለዚህ በእምነት ያድርሳሉ።

የክፍያ የሕይወት ዑደት

pendingauthorisedcompleteddeclinedexpiredfailed
webhook · charge.completed
{
  "event": "charge.completed",
  "charge_ref": "STK9F2A",
  "amount": 250.00,
  "currency": "KES",
  "state": "completed",
  "signature": "hmac-sha256…"
}

መሣሪያዎች

ከAPI በላይ፦ በዙሪያው ያሉ መሣሪያዎች

የሚጣል ኮድ ሳይጽፉ ወይም ሰርቨር ሳያቆሙ ማገናኛዎን ያስሱ፣ ይሞክሩ እና ያርሙ።

የገንቢ ኮንሶሉን ይክፈቱ
የAPI አሳሽእያንዳንዱን endpoint ከአሳሹ በሳንድቦክስ ቁልፎችዎ ይጥሩ እና የተፈጠረውን ኮድ ይቅዱ።
የOpenAPI 3 ዝርዝርውሉን ያውርዱ እና በማንኛውም ቋንቋ client ይፍጠሩ።
Echo webhook ተቀባይአቅርቦቶችን የሚይዝ እና የሚያረጋግጥ የተስተናገደ URL፣ ያለ ሰርቨር ለመሞከር።
የጥያቄ ምዝግብ ማስታወሻዎችእያንዳንዱ ክፍያ እና እያንዳንዱ የwebhook አቅርቦት፣ ከሁኔታውና ከጊዜው ጋር።

የAPI ማጣቀሻ

ትንሽ፣ ሊተነበይ የሚችል ገጽታ።

POST/oauth/tokenየደንበኛ መረጃዎችን ለbearer token ይለውጡ።
POST/partner/stkወደ ደንበኛ ክፍያ (ጥያቄ-ለክፍያ) ይግፉ።
GET/partner/statusየክፍያ ሁኔታን ያጣሩ።
GET/partner/balanceየስብስብ ሒሳብ ቀሪ ይጠይቁ።
POST/biz/requestየነጋዴ ጥያቄ-ለክፍያ።
POST/ussdየUSSD ምናሌ ጌትዌይ callback።

ደህንነት እና ተገዢነት

እምነት ምርቱ ነው።

የፋይናንስ አገልግሎቶች በትክክለኛነትና በቁጥጥር ላይ ይኖራሉ ወይም ይሞታሉ። PesaBridge ሁለቱንም በማዕከሉ ውስጥ ያካትታል።

በግንባታ ድርብ-ግቤት

እያንዳንዱ እንቅስቃሴ ሚዛናዊ ዴቢት እና ክሬዲት ያስቀምጣል — መዝገቦቹ ወደ ዜሮ ይታረቃሉ፣ ሁልጊዜ።

PIN፣ KYC እና ገደቦች

ሊዋቀሩ የሚችሉ የKYC ደረጃዎች፣ በእያንዳንዱ ግብይት እና በየቀኑ ገደቦች፣ የPIN ሙከራዎች እና የዋሌት መቆለፍ።

Idempotent እና ሊመለስ የሚችል

የIdempotency ቁልፎች የእጥፍ ክፍያዎችን ያቆማሉ፤ የተዋሃደ የመመለሻ ሞተር ማንኛውንም መምሪያ ይፈታል።

የተፈረሙ webhooks

የHMAC-SHA256 ፊርማዎች እና ድግግሞሾች ስለዚህ የአጋር ስርዓቶች እያንዳንዱን callback ማመን ይችላሉ።

ሙሉ የኦዲት ዱካ

ለተቆጣጣሪዎችና ክርክሮች የማይለወጡ የሒሳብ ግቤቶች እና የግብይት ታሪክ።

በእያንዳንዱ አገር ተገዢነት

የመታወቂያ ዓይነቶች፣ የKYC ደንቦች እና ታሪፎች ከገበያ ጋር ይቀያየራሉ፣ ከውቅር።

ወደ ሥራ መግባት

ከሳንድቦክስ ወደ ምርት፣ አንድም መስመር ሳይጽፉ

ተመሳሳይ ኮድ በሁለቱም ሁነታዎች ይሠራል፤ የሚጠቀሙት ቁልፍ ይወስናል። ማገናኛዎ ሲዘጋጅ የቀጥታ መዳረሻ ይጠይቁ እና ቁልፎችን ይቀይሩ።

ሳንድቦክስግምገማቀጥታ
  • የwebhook ፊርማዎች ይረጋገጣሉ፣ ከጊዜ መስኮት ጋር
  • በእያንዳንዱ ክፍያ እና ክፍያ መላክ ላይ idempotency ቁልፍ
  • ሚስጥራዊ ቁልፎች በሰርቨርዎ ላይ ብቻ
  • የራሱ የፊርማ ሚስጥር ያለው የቀጥታ webhook endpoint
  • ከግብይቶች API ጋር ዕለታዊ ማስታረቅ
ወደ ሥራ የመግባት ዝርዝሩን ያንብቡየቀጥታ መዳረሻ ይጠይቁ
190+

ማስጀመር የሚችሉባቸው አገራት

4

ተወላጅ መተግበሪያዎች፣ አንድ መድረክ

4

ቻናሎች — መተግበሪያ · USSD · ድር · API

100%

ድርብ-ግቤት፣ ሁልጊዜ ሚዛናዊ

ተደጋጋሚ ጥያቄዎች

ጥያቄዎች፣ ተመልሰዋል።

PesaBridge የምጋራው መድረክ ነው ወይስ የራሴ?

የራስዎ። PesaBridge BridgeERP እንደገና የሚሸጠው ምርት ነው — እያንዳንዱ አንቀሳቃሽ ለእሱ የተቀረፀና የተዋቀረ የራሱን ማሰማራት ያገኛል። የተጋራ ዳታቤዝ የለም፣ የተጋራ ሱፐር-አስተዳዳሪ የለም።

የትኞቹ አገራት እና ገንዘቦች ይደገፋሉ?

ማንኛውም። አገር፣ ገንዘብ፣ ቋንቋ እና የKYC ደንቦች ከሙሉ የISO ስብስብ የተወሰዱ ውቅር ናቸው — በኮድ የተጣበቁ አይደሉም። ዛሬ ቀጥታ ገበያዎች አሉን እና ያለ እንደገና መጻፍ አዳዲሶችን እናቋቁማለን።

በተራ ስልኮች ላይ ይሠራል?

አዎ። ሙሉ ዋሌት በUSSD ይሠራል — መላክ፣ ማውጣት፣ ሒሳብ ክፍያ፣ እቃ ግዢ፣ የአየር ሰዓት፣ ቀሪ ሒሳብ እና መግለጫዎች — ከመተግበሪያዎቹ ጋር በተመሳሳይ ሒሳብ መዝገብ ላይ የሚሰፍር።

የራሴን ባንኮች እና የክፍያ ሐዲዶች ማገናኘት እችላለሁ?

አዎ። ሐዲዶች ሊሰኩ የሚችሉ አስማሚዎች ናቸው — ባንኮች፣ የሞባይል ገንዘብ፣ ካርዶች እና PSPs — ስለዚህ ገበያዎ የሚፈልገውን ብቻ ያገናኛሉ።

ምን ያህል ፈጥነን ቀጥታ መሆን እንችላለን?

ሳምንታት፣ ዓመታት አይደለም። ብራንድዎንና አገርዎን ያዋቅሩ፣ ሐዲዶችዎን ያገናኙ፣ ከዚያ መተግበሪያዎችዎን፣ የUSSD ኮድ እና የድር መግቢያዎችን ከአንድ መድረክ ያድርሱ።

ደህንነቱ የተጠበቀና ሊመረመር የሚችል ነው?

እያንዳንዱ እንቅስቃሴ ድርብ-ግቤት እና ወደ ዜሮ ሚዛናዊ ነው፣ በPIN እና በKYC የተጠበቀ፣ ከተፈረሙ webhooks እና ለተቆጣጣሪዎች ሙሉ የኦዲት ዱካ ጋር።

አንቀሳቃሾችና ደንበኞቻቸው የትኞቹን መተግበሪያዎች ያገኛሉ?

አራት ቤተኛ የAndroid መተግበሪያዎች፦ ለደንበኞች የተጠቃሚ መተግበሪያ፣ ለገንዘብ ማስገባት፣ ማውጣት እና ፍሎት የወኪል / ሱፐር-ወኪል መተግበሪያ፣ ክፍያ ለመቀበል እና ለማስታረቅ የነጋዴ መተግበሪያ፣ እና በሁለት ሰው ማጽደቅ ለጅምላ ክፍያዎች የኮርፖሬት መተግበሪያ፣ ይህም እንደ ድር ፖርታልም ይሠራል። የiOS ስሪቶች በዕቅድ ውስጥ ናቸው።

ሰፈራ እና ማስታረቅ እንዴት ይሠራል?

ገንዘቦች ወደ ተገቢው ዋሌት በቀጥታ ጊዜ ይሰፍራሉ። እያንዳንዱ ግብይት ሊያስታርቁት የሚችሉ ሚዛናዊ የሒሳብ ግቤቶችን ያመነጫል፣ ከመግለጫዎችና ወደ ውጭ ማውጫዎች ጋር፣ እና ለሒሳብ ስርዓትዎ የGL ድልድይ።

ብድር፣ ቁጠባ እና የቡድን ፋይናንስ ማስተናገድ ይችላል?

አዎ — የኦቨርድራፍት ብድር፣ ከሰሌዳዎችና ከአደጋ-ላይ-ፖርትፎሊዮ ጋር የMFI ብድሮች፣ የግብ ቁጠባ፣ እና የቁጠባ ቡድኖች (ቻማ / የመዞሪያ) የመድረኩ አካል ናቸው እና በእያንዳንዱ ገበያ ይበራሉ።

ለደመወዝ፣ ለእርዳታ ወይም ለድጎማ ብዙ ማከፋፈል ትደግፋላችሁ?

አዎ። የኮርፖሬት ፖርታሉና API በmaker/checker ማጽደቅ፣ የተቀባዮች ዝርዝር፣ መርሃ ግብርና ሙሉ ማስታረቅ ለሺዎች ቦርሳዎች የጅምላ ክፍያ ያካሂዳሉ።

በየቀኑ ለማንቀሳቀስ ምን ይጠይቃል?

አንድ የአንቀሳቃሽ አስተዳደር ኮንሶል ብራንድ፣ ታሪፍ፣ KYC፣ የወኪልና የነጋዴ መረብ፣ ሒሳብ መዝገብ፣ መመለሻዎች፣ ድጋፍ እና KPIs ያንቀሳቅሳል — ለዕለታዊ ኦፕሬሽኖች ኮድ አያስፈልግም።

ማሰማራቱንና ዳታውን ማን ይይዛል?

እርስዎ። እያንዳንዱ አንቀሳቃሽ የራሱን ዳታቤዝ ያለው የራሱን ማሰማራት ያንቀሳቅሳል — ለእሱ የተቀረፀና የተዋቀረ። እንደ የራስዎ እንደገና የሚሸጡት ምርት ነው፣ የተጋራ SaaS ተከራይ አይደለም።

ተጨማሪ ንባብ

ከPesaBridge ቡድን የተዘጋጁ መመሪያዎች

ጽሑፎቹ በእንግሊዝኛ ናቸው።

Engineering · 11 ደቂቃ ንባብ

Mobile money interoperability: how wallets, banks and switches connect

ያንብቡ
Engineering · 11 ደቂቃ ንባብ

Mobile money reconciliation: proving every balance, every day

ያንብቡ
Engineering · 11 ደቂቃ ንባብ

Prompt-to-pay, explained: STK push done right

ያንብቡ

ማሰስዎን ይቀጥሉ

ቀጥሎ ወዴት

የገንቢዎች ሰነዶችየክፍያ መቀበል፣ ክፍያ መላክ፣ የክፍያ ገጽ እና webhooks መመሪያዎች።
ውህደቶችWooCommerce፣ የክፍያ አገናኞች እና ከክፍያ መስመሮችዎ ጋር ግንኙነት።
ደህንነት እና ተገዢነትባለሁለት-መዝገብ ሌጀር፣ የKYC ደረጃዎች፣ የሁለት ሰው ማጽደቅ እና የኦዲት ዱካዎች።
ሙከራለአስተዳደር፣ ለመተግበሪያዎች እና ለAPI የሳንድቦክስ መዳረሻ ያግኙ።

ዋሌትዎን ለማስጀመር ዝግጁ ነዎት?

ማሳያ ይያዙና ብራንድዎን፣ አገርዎን እና ሐዲዶችዎን እናቋቁማለን — እና በመተግበሪያዎቹ፣ አስተዳደሩ እና API ውስጥ እናስኬድዎታለን።

ማሳያ ይያዙ መጀመሪያ ሞክረው ይመልከቱ

መነጋገር ይመርጣሉ? ይደውሉ +254 746 883809