waafipay 0.0.8

A Python client for the WaafiPay API

WaafiPay Python Client

Overview

The WaafiPay Python Client is a simple and intuitive library for integrating with the WaafiPay payment gateway. It allows you to perform various payment operations such as preauthorizing payments, committing transactions, and canceling preauthorizations, all while managing your API requests seamlessly.

Features

• Preauthorize Payments: Easily initiate payment preauthorizations with just a few lines of code.
• Commit Transactions: Securely commit preauthorized payments to finalize transactions.
• Cancel Preauthorizations: Cancel any pending preauthorizations quickly and efficiently.
• Easy to Use: Designed with simplicity in mind, making integration straightforward.
• Secure: Handles sensitive payment information with care.

Installation

You can install the WaafiPay package via pip:

pip install waafipay

Usage

1. Import the Client

First, import the WaafiPayClient class from the package:

from waafipay import WaafiPayClient

2. Initialize the Client

client = WaafiPayClient(
    merchant_uid="XXXXXXX",  # Your merchant UID
    api_user_id="XXXXXX",     # Your API user ID
    api_key="API-XXXXXXXX"  # Your API key
)

3. Preauthorize a Payment

client.preauthorize_payment(
    payer_account="61XXXXXXX", # Payer Account
    amount="0.01", # Amount
    )

4. Commit the Preauthorization

response = client.preauthorize(
    payer_account="61XXXXXXXX", 
    amount="0.01",
    )

response_code = response['responseCode']
if response_code == '2001':
    transaction_id = response['transactionId']
    client.commit(transaction_id=transaction_id)
else:
    errorMessage = response['responseMsg']
    print(errorMessage)

5. Cancel the Preauthorization

response = client.preauthorize(
    payer_account="61XXXXXXXX", 
    amount="0.01",
    )

response_code = response['responseCode']
if response_code == '2001':
    transaction_id = response['transactionId']
    client.cancel(transaction_id=transaction_id)
else:
    errorMessage = response['responseMsg']
    print(errorMessage)