Skip to main content


Project description

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

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 Flutterwave, version 1.0.7
Filename, size File type Python version Upload date Hashes
Filename, size Flutterwave-1.0.7.tar.gz (10.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page