python-flutterwave 0.1.4

Python Wrapper for interacting with the Flutterwave Payments API

Python Flutterwave

Description

Python Wrapper for interacting with the Flutterwave API

Installation

• pip install python-flutterwave

Usage

• Create an account in Flutterwave and obtain your Secret Key only.

from python_flutterwave import payment

payment.token = 'YOUR_SECRET_KEY'

• To trigger a standard payment that returns a redirect uri

uri = payment.initiate_payment(tx_ref="qwerty", amount=100, redirect_url='your_callback_url',
                               payment_options='mpesa', customer_email='[e-mail]',
                               customer_phone_number='0123456789', currency='KES', customer_name='John Doe',
                               title='Demo Payment', description='Just pay me...')
print(uri)

• Redirect the user to that uri where he/she will make the payment.

• After payment is made, the user will be redirected to the redirect_url you declared but Flutterwave will append some info regarding the payment i.e. transaction_id and tx_ref. If your url is https://example.com/callback then it may be http://example.com/callback/?status=successful&tx_ref=qwerty&transaction_id=2784792

• You should save the transaction_id to your DB as it will be used to query the transaction details.

• To check the transaction details e.g. successful or not, grab the transaction_id from the previous step.

details = payment.get_payment_details(transaction_id)
print(details)

• To trigger an automatic mpesa charge on your customer, first configure your Webhook url in the dashboard, it may be a simple server; Flutterwave will post some data regarding your transaction status in that url. This method call will return a Python dict object. You can decide what to do thereon.

mpesa_trans_details = payment.trigger_mpesa_payment(tx_ref="qwertyuio", amount=100, currency='KES', 
                                                    email='[e-mail]', phone_number='1234567890', 
                                                    full_name='John Doe')
print(mpesa_trans_details)