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()