The Monei Python SDK mirrors the Node.js SDK feature-for-feature. All service methods use snake_case naming. Requires Python ≥ 3.9.
The Python SDK is currently in beta. The Node.js SDK is the primary SDK and is recommended for production use today. Join our Discord to get early access and share feedback. Installation
Or with Poetry:
Initialization
import os
from monei import MoneiSDK
monei = MoneiSDK(api_key=os.getenv("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) |
Authentication Helpers
# Switch to bearer token (user-scoped operations)
monei.set_bearer_token("eyJhbGci...")
# Remove bearer token (fall back to API key)
monei.remove_bearer_token()
# Swap the API key
monei.set_api_key("new-api-key")
SDK Services Overview
| Attribute | What it does | |
|---|
monei.user | Fetch and update the authenticated user | |
monei.wallet_account | Wallet info and virtual accounts | |
monei.deposit | Naira wallet deposits | |
monei.payout | Bank & peer transfers | |
monei.wallet_utility | Bank lookup & account verification | |
monei.payment_method | Saved payment methods | |
monei.evm | EVM blockchain operations | |
monei.solana | Solana blockchain operations | |
monei.exchange | Token swaps (EVM & Solana) | |
monei.bills | Airtime, data, electricity, cable TV | |
monei.transactions | Transaction history & lookup | |
monei.billsDiscovery | BillDiscoveryService | Fecth available biller items |
monei.offrampPayouts | OfframpPayoutService | Offramp bank lookup & Verification |
monei.billsPay | BillPayService | Payment for bills |
monei.offrampLedger | OfframpLedgerService | Offramp transaction history & lookup |
monei.billsRecords | BillRecordsService | Bills history & lookup |
monei.offrampExchange | OfframpExchangeService | Swap crypto to fiat |
monei.billsValidation | BillValidateService | Validate bills |
monei.business | BusinessService | business customer operations |
