PesaBridge
डेवलपर दस्तावेज़

PesaBridge API के साथ बनाएं।

कलेक्शन, पेआउट, होस्टेड चेकआउट और webhooks के लिए गाइड, ऐसे उदाहरणों के साथ जिन्हें आप सीधे अपने टर्मिनल में चिपका सकते हैं। सब कुछ पहले सैंडबॉक्स में चलता है।

बेस URL

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

53 एंडपॉइंट · OpenAPI 3 · HTTPS पर JSON

API संदर्भ

एक छोटी, पूर्वानुमेय सतह।

POST/oauth/tokenएक बियरर टोकन के लिए क्लाइंट क्रेडेंशियल्स बदलें।
POST/partner/stkएक ग्राहक को एक चार्ज (प्रॉम्प्ट-टू-पे) पुश करें।
GET/partner/statusएक चार्ज की स्थिति पोल करें।
GET/partner/balanceएक कलेक्शन खाता बैलेंस क्वेरी करें।
POST/biz/requestमर्चेंट रिक्वेस्ट-टू-पे।
POST/ussdUSSD मेनू गेटवे कॉलबैक।

रेल्स और इंटीग्रेशन

केवल वही कनेक्ट करें जो आपके बाज़ार को चाहिए।

रेल्स एक इंटरफ़ेस वाले प्लगेबल एडेप्टर हैं — कलेक्ट, पेआउट, बैलेंस और कॉलबैक — इसलिए एक नया कनेक्टर कभी कोर को नहीं छूता।

बैंक

RTGS / ACH / SWIFT / SEPA सेटलमेंट और नोस्ट्रो प्रबंधन।

मोबाइल मनी

हर बाज़ार के मोबाइल मनी ऑपरेटर, रेल एडेप्टर के ज़रिए।

कार्ड और PSP

प्रमुख कार्ड नेटवर्क पर एक्वायरिंग और प्रोसेसर इंटीग्रेशन।

बिलर और टेल्को

उपयोगिताएं, TV, सरकार, स्कूल फीस और एयरटाइम टॉप-अप।

पैसे के लिए डिज़ाइन किया

एक API जो पेमेंट्स सिस्टम की तरह व्यवहार करता है।

अधिकांश API डेटा चलाते हैं। यह पैसा चलाता है — इसलिए यह इडेम्पोटेंट, साइन किया, और एक चार्ज लाइफसाइकल के इर्द-गिर्द बना है जिस पर आप भरोसा कर सकें।

प्रमाणीकरण OAuth2 क्लाइंट-क्रेडेंशियल्स है: आप एक की और सीक्रेट को एक अल्पकालिक बियरर टोकन के लिए बदलते हैं। हर स्थिति-बदलने वाली कॉल एक इडेम्पोटेंसी की ले जाती है, इसलिए एक नेटवर्क री-ट्राई ठीक एक बार सेटल होता है — असली पैसा शामिल होने पर सबसे महत्वपूर्ण गुण।

एक कलेक्शन एक चार्ज है। आप इसे ग्राहक के नंबर पर पुश करते हैं; एक प्रॉम्प्ट-टू-पे उनके फोन पर आता है; वे एक PIN से पुष्टि करते हैं। चार्ज pending → authorised → completed (या declined / expired / failed) से गुज़रता है, और आप परिणाम दो तरीकों से जानते हैं: स्थिति एंडपॉइंट को पोल करें, या — बेहतर — बदलते ही एक वेबहुक प्राप्त करें।

वेबहुक HMAC-SHA256 से एक सीक्रेट के विरुद्ध साइन किए जाते हैं जिसे केवल आप और PesaBridge साझा करते हैं, और आपके एंडपॉइंट के स्वीकार करने तक बैकऑफ के साथ री-ट्राई किए जाते हैं — इसलिए आप एक छूटी या नकली घटना के डर के बिना उन पर निर्माण कर सकते हैं। बैलेंस और लेनदेन एंडपॉइंट मिलान के लिए लूप बंद करते हैं, और एक सैंडबॉक्स समान अनुबंध चलाता है, इसलिए आप विश्वास के साथ भेजते हैं।

चार्ज लाइफसाइकल

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

सुरक्षा और अनुपालन

भरोसा ही उत्पाद है।

वित्तीय सेवाएं शुद्धता और नियंत्रण पर जीती या मरती हैं। PesaBridge दोनों को कोर में समाहित करता है।

रचना से डबल-एंट्री

हर गतिविधि संतुलित डेबिट और क्रेडिट पोस्ट करती है — किताबें हमेशा शून्य पर मिलती हैं।

PIN, KYC और सीमाएं

कॉन्फ़िगरेबल KYC टियर, प्रति-लेनदेन और दैनिक सीमाएं, PIN प्रयास और वॉलेट लॉकिंग।

इडेम्पोटेंट और रिवर्सिबल

इडेम्पोटेंसी कीज़ दोहरे शुल्क रोकती हैं; एक एकीकृत रिवर्सल इंजन किसी भी विभाग को पूर्ववत करता है।

साइन किए वेबहुक

HMAC-SHA256 हस्ताक्षर और री-ट्राई ताकि पार्टनर सिस्टम हर कॉलबैक पर भरोसा कर सकें।

पूर्ण ऑडिट ट्रेल

रेगुलेटरों और विवादों के लिए अपरिवर्तनीय लेजर एंट्री और लेनदेन इतिहास।

प्रति-देश अनुपालन

ID प्रकार, KYC नियम और टैरिफ बाज़ार के साथ बदलते हैं, कॉन्फ़िगरेशन से।

कहीं अटक गए?

हमारे इंजीनियर इंटीग्रेशन से जुड़े सवालों के जवाब देते हैं। अनुरोध का रेफ़रेंस भेजें, हम ठीक वही कॉल ढूंढ लेंगे।