Using Monieswitch APIs in Python - Monieswitch Documentation

Who is this for?

Python developers who want to automate payments, manage wallets, or integrate Monieswitch into their backend services.

Overview

This guide covers:

Setting up your Python environment
Authenticating with the Monieswitch API
Making your first API request
Creating a payment link
Handling errors and best practices

Prerequisites

Set Up Python

Python 3.7+ installed. Download from python.org.

Create Monieswitch Account

A Monieswitch account. Register at Monieswitch Dashboard.

Get API Key

API Key from your Monieswitch dashboard.

1. Install Dependencies

We recommend using requests for HTTP requests and python-dotenv for environment variables.

pip install requests python-dotenv

2. Configure Your API Key

Create a .env file in your project directory:

MONIESWITCH_API_KEY=your_api_key_here

Never commit your .env file or API keys to source control.

3. Making Your First API Request

Here’s a sample script to fetch your merchant details from Monieswitch:

merchant_details.py

import os
import requests
from dotenv import load_dotenv

load_dotenv()

API_BASE = "https://nini.monieswitch.com"
API_KEY = os.getenv("MONIESWITCH_API_KEY")

def get_merchant_details():
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    try:
        response = requests.get(f"{API_BASE}/merchant/details", headers=headers)
        response.raise_for_status()
        print("Merchant Details:", response.json())
    except requests.exceptions.HTTPError as err:
        print("API Error:", err.response.status_code, err.response.json())
    except Exception as e:
        print("Request Error:", str(e))

if __name__ == "__main__":
    get_merchant_details()

4. Creating a Payment Link

create_payment_link.py

import os
import requests
from dotenv import load_dotenv

load_dotenv()

API_BASE = "https://nini.monieswitch.com"
API_KEY = os.getenv("MONIESWITCH_API_KEY")

def create_payment_link():
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    payload = {
        "amount": 200,
        "channel": "API",
        "name": "Product Purchase",
        "description": "One-time setup fee",
        "currency": "NGN",
        "supportCard": true,
        "requiresName": true,
        "requiresPhone": true,
        "supportBankTransfer": true,
        "webhookURL": "https://yoursite.com/webhook/payment",
        "callbackURL": "https://yoursite.com/thank-you",
        "email":"[email protected]"
    }
    try:
        response = requests.post(f"{API_BASE}/payment-links", json=payload, headers=headers)
        response.raise_for_status()
        print("Payment Link Created:", response.json())
    except requests.exceptions.HTTPError as err:
        print("API Error:", err.response.status_code, err.response.json())
    except Exception as e:
        print("Request Error:", str(e))

if __name__ == "__main__":
    create_payment_link()

5. Handling Errors and Best Practices

Always check for HTTP status codes and handle exceptions. The Monieswitch API returns detailed error messages in the response body.

Keep your API keys secret using environment variables.
Validate all API responses before using the data.
Read the API Reference for all available endpoints and parameters.

Next Steps

Explore more endpoints in the API Reference
Learn how to accept payments with Monieswitch in PHP (guide)
Set up webhooks for real-time notifications

​Who is this for?

​Overview

​Prerequisites

​1. Install Dependencies

​2. Configure Your API Key

​3. Making Your First API Request

​4. Creating a Payment Link

​5. Handling Errors and Best Practices

​Next Steps

Who is this for?

Overview

Prerequisites

1. Install Dependencies

2. Configure Your API Key

3. Making Your First API Request

4. Creating a Payment Link

5. Handling Errors and Best Practices

Next Steps