Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!


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
Release History

Release History

This version
History Node


History Node


History Node


History Node

History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
Flutterwave-1.0.7.tar.gz (10.9 kB) Copy SHA256 Checksum SHA256 Source Oct 7, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting