A Ready Business is…

Always prepared to maximise on its opportunities by exploiting technology to deliver a modern-feeling customer experience. It responds fast and empowers its employees to do their job better. Are you a Ready Business?

Watch Video Take the test

M-PESA API

 The new M-PESA platform dubbed G2 (for M-PESA 2nd generation platform) offers versatile integration capabilities that our development partners can take advantage of, to create excellent M-PESA journeys across the different industries they serve. This was a key factor in moving to the new platform. We have been consolidating the different interfaces our developers have expressed interest in to enable innovation around M-PESA. As expected, most of these are about the payment journeys, covering both disbursements (Business to Customers – B2C) and service payments (Customer to Business – C2B and Business to Business – B2B). These and other features are now available via secure Application Programming Interfaces (APIs) that allow for third party applications to easily plug into M-PESA.

M-PESA has been very successful mainly because of its simplicity of use and device agnostic nature – works the same way for the latest iPhone as the good old Nokia phone that has been passed over several user generations. The API rides on the same concept, providing open interfaces over standard protocols through web services. Unlike the old system (G1) where a lot of workarounds had been done to automate payment experiences, developers can now hook directly to the core M-PESA and get creative with the systems they run. Let’s look at the payments use cases below:    

  1. Automated Payment Receipt Processing: Imagine the different scenarios that require customers to pay and have this processed instantly! Before G2, this was handled purely through Instant Payment Notification (IPN) which has served quite well. As the name indicates, IPN is only for notification processing. The use cases for payment processing are as many as your imagination can get – from utility bills to m/ecommerce, and the future is likely to get even more interesting.

    With the new system, the notifications are taken a notch higher by incorporating an optional payment validation step for Paybill. This allows the payment recipient (merchants) to confirm whether to accept the incoming payment or not. While this may not sound very beneficial at the face of it, think of how many customers send payments to the right Paybill number but enter the wrong account. Money moves from the customer's M-PESA account but their service payment will not be processed and they have to follow up. This has been creating a big problem with the merchants, leading to massive reversal requests. This can now be handled through the validation API which allows the recipient to validate any of the payment parameters, including, account, amount and even sender and only accept the payment if processing can be guaranteed.

  2. Automated Payment Disbursements: Many systems that process receipts will also require outward payments processing. This could range from employees' salary disbursements to paying other merchants that accept M-PESA payments. This feature was only available via web portal for business to customers (B2C) with limitations on capacity that made it unsuitable for large disbursements. With the new platform, developers can have this done via API, which empowers them and cuts off the manual process of generating payments file, putting it in the right format then uploading it via the web portal, after which it has to be approved by a different user. With the B2C API, this is now seamless.

  3. Automated Payments Reversal: Even with an elaborate system, there is always a unique case that calls for a reversal. Imagine a situation where a customer has made a payment for services that the merchant is no longer able to render. The best way to handle this would be to have a reversal process that the merchant can adapt based on their internal processes. G2 supports secure payment reversal automation for such cases. The implementation will fully depend on the service journey and controls required at the recipient's business.  

Looking at the above use cases, one cannot fail to see the vast opportunity presented by the open interfaces. The future we once thought very distant of machine to machine payments is here and now. The only limitation to the adaption is the developer's imagination.

We will be organizing workshops to engage our developer community and exchange ideas on the available APIs as well as any gaps we may need to address. We will also be sharing documentation to guide developers manage these integrations seamlessly, delivering on our promise of nurturing innovation through open systems.

For any feedback or onboarding requests, Kindly contact This email address is being protected from spambots. You need JavaScript enabled to view it.

Download Full API Guide

Share this article
Read later
Add to favourites
Please enter your email
Favourite

Get PayBill Numbers

No more guessing when paying, be sure

Find PayBill Numbers

Get PayBill Numbers

See tool details See all Tools

M-PESA Statistics

See the role you have played in the M-PESA story

Discover your M-PESA impact

M-PESA Statistics

See the role you have played in the M-PESA story

--Select transation type--
--Select year--
See tool details See all Tools

NEED SUPPORT?We are here for you.

VIEW STOCKS DATA
SCOM 19.40         .      0.05 (0.26%)  .   HIGH  19.50  .   LOW   19.00  .   SHARES TRADED    106.20M