paynexus-gateway 1.0.1

Simple PayNexus Gateway Python SDK for M-Pesa payments

PayNexus Gateway Python SDK

Simple Python SDK for PayNexus M-Pesa payments.

Installation

pip install paynexus-gateway

Requires Python 3.9 or later.

Usage

from paynexus_gateway import PayNexusClient

client = PayNexusClient("sk_your_secret_key_here")

payment = client.initiate_payment(
    amount=100,
    phone="0746990866",
    description="Order #12345",
)

reference = payment["data"]["reference"]
status = client.get_payment_status(reference)

Methods

Initiate payment

payment = client.initiate_payment(
    amount=100,
    phone="0746990866",
    description="Order #12345",
)

The API auto-normalizes the phone number and uses your default M-Pesa payment account.

Validate phone

result = client.validate_phone("0746990866")

Get payment status by reference

status = client.get_payment_status("PNXABC123")

Get payment status by CheckoutRequestID

status = client.get_payment_status_by_checkout_id("ws_CO_123456")

Error handling

from paynexus_gateway import PayNexusClient, PayNexusError

client = PayNexusClient("sk_your_secret_key_here")

try:
    client.initiate_payment(100, "0746990866", "Order #12345")
except PayNexusError as exc:
    print(exc.status, exc.code, exc.errors)

License

MIT