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.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

daraja_mpesa-1.2.1-py3-none-any.whl (34.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page