This package is aimed at helping developers interact with the paystack api easily and quickly too👌.
Create and activate your virtual environment.
pip install easypaystack
You can also add this dependency to your requirements file.
pip freeze > requirements.txt
Alright let's get down to business
Every call made will return a python dictionary containing a status code(2xx, 4xx) and a data object.
NOTE whenever you import any class from the easypaystack sdk, always instantiate it with your secret key else it will raise a "MissinAuthKeyError" Remember to never include your secret key ❌ in your code, instead use environment variables like the example below.
from decouple import config
secret_key = config("PAYSTACK_SECRET")
paystack = PaystackVerification(secret_key)Initiate a payment. This method initiates a pending transaction on paystack. Its is advisable to also create a pending transaction using this generated reference because you'll need it to verify this transaction after it's completed on the brower.
from easypaystack.payment import Payment
paystack = Payment(secret_key)
response = paystack.initiate_payment(email="[email protected]", kobo_amount=5000, reference="uniquers453")Verify a payment. Use the reference generated during the transaction initiation to verify this payment
from easypaystack.verification import PaystackVerification
paystack = PaystackVerification(secret_key)
response = paystack.verify_payment(reference=payment_reference)This method is used in recurring payments like subscriptions or monthly repayment. The user's card must have been tokenized prior to using this method call. You only tokenize a card once. To tokenize a card you need to use it for at least one payment transaction with minimum amount of about 100 naira then save the authorization code gotten from the payment verification response. Charge Authorization is a one step process, this means once you call this method the user is automatically debited, you don't need the user's input to perform this. The email address used here must be the same address used during the card tokenization
from easypaystack.payment import Payment
paystack = Payment(secret_key)
response = paystack.charge_authorization(authorization_code="authorization_code", email="[email protected]", kobo_amount=5000, reference="uniquers453")In order to do a transfer with paystack you need to first create a the transfer recipient.
from easypaystack.transfers import Transfer
paystack = Transfer(secret_key)
response = paystack.create_recipient(name="John Doe", account_number="07*******", bank_code="035")from easypaystack.transfers import Transfer
paystack = Transfer(secret_key)
response = paystack.get_transfer_recipients(perPage=50, page=1)from easypaystack.transfers import Transfer
paystack = Transfer(secret_key)
response = paystack.get_single_transfer_recipient(recipient_code='')from easypaystack.transfers import Transfer
paystack = Transfer(secret_key)
response = paystack.update_transfer_recipient(recipient_code='', name="", email="", description="this param is optional")from easypaystack.transfers import Transfer
paystack = Transfer(secret_key)
response = paystack.delete_transfer_recipient(recipient_code='')response = paystack.initiate_transfer(recipient_code="", amount=9000, narration="")Amount must be an instance of int or float, else a "TypeError" will be raised.
Note: Ensure you disable OTP from the Preferences tab on the Paystack Dashoard if you want your transfer to go instantly without the need to authorize it with an OTP.
from easypaystack.verification import PaystackVerification
paystack = PaystackVerification(secret_key)
response = paystack.verify_transfer(reference)from easypaystack.transfers import Transfer
paystack = Transfer(secret_key)
response = paystack.get_transfers(perPage=50, page=1)from easypaystack.verification import PaystackVerificationpaystack = PaystackVerification(secret_key)
response = paystack.resolve_account(account_number, bank_code)from easypaystack.transfers import Transfer
paystack = Transfer(secret_key)
response = paystack.get_balance()from easypaystack.verification import PaystackVerification
paystack = PaystackVerification(secret_key)
response = paystack.resolve_card_bin(six_digit='first_six_digit')from easypaystack.getters import Getters
paystack = Getters(secret_key)
response = paystack.get_banks(country="nigeria", currency="NGN")####Remarks Thank you for using easypaystack, if this package has helped you, you can give it a star⭐️ on github. Should you encounter any difficulty, you can open a github issue on this repo https://github.com/i-wizard/easypaystack.