pyairtel

import time

# Wait for the subscriber to approve on their phone
time.sleep(15)

status = airtel.get_collection_status(resp.transaction_id)

if status.is_successful:
    print("✅ Payment confirmed!", status.airtel_money_id)

elif status.is_pending:
    print("⏳ Subscriber hasn't approved yet...")

elif status.is_failed:
    print("❌ Payment failed:", status.message)

# Transaction status codes:
# TS  — Transaction Successful
# TIP — Transaction In Progress
# TF  — Transaction Failed
# TA  — Transaction Ambiguous

# Use airtel_money_id from a successful collection status
status = airtel.get_collection_status(transaction_id)

if status.is_successful:
    refund = airtel.refund(status.airtel_money_id)

    if refund.is_successful:
        print("↩️  Refund initiated:", refund.message)
    else:
        print("Refund failed:", refund.message)

# Step 1 — check the payee can receive money
check = airtel.validate_payee("+255754123456")

if not check.is_valid:
    print("Cannot receive money:", check.message)
else:
    # Step 2 — transfer money (PIN is RSA-encrypted automatically)
    result = airtel.transfer(
        phone="+255681219610",
        amount=2000,
        pin="1234",                  # merchant PIN — encrypted before sending
        public_key_pem=open("airtel_pub.pem").read(),
        payer_first_name="Ronald",
        payer_last_name="Gosso",
        reference="payout-001",
    )

    print(result.is_successful, result.airtel_money_id)

from pyairtel import AirtelMoney, decode_esb_error
from pyairtel.exceptions import (
    AuthenticationError,
    CollectionError,
    DisbursementError,
    EncryptionError,
)

try:
    resp = airtel.collect(phone="+255754123456", amount=1000, reference="ref-1")

except AuthenticationError as e:
    print("Bad credentials:", e)

except CollectionError as e:
    print("ESB code:", e.esb_code)      # e.g. "ESB000014"
    print("Reason:",   e.esb_message)   # "Insufficient funds..."

# Decode any ESB code manually
print(decode_esb_error("ESB000039"))
# → "Transaction timed out. The subscriber did not respond..."

# Step 1 — copy the template and fill in your values
# cp .env.example .env

# .env (never commit this file — it's in .gitignore)
AIRTEL_CLIENT_ID=your-client-id-here
AIRTEL_CLIENT_SECRET=your-client-secret-here
AIRTEL_SANDBOX=true
AIRTEL_PUBLIC_KEY_PATH=airtel_pub.pem  # disbursement only

# Step 2 — install python-dotenv
# pip install python-dotenv

# Step 3 — load in your app
from dotenv import load_dotenv
import os
from pyairtel import AirtelMoney

load_dotenv()  # reads .env into environment variables

airtel = AirtelMoney(
    client_id=os.environ["AIRTEL_CLIENT_ID"],
    client_secret=os.environ["AIRTEL_CLIENT_SECRET"],
    sandbox=os.getenv("AIRTEL_SANDBOX", "true").lower() == "true",
)