pesapal-sdk 0.1.0

Python wrapper for the Pesapal API

Pesapal Python SDK

Unofficial Python SDK for Pesapal API 3.0

Features

• Automatic token management and refresh
• Type-safe request models
• Clean, intuitive API
• Comprehensive docs
• Good test coverage

Installation

pip install pesapal-sdk

Quickstart

from pesapal_sdk import PesapalClient
from pesapal.models import OrderRequest, BillingAddress
from decimal import Decimal

# Initialize client
client = PesapalClient(
    consumer_key="<YOUR-PESAPAL-CONSUMER-KEY>",
    consumer_secret="<YOUR-PESAPAL-CONSUMER-SECRET>",
    environment="sandbox" # or "production"
)

# Register IPN URL (one-time setup)
ipn_response = client.ipn.register("https://yoursite.com/ipn")
ipn_id = ipn_response["ipn_id"]

# Create billing address
billing = BillingAddress(
    email_address="[e-mail]",
    phone_number="0712345678",
    country_code="KE",
    first_name="Kevin",
    last_name="Kimani",
    line_1="Juja, Kenya"
)

# Submit order
order = OrderRequest(
    id="order-123",
    currency="KES",
    amount=Decimal("1000.00"),
    description="Payment for services",
    callback_url="https://yoursite.com/callback",
    notification_id=ipn_id,
    billing_address=billing
)

response = client.transactions.submit_order(order)
print(f"Redirect URL: {response['redirect_url']}")

# Check transaction status
status = client.transactions.get_status(response["order_tracking_id"])
print(f"Status: {status['payment_status_description']}"

Requirements

• Python 3.8+
• requests

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

• Documentation: Pesapal API Docs
• Issues: GitHub Issues

Disclaimer

This is an unofficial SDK and is not affiliated with or endorsed by Pesapal.