Python SDK

Install the package

pip install strongmb

Install in your backend project and commit the dependency lockfile where supported. Consult the official repository for runtime requirements and releases.

Configure the API key

Set STRONGMB_API_KEY in your server environment. The example reads it from that variable. Separate development and production configuration. Never expose the key in a browser bundle.

A complete purchase example

import os
import secrets

from strongmb import Strongmb, ApiError, AuthError, StrongmbError

client = Strongmb(os.environ["STRONGMB_API_KEY"])

try:
    response = client.data.purchase(
        phone="0123456789",
        product_code="smb_mtn_sme_1gb_30days",
        reference="MYAPP" + secrets.token_hex(12),
    )

    if response.successful():
        data = response.data()
        print(f"1GB sent to {data['recipient']}")
        print(f"  Balance: ₦{data['balance_after']:,}")
    elif response.processing():
        print("Processing… reference:", response.data()["reference"])
    elif response.failed():
        print("Failed. Trace ID:", response.trace_id())

except AuthError:
    print("Invalid API key.")
except ApiError as e:
    print(f"Error [{e.get_api_code()}]: {e}")
except StrongmbError as e:
    print(f"Network error: {e}")

How the example works

Parameter naming

Use product_code in Python keyword arguments. The REST API uses product_code. Follow the client example for the runtime you use.

Reliable transaction handling

Persist the order before calling the client. A network failure leaves the outcome uncertain. Read transaction lifecycle for duplicate-reference handling and the current transaction lookup behavior.

Versions and troubleshooting

These examples follow the existing Strongmb SDK documentation. Check the SDK source and README for version-specific constructor options and available resources. Use the REST API for services not exposed by your installed SDK.