The Monei Python SDK is written in Python and ships with full type hints. It works in any Python ≥ 3.8 environment and supports both sync and async operations.
Installation
pip install monei-sdk
poetry add monei-sdk
pipenv install monei-sdk
Initialization
from monei import MoneiClient
monei = MoneiClient(
api_key=os.environ.get("MONEI_API_KEY")
)
Configuration Options
| Option | Type | Required | Description |
|---|---|---|---|
api_key | str | Yes | Your API key from the Monei dashboard |
base_url | str | No | Override the base URL (useful for sandbox) |
timeout | int | No | Request timeout in seconds (default: 30) |
SDK Services Overview
| Namespace | Service Class | What it does |
|---|---|---|
monei.user | UserService | Fetch and update the authenticated user |
monei.wallet_account | WalletAccountService | Wallet info and virtual accounts |
monei.deposit | DepositService | Naira wallet deposits |
monei.payout | PayoutService | Bank & peer transfers |
monei.wallet_utility | WalletUtilityService | Bank lookup & account verification |
monei.payment_method | PaymentMethodService | Saved payment methods |
monei.evm | EvmService | EVM blockchain operations |
monei.solana | SolanaService | Solana blockchain operations |
monei.exchange | ExchangeService | Token swaps (EVM & Solana) |
monei.bills | BillService | Airtime, data, electricity, cable TV |
monei.transactions | TransactionService | Transaction history & lookup |
monei.bill_discovery | BillDiscoveryService | Fetch available biller items |
monei.offramp_payouts | OfframpPayoutService | Offramp bank lookup & verification |
monei.bill_pay | BillPayService | Payment for bills |
monei.offramp_ledger | OfframpLedgerService | Offramp transaction history & lookup |
monei.bill_records | BillRecordsService | Bills history & lookup |
monei.offramp_exchange | OfframpExchangeService | Swap crypto to fiat |
monei.bill_validation | BillValidationService | Validate bills |
monei.business | BusinessService | Business customer operations |