malipo 1.0.0__tar.gz

malipo-1.0.0/.gitignore

@@ -0,0 +1,29 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+.env
+.env.local
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Supabase
+supabase/.temp/

malipo-1.0.0/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: malipo
+Version: 1.0.0
+Summary: The official Python library for the Malipo Payment Gateway
+Author-email: Malipo Dev Team <dev@malipo.com>
+License-Expression: MIT
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.25.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == 'test'
+Requires-Dist: responses>=0.18.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Malipo Python SDK
+
+The official Python library for the Malipo Payment Gateway. Securely accept Mobile Money payments (Vodacom MPesa, Orange Money, Airtel Money) in the DRC.
+
+## Installation
+
+```bash
+pip install malipo
+```
+
+## Quick Start
+
+```python
+from malipo import Malipo
+
+malipo = Malipo(api_key='sk_test_your_api_key')
+
+# Create a charge
+try:
+    charge = malipo.charges.create({
+        "amount": 10,
+        "currency": "USD",
+        "phone": "243810000000",
+        "network": "VODACOM_MPESA",
+        "description": "Order #123"
+    }, idempotency_key='unique_order_id_123')
+
+    print(f"Charge initiated: {charge['id']}")
+    print(f"Status: {charge['status']}") # 'pending'
+except Exception as e:
+    print(f"Charge failed: {e}")
+```
+
+## Features
+
+### 🔐 Idempotency
+Protect against duplicate charges by providing an `idempotency_key` in the options.
+
+### 🔄 Environment Detection
+The SDK automatically switches between `sandbox` and `live` environments based on your API key prefix (`sk_test_` vs `sk_live_`).
+
+### 📊 Balance Check
+Check your available and pending balances for your current environment.
+
+```python
+balance = malipo.balance.retrieve()
+print(f"Available USD: {balance['available'][0]['amount']}")
+```
+
+## Webhooks
+
+```python
+from flask import Flask, request
+from malipo import Malipo
+
+app = Flask(__name__)
+malipo = Malipo(api_key='...')
+
+@app.route('/webhooks/malipo', methods=['POST'])
+def handle_webhook():
+    signature = request.headers.get('X-Webhook-Signature')
+    payload = request.get_data(as_text=True)
+    
+    try:
+        event = malipo.webhooks.construct_event(
+            payload=payload,
+            signature=signature,
+            secret='whsec_your_secret'
+        )
+        
+        if event['type'] == 'charge.succeeded':
+            charge = event['data']['object']
+            print(f"Payment successful: {charge['id']}")
+            
+        return "OK", 200
+    except Exception as e:
+        return str(e), 400
+```
+
+## License
+MIT

malipo-1.0.0/README.md

@@ -0,0 +1,81 @@
+# Malipo Python SDK
+
+The official Python library for the Malipo Payment Gateway. Securely accept Mobile Money payments (Vodacom MPesa, Orange Money, Airtel Money) in the DRC.
+
+## Installation
+
+```bash
+pip install malipo
+```
+
+## Quick Start
+
+```python
+from malipo import Malipo
+
+malipo = Malipo(api_key='sk_test_your_api_key')
+
+# Create a charge
+try:
+    charge = malipo.charges.create({
+        "amount": 10,
+        "currency": "USD",
+        "phone": "243810000000",
+        "network": "VODACOM_MPESA",
+        "description": "Order #123"
+    }, idempotency_key='unique_order_id_123')
+
+    print(f"Charge initiated: {charge['id']}")
+    print(f"Status: {charge['status']}") # 'pending'
+except Exception as e:
+    print(f"Charge failed: {e}")
+```
+
+## Features
+
+### 🔐 Idempotency
+Protect against duplicate charges by providing an `idempotency_key` in the options.
+
+### 🔄 Environment Detection
+The SDK automatically switches between `sandbox` and `live` environments based on your API key prefix (`sk_test_` vs `sk_live_`).
+
+### 📊 Balance Check
+Check your available and pending balances for your current environment.
+
+```python
+balance = malipo.balance.retrieve()
+print(f"Available USD: {balance['available'][0]['amount']}")
+```
+
+## Webhooks
+
+```python
+from flask import Flask, request
+from malipo import Malipo
+
+app = Flask(__name__)
+malipo = Malipo(api_key='...')
+
+@app.route('/webhooks/malipo', methods=['POST'])
+def handle_webhook():
+    signature = request.headers.get('X-Webhook-Signature')
+    payload = request.get_data(as_text=True)
+    
+    try:
+        event = malipo.webhooks.construct_event(
+            payload=payload,
+            signature=signature,
+            secret='whsec_your_secret'
+        )
+        
+        if event['type'] == 'charge.succeeded':
+            charge = event['data']['object']
+            print(f"Payment successful: {charge['id']}")
+            
+        return "OK", 200
+    except Exception as e:
+        return str(e), 400
+```
+
+## License
+MIT

