Skip to main content

MPower Payments Python client library

Project description

https://api.travis-ci.org/mawuli/mpower-python.png

MPower Python Client Library

This is a Python library for accessing the MPower Payments HTTP API.

Installation

$ sudo pip install mpower
$ OR git clone https://github.com/mawuli/mpower-python
$ cd mpower-python; python setup.py install`
$ nosetests tests/  # run unit tests

Usage

import mpower
from mpower import InvoiceItem, Store

# runtime configs
MP_ACCESS_TOKENS = {
    'MP-Master-Key': "Your MPower master key",
    'MP-Private-Key': "Your MPower private key",
    'MP-Token': "Your MPower token"
}
# defaults to False
mpower.debug = True
# set the access/api keys
mpower.api_keys = MP_ACCESS_TOKENS

# Invoice
store = Store(name='FooBar Shop')
items = [
    InvoiceItem(
        name="VIP Ticket",
        quantity=2,
        unit_price="35.0",
        total_price="70.0",
        description="VIP Tickets for the MPower Event"
    },
    InvoiceItem(
        name="Shoe",
        quantity=1,
        unit_price="75.99",
        total_price="80.99",
        description="Black shoe for men"
    },
]
invoice = mpower.Invoice(store)
invoice.add_items(items)
# taxes are (key,value) pairs
invoice.add_taxes([("NHIS TAX", 23.8), ("VAT", 5)])
invoice.add_custom_data([
    ("phone_brand", "Motorola V3"),
    ("model", "65456AH23"),
])

# you can also pass the items, taxes, custom to the `create` method
successful, response = invoice.create()
if successful:
    do_something_with_resp(response)

# confirm invoice
invoice.confirm(response['token'])


# OPR
opr_data = {
    'account_alias': '02XXXXXXXX',
    'description': 'Hello World',
    'total_amount': 345
}
store = mpower.Store(name='FooBar Shop')
opr = mpower.OPR(opr_data, store)
# You can also pass the data to the `create` function
successful, response = opr.create()
if successful:
   do_something_with_response(response)
status, _ = opr.charge({
    'token': token,
    'confirm_token': user_submitted_token
})


# Direct card
card_info = {
    "card_name" : "Alfred Robert Rowe",
    "card_number" : "4242424242424242",
    "card_cvc" : "123",
    "exp_month" : "06",
    "exp_year" : "2010",
    "amount" : "300"
}
direct_card = mpower.DirectCard(card_info)
# this request should fail since the card_info data is invalid
successful, response = direct_card.process()


# Direct Pay
account_alias =  "02XXXXXXXX"
amount =  30.50
# toggle debug switch to True
direct_pay = mpower.DirectPay(account_alias, amount)
status, response = direct_pay.process()

License

see LICENSE.txt

Contributing

Issues, forks, and pull requests are welcome!

Note

Authors

Mawuli Adzaku <mawuli at mawuli dot me>

Project details


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