skip to navigation
skip to content

Flutterwave 1.0.7


Python Bindings for the Flutterwave Payment APIs.


To install the flutterwave python package, run the command below:

pip install --upgrade flutterwave


easy_install --upgrade flutterwave

See for instructions on installing pip. If you are on a system with easy_install but not pip, you can use easy_install instead.

To install from source, clone this repo, then run from directory:

python install

Linux users may require missing python headers for the crypto library, run this to install:

sudo apt-get update; sudo apt-get install python-dev -y

API Services

  • Charge Accounts
  • Charge Cards
  • Disburse to Accounts
  • Account Number Lookup
  • Card BIN Lookup
  • Card Balance Enquiry
  • Foreign Bank Account Transfers (ACH)
  • BVN Validation
  • IP Check

Getting Started

To debit an account, in two steps: first, tokenize the account, then charge the account using the returned token:

from flutterwave import Flutterwave
flw = Flutterwave("<api_key>", "<merchant_key>", {"debug": True})

payload = {
    "token": "FZeDswE6ju0ONCL3864",    # Token returned from account tokenization request
    "amount": "100",                   # Amount to debit from account
    "narration": "payment for coffee", # Description for this payment
    "country": "NG"                    # country of debit source

r = flw.account.charge(payload)
print "{}".format(r.text)

# Response
# {
#   {
#       "transactionreference":"FLW00292801",
#       "responseMessage":"Approved or Completed Successfully",
#       "responseCode":"00"
#   },
#   "status":"success"
# }

Tokens are valid means of charging an account or card subsequently. Find more examples here .

Sign up at for API keys.


Optional Setup Paremeters

Parameter Description
env (staging, production) sets the library to development or live
baseUrl sets the base url used internally
debug enables request and response logging to console.

After development, the go-live process requires live keys and an optional argument

flw = Flutterwave(“<api_key_live>”, “<merchant_key_live>”, {“env”:”production”})


Flutterwave-Python is written in python version 2.7 and can be tested by running the command below from the package folder:

python -m unittest discover
File Type Py Version Uploaded on Size
Flutterwave-1.0.7.tar.gz (md5) Source 2016-10-07 10KB