malipo-1.0.0/malipo/__init__.py

@@ -0,0 +1,4 @@
+from .client import Malipo
+from .errors import MalipoError
+
+__all__ = ["Malipo", "MalipoError"]

malipo-1.0.0/malipo/client.py

@@ -0,0 +1,111 @@
+import json
+import hmac
+import hashlib
+import requests
+from typing import Optional, Any, Dict
+from .types import (
+    MalipoEnvironment, 
+    MalipoTransaction, 
+    MalipoBalance, 
+    ChargeCreateParams,
+    MalipoEvent
+)
+from .errors import MalipoError
+
+class Malipo:
+    def __init__(self, api_key: str, environment: Optional[MalipoEnvironment] = None, base_url: Optional[str] = None):
+        if not api_key:
+            raise ValueError("Malipo API Key is required.")
+        
+        self.api_key = api_key
+        
+        # Infer environment from API Key if not explicitly provided
+        if environment:
+            self.environment = environment
+        else:
+            self.environment = "live" if api_key.startswith("sk_live_") else "sandbox"
+            
+        self.base_url = base_url or "https://lcwadpidhwptpzriqnjd.supabase.co/functions/v1"
+        
+        # Initialize resources
+        self.charges = ChargesResource(self)
+        self.transactions = TransactionsResource(self)
+        self.balance = BalanceResource(self)
+        self.webhooks = WebhooksResource()
+
+    def request(self, method: str, endpoint: str, params: Optional[Dict] = None, headers: Optional[Dict] = None):
+        url = f"{self.base_url}{endpoint}"
+        
+        default_headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type": "application/json",
+            "X-Client-Info": "malipo-python/1.0.0"
+        }
+        if headers:
+            default_headers.update(headers)
+            
+        try:
+            response = requests.request(
+                method=method,
+                url=url,
+                json=params if method == "POST" else None,
+                params=params if method == "GET" else None,
+                headers=default_headers
+            )
+            
+            data = response.json()
+            
+            if not response.ok:
+                error_data = data.get("error", {})
+                raise MalipoError(
+                    message=error_data.get("message", "An unexpected error occurred"),
+                    status_code=response.status_code,
+                    code=error_data.get("code"),
+                    details=error_data
+                )
+                
+            return data
+            
+        except requests.exceptions.RequestException as e:
+            raise MalipoError(f"Network error: {str(e)}")
+
+class ChargesResource:
+    def __init__(self, client: Malipo):
+        self.client = client
+
+    def create(self, params: ChargeCreateParams, idempotency_key: Optional[str] = None) -> MalipoTransaction:
+        headers = {}
+        if idempotency_key:
+            headers["Idempotency-Key"] = idempotency_key
+        return self.client.request("POST", "/charge", params, headers)
+
+class TransactionsResource:
+    def __init__(self, client: Malipo):
+        self.client = client
+
+    def retrieve(self, transaction_id: str) -> MalipoTransaction:
+        return self.client.request("GET", "/transaction-status", {"id": transaction_id})
+
+class BalanceResource:
+    def __init__(self, client: Malipo):
+        self.client = client
+
+    def retrieve(self) -> MalipoBalance:
+        endpoint = "/live-balance" if self.client.environment == "live" else "/sandbox-balance"
+        return self.client.request("GET", endpoint)
+
+class WebhooksResource:
+    def construct_event(self, payload: str, signature: str, secret: str) -> MalipoEvent:
+        if not payload or not signature or not secret:
+            raise ValueError("Missing payload, signature, or secret for webhook verification.")
+            
+        expected_signature = hmac.new(
+            secret.encode("utf-8"),
+            payload.encode("utf-8"),
+            hashlib.sha256
+        ).hexdigest()
+        
+        if not hmac.compare_digest(expected_signature, signature):
+            raise MalipoError("Invalid webhook signature.")
+            
+        return json.loads(payload)

malipo-1.0.0/malipo/errors.py

@@ -0,0 +1,11 @@
+class MalipoError(Exception):
+    """Base error for all Malipo SDK errors"""
+    def __init__(self, message: str, status_code: int = None, code: str = None, details: dict = None):
+        super().__init__(message)
+        self.message = message
+        self.status_code = status_code
+        self.code = code
+        self.details = details
+
+    def __str__(self):
+        return f"{self.message} (status: {self.status_code}, code: {self.code})"

malipo-1.0.0/malipo/types.py

