Skip to main content

A Python wrapper for Mpesa Daraja APIs abstracting raw https request

Project description

Build Status License: MIT Organization made-with-python HitCount Inline Docs PyPI pyversions PRs Welcome GitHub pull-requests GitHub version.



This is an unofficial wrapper providing convenient access to the Safaricom MPESA Daraja API for applications written in Python.

It has been tested with Python 2 & 3

Setup and Installation

pip install daraja-mpesa

You can also clone or download the library package and install it using setuptools:

git clone
cd pympesa
python install


The library comes with simple integration tests with Safaricom's sandbox APIs. Due to factors beyond my control, the tests are structured to pass even when a specific Daraja API is under maintenance. To run the tests, simply execute pytest from the library's root directory:



from mpesa.api.<API> import <API Class>

API The following APIs are supported:

  • transaction_status
  • mpesa_express
  • reversal
  • balance
  • auth
  • b2c
  • c2b
  • b2b

API Class The following are the corresponding API classes:

  • TransactionStatus
  • MpesaExpress
  • Reversal
  • Balance
  • MpesaBase
  • B2B
  • C2B
  • B2C

TralahM TralahM


Read the Docs


How to Install

Building from Source for Developers

git clone
cd pympesa
python setupy bdist_wheel
python setupy install


See the Contributing File

See the Pull Request File



Read the license here


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for daraja-mpesa, version 1.2.1
Filename, size File type Python version Upload date Hashes
Filename, size daraja_mpesa-1.2.1-py3-none-any.whl (34.5 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page