Course Content
Building Your First Mpesa Integration
This topic focuses on guiding you through the process of building a functional Mpesa integration from scratch. You will learn how to set up a backend for handling API requests, generate secure access tokens for authentication, and implement an STK Push transaction to facilitate payments. By the end of this topic, you will have a working example of Mpesa integration.
0/3
Backend Setup with PHP/Node.js/Other Frameworks
Generating Access Tokens
06:32
Implementing an STK Push Transaction
12:18
C2B and B2C Integrations
In this topic, learners will explore the core concepts of integrating Mpesa's Customer-to-Business (C2B) and Business-to-Customer (B2C) payment functionalities. The lessons will cover configuring C2B payments to enable customers to pay businesses and using B2C for disbursing funds to customers. Additionally, the topic will explain how to implement real-time transaction status updates to ensure seamless payment tracking and reconciliation.
0/3
Configuring C2B (Customer to Business) Payments
Using B2C (Business to Customer) for Disbursements
Real-Time Transaction Status Updates
Testing and Debugging
This topic focuses on ensuring the reliability and correctness of Mpesa integrations by testing in the sandbox environment, debugging using logs and tools like Postman, and eventually transitioning to the production environment. By the end of this topic, learners will be equipped with practical knowledge of testing and debugging their integration effectively.
0/3
Testing Transactions in the Sandbox Environment
Using Logs and Postman for Debugging
Moving to Production
00:00
Security and Best Practices
This topic covers the critical aspects of securing your Mpesa integration by properly managing API keys and tokens, handling errors in a way that improves the user experience, and complying with Mpesa’s integration guidelines. Following these practices ensures that your integration is secure, reliable, and in line with best practices, minimizing the risk of fraud and ensuring smooth operations.
0/3
Securing Your API Keys and Tokens
Handling Errors Gracefully
Complying with Mpesa Integration Guidelines
Real-World Application
This topic explores how Mpesa can be seamlessly integrated into real-world applications, particularly e-commerce platforms. It covers integrating payment systems, customizing user experiences to enhance payment flows, and using analytics for business insights. By the end of this topic, learners will understand how to leverage Mpesa for creating smoother and more efficient payment processes, as well as tracking transactions for actionable insights.
0/3
Integrating Mpesa into an E-Commerce Platform
Customizing User Experiences with Mpesa Payments
Analytics and Reporting
Build a Payment Gateway with Mpesa
In this project, learners will apply the skills acquired throughout the course to build a functional payment gateway integrated with Mpesa. The project will walk through the entire process, from backend setup and API integration to handling transactions and user feedback. By the end of this topic, learners will have developed a working payment gateway and be ready to present their projects for review and feedback.
0/3
Step-by-Step Implementation of a Working Payment Gateway
Presenting Your Project for Feedback
Final Project Submission
Introduction to Mpesa Integration
Gain an understanding of Mpesa’s role in facilitating mobile payments. Learn about its features, real-world applications, and benefits in businesses. This module covers the prerequisites for starting your Mpesa integration journey.
0/2
Overview of Mpesa services and APIs
11:02
Requirements for Mpesa Integration
00:45
Setting Up The Environment
In this topic, you learned how to set up the environment for Mpesa integration. This includes registering on the Mpesa Daraja Portal, acquiring API credentials, and using tools like Postman and Ngrok for development and testing. You also set up a local server, configured callback URLs, and simulated transactions in the sandbox environment. Finally, you prepared for production by understanding the approval process and transitioning to live operations. These steps form the foundation for successfully integrating Mpesa APIs into your application.
0/4
Tools and platforms needed (Postman, Ngrok, etc.)
Registering for Mpesa Daraja API
Overview of sandbox and production environments
Tools, Registration, and Environments Quiz
Understanding Mpesa APIs
This topic provides an overview of the various Mpesa APIs available for integration. You will learn about the key API services that facilitate mobile money transactions, such as the STK Push, C2B, B2C, and Account Balance APIs. Understanding how each API works will help you design robust and efficient payment systems, and ensure seamless transactions between businesses and customers.
0/3
Mpesa API documentation walkthrough
Authentication: Consumer Key and Secret
Key API Endpoints: STK Push, C2B, B2C, Balance Inquiry
Mpesa Integration – Daraja API :Crash Course
Applying the skills acquired throughout the course, the video below will guide you to build a functional payment gateway integrated with Mpesa. The project will walk through the entire process, from backend setup and API integration to handling transactions and user feedback. By the end of this topic, you will have developed a working payment gateway and be ready to present your projects for review and feedback.
0/2
Using Node.Js
Using PHP
M-Pesa Integration MasterClass
About Lesson

In this topic, learners will understand the process of registering for the Mpesa Daraja API. This includes creating an account on the Safaricom Developer Portal, generating the necessary API credentials (Consumer Key and Consumer Secret), and setting up the application for API access. Learners will also explore the importance of correctly configuring API settings for a successful integration.

 

  1. Create an Account on the Safaricom Developer Portal

    • Go to the Safaricom Developer Portal:
      https://developer.safaricom.co.ke
    • Click Sign Up to create a new account or Log In if you already have an account.
    • Provide the required information:
      • Email Address
      • Phone Number
      • Password (make sure it’s strong)
    • After signing up, confirm your registration via email.

  2. Create a New Application

    • After logging in, navigate to the My Apps section.
    • Click on Create New App.
    • Fill in the following fields:
      • App Name: This should be a unique and meaningful name (e.g., “MpesaIntegrationApp”).
      • App Description: A short description of what the app will do (e.g., “Mpesa payment integration for online store”).
      • API(s) to Use: Select the appropriate APIs based on the features you need, such as:
        • STK Push (for payment requests).
        • C2B (for customer-to-business payments).
        • Lipa na Mpesa Online (for online payments).
        • Transaction Status (to check the status of a transaction).
    • Save the app once all the details are filled.

  3. Generate Your API Credentials

    • After creating the app, go to the App Details page.
    • Under the Credentials section, you will find:
      • Consumer Key
      • Consumer Secret
    • These credentials are essential for authenticating your API requests, so make sure to store them securely.

  4. Set Up Callback URL and Shortcode

    • When using certain Mpesa APIs, you will need to provide a Callback URL, which is where Mpesa sends transaction responses.
    • For example, when initiating STK Push, Mpesa will send a response to this URL.
    • You will also need to obtain a Shortcode, which is used for services like C2B and STK Push.

  5. Testing in the Sandbox Environment

    • The Daraja Portal provides a Sandbox environment where you can test your integration before going live.
    • Ensure that your API requests are directed to the Sandbox environment URLs: 
      Sandbox API URL: https://sandbox.safaricom.co.ke
    • You can simulate payments, transaction statuses, and more to verify that your integration works as expected.

Summary

In this topic, you learned how to register for the Mpesa Daraja API. This process involves creating an account on the Safaricom Developer Portal, creating a new app, generating the required API credentials (Consumer Key and Consumer Secret), setting up callback URLs, and testing in the Sandbox environment. By following these steps, you ensure that your integration with Mpesa is ready for real-world use.

Previous
Next