@@ -0,0 +1,51 @@
+from typing import TypedDict, List, Optional, Any, Literal
+
+MalipoNetwork = Literal["VODACOM_MPESA", "AIRTEL_MONEY", "ORANGE_MONEY"]
+MalipoTransactionStatus = Literal["pending", "succeeded", "failed", "expired"]
+MalipoEnvironment = Literal["sandbox", "live"]
+
+class MalipoConfig(TypedDict):
+    api_key: str
+    environment: Optional[MalipoEnvironment]
+    base_url: Optional[str]
+
+class ChargeCreateParams(TypedDict, total=False):
+    amount: float
+    currency: str
+    phone: str
+    network: MalipoNetwork
+    description: Optional[str]
+    metadata: Optional[dict]
+
+class MalipoTransaction(TypedDict):
+    id: str
+    object: Literal["transaction"]
+    amount: float
+    currency: str
+    status: MalipoTransactionStatus
+    phone: str
+    network: MalipoNetwork
+    environment: MalipoEnvironment
+    metadata: dict
+    created_at: str
+    updated_at: str
+    failure_reason: Optional[str]
+    failure_code: Optional[str]
+
+class MalipoBalanceAmount(TypedDict):
+    amount: float
+    currency: str
+
+class MalipoBalance(TypedDict):
+    object: Literal["balance"]
+    available: List[MalipoBalanceAmount]
+    pending: List[MalipoBalanceAmount]
+    updated_at: str
+
+class MalipoEvent(TypedDict):
+    id: str
+    object: Literal["event"]
+    type: str
+    environment: MalipoEnvironment
+    data: dict # contains object: MalipoTransaction
+    created_at: str

malipo-1.0.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "malipo"
+version = "1.0.0"
+description = "The official Python library for the Malipo Payment Gateway"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+authors = [
+    { name = "Malipo Dev Team", email = "dev@malipo.com" },
+]
+dependencies = [
+    "requests>=2.25.0",
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest>=7.0.0",
+    "responses>=0.18.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["malipo"]

malipo-1.0.0/tests/test_client.py

@@ -0,0 +1,80 @@
+import pytest
+import responses
+import json
+import hmac
+import hashlib
+from malipo import Malipo, MalipoError
+
+@pytest.fixture
+def client():
+    return Malipo(api_key="sk_test_123")
+
+@responses.activate
+def test_create_charge(client):
+    responses.add(
+        responses.POST,
+        "https://lcwadpidhwptpzriqnjd.supabase.co/functions/v1/charge",
+        json={"id": "tx_123", "status": "pending"},
+        status=200
+    )
+    
+    charge = client.charges.create({
+        "amount": 10,
+        "currency": "USD",
+        "phone": "243810000000",
+        "network": "VODACOM_MPESA"
+    }, idempotency_key="idemp_123")
+    
+    assert charge["id"] == "tx_123"
+    assert responses.calls[0].request.headers["Idempotency-Key"] == "idemp_123"
+
+@responses.activate
+def test_retrieve_transaction(client):
+    responses.add(
+        responses.GET,
+        "https://lcwadpidhwptpzriqnjd.supabase.co/functions/v1/transaction-status?id=tx_123",
+        json={"id": "tx_123", "status": "succeeded"},
+        status=200
+    )
+    
+    tx = client.transactions.retrieve("tx_123")
+    assert tx["status"] == "succeeded"
+
+@responses.activate
+def test_error_handling(client):
+    responses.add(
+        responses.POST,
+        "https://lcwadpidhwptpzriqnjd.supabase.co/functions/v1/charge",
+        json={"error": {"message": "Invalid amount", "code": "invalid_amount"}},
+        status=400
+    )
+    
+    with pytest.raises(MalipoError) as excinfo:
+        client.charges.create({"amount": -1})
+    
+    assert "Invalid amount" in str(excinfo.value)
+    assert excinfo.value.status_code == 400
+    assert excinfo.value.code == "invalid_amount"
+
+def test_webhook_verification(client):
+    payload = json.dumps({"id": "evt_123", "type": "charge.succeeded"})
+    secret = "whsec_test"
+    signature = hmac.new(
+        secret.encode("utf-8"),
+        payload.encode("utf-8"),
+        hashlib.sha256
+    ).hexdigest()
+    
+    event = client.webhooks.construct_event(payload, signature, secret)
+    assert event["id"] == "evt_123"
+    assert event["type"] == "charge.succeeded"
+
+def test_webhook_verification_failure(client):
+    payload = json.dumps({"id": "evt_123"})
+    secret = "whsec_test"
+    signature = "wrong_signature"
+    
+    with pytest.raises(MalipoError) as excinfo:
+        client.webhooks.construct_event(payload, signature, secret)
+    
+    assert "Invalid webhook signature" in str(excinfo.value)