digipay-python 1.0.0

Official DigiPay Python SDK — Accept Mobile Money payments, query transactions, manage payouts.

DigiPay Python SDK

Official Python SDK for the DigiPay Mobile Money payment gateway.

Installation

pip install digipay-python

Quick Start

from digipay import DigiPay

client = DigiPay(api_key="dpk_YOUR_API_KEY")
# or set env var: export DIGIPAY_API_KEY=dpk_... then call DigiPay()

# 1. Check your balance
balance = client.settlements.get_balance()
print(f"Balance: {balance['balance']:,} XAF")

# 2. Initiate a pay-in (customer receives Mobile Money push notification)
payin = client.payments.initiate(
    amount=5000,
    customer_phone="237699000000",
    customer_email="[e-mail]",
    metadata={"order_id": "ORDER_123"},
    webhook_url="https://your-domain.com/webhook",
)
print(payin["transaction_id"])  # TXN_...
print(payin["status"])          # "pending"

# 3. Check status later
txn = client.payments.get_status(payin["transaction_id"])
print(txn["status"])  # "pending" | "success" | "failed"

# 4. Withdraw funds
payout = client.settlements.request_payout(
    amount=10000,
    recipient_phone="237699000000",
)
print(payout["settlement_id"])

Error Handling

from digipay import DigiPay, DigiPayError

client = DigiPay(api_key="dpk_...")

try:
    payin = client.payments.initiate(amount=5000, customer_phone="237699000000")
except DigiPayError as e:
    print(f"Error: {e}")
    print(f"HTTP status: {e.status_code}")

License

MIT