moneypulse 1.0.0__tar.gz

moneypulse-1.0.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: moneypulse
+Version: 1.0.0
+Summary: Official Money-Pulse Python SDK — Accept payments and process payouts across Africa.
+Home-page: https://github.com/nocyl-pulse/moneypulse-python
+Author: NOCYL-PULSE
+Author-email: NOCYL-PULSE <dev@money-pulse.org>
+License: MIT
+Project-URL: Homepage, https://money-pulse.org
+Project-URL: Repository, https://github.com/nocyl-pulse/moneypulse-python
+Project-URL: Issues, https://github.com/nocyl-pulse/moneypulse-python/issues
+Keywords: money-pulse,payments,africa,mobile-money,sdk
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# moneypulse
+
+Official Python SDK for [Money-Pulse](https://money-pulse.org).
+
+## Installation
+
+```bash
+pip install moneypulse
+```
+
+## Quick start
+
+```python
+import moneypulse
+client = moneypulse.Client("mp_live_xxx")
+
+payment = client.payments.create(
+    amount=10000, currency="XOF", country="CI",
+    customer={"email": "client@email.com", "phone": "+22507000000"},
+    callback_url="https://your-site.com/webhook",
+)
+print(payment["checkout_url"])
+```
+
+## Payouts
+
+```python
+payout = client.payouts.create(
+    amount=50000, currency="XOF", country="CI",
+    recipient={"type": "mobile_money", "phone": "+22507000000", "name": "Jean Kouassi"},
+)
+```
+
+## Webhook verification (HMAC SHA-256)
+
+### Django
+
+```python
+import hmac, hashlib, json
+from django.http import HttpResponse
+from django.views.decorators.csrf import csrf_exempt
+
+@csrf_exempt
+def mp_webhook(request):
+    signature = request.headers.get("X-MoneyPulse-Signature", "")
+    expected = hmac.new(
+        settings.MP_WEBHOOK_SECRET.encode(),
+        request.body, hashlib.sha256
+    ).hexdigest()
+    if not hmac.compare_digest(signature, expected):
+        return HttpResponse(status=401)
+
+    event = json.loads(request.body)
+    if event["type"] == "payment.success":
+        # fulfill order
+        pass
+    return HttpResponse(status=200)
+```
+
+### FastAPI
+
+```python
+from fastapi import FastAPI, Request, HTTPException
+import hmac, hashlib
+
+app = FastAPI()
+
+@app.post("/webhook")
+async def webhook(req: Request):
+    body = await req.body()
+    signature = req.headers.get("x-moneypulse-signature", "")
+    expected = hmac.new(SECRET.encode(), body, hashlib.sha256).hexdigest()
+    if not hmac.compare_digest(signature, expected):
+        raise HTTPException(401)
+    return {"received": True}
+```
+
+## Simulation mode
+
+```python
+result = client.payments.create(
+    amount=1000, currency="XOF", country="CI",
+    customer={"email": "t@t.com"},
+    simulate=True,  # no funds, no webhook, no billing
+)
+```
+
+## Error handling
+
+```python
+from moneypulse.client import MoneyPulseError
+
+try:
+    client.payments.create(...)
+except MoneyPulseError as e:
+    print(e.code, e.status_code, e)
+```
+
+## License
+
+MIT © NOCYL-PULSE

moneypulse-1.0.0/README.md

@@ -0,0 +1,101 @@
+# moneypulse
+
+Official Python SDK for [Money-Pulse](https://money-pulse.org).
+
+## Installation
+
+```bash
+pip install moneypulse
+```
+
+## Quick start
+
+```python
+import moneypulse
+client = moneypulse.Client("mp_live_xxx")
+
+payment = client.payments.create(
+    amount=10000, currency="XOF", country="CI",
+    customer={"email": "client@email.com", "phone": "+22507000000"},
+    callback_url="https://your-site.com/webhook",
+)
+print(payment["checkout_url"])
+```
+
+## Payouts
+
+```python
+payout = client.payouts.create(
+    amount=50000, currency="XOF", country="CI",
+    recipient={"type": "mobile_money", "phone": "+22507000000", "name": "Jean Kouassi"},
+)
+```
+
+## Webhook verification (HMAC SHA-256)
+
+### Django
+
+```python
+import hmac, hashlib, json
+from django.http import HttpResponse
+from django.views.decorators.csrf import csrf_exempt
+
+@csrf_exempt
+def mp_webhook(request):
+    signature = request.headers.get("X-MoneyPulse-Signature", "")
+    expected = hmac.new(
+        settings.MP_WEBHOOK_SECRET.encode(),
+        request.body, hashlib.sha256
+    ).hexdigest()
+    if not hmac.compare_digest(signature, expected):
+        return HttpResponse(status=401)
+
+    event = json.loads(request.body)
+    if event["type"] == "payment.success":
+        # fulfill order
+        pass
+    return HttpResponse(status=200)
+```
+
+### FastAPI
+
+```python
+from fastapi import FastAPI, Request, HTTPException
+import hmac, hashlib
+
+app = FastAPI()
+
+@app.post("/webhook")
+async def webhook(req: Request):
+    body = await req.body()
+    signature = req.headers.get("x-moneypulse-signature", "")
+    expected = hmac.new(SECRET.encode(), body, hashlib.sha256).hexdigest()
+    if not hmac.compare_digest(signature, expected):
+        raise HTTPException(401)
+    return {"received": True}
+```
+
+## Simulation mode
+
+```python
+result = client.payments.create(
+    amount=1000, currency="XOF", country="CI",
+    customer={"email": "t@t.com"},
+    simulate=True,  # no funds, no webhook, no billing
+)
+```
+
+## Error handling
+
+```python
+from moneypulse.client import MoneyPulseError
+
+try:
+    client.payments.create(...)
+except MoneyPulseError as e:
+    print(e.code, e.status_code, e)
+```
+
+## License
+
+MIT © NOCYL-PULSE

moneypulse-1.0.0/moneypulse/__init__.py

@@ -0,0 +1,4 @@
+from .client import MoneyPulseClient as Client
+
+__version__ = "1.0.0"
+__all__ = ["Client"]

moneypulse-1.0.0/moneypulse/client.py

@@ -0,0 +1,81 @@
+"""Money-Pulse Python SDK"""
+import requests
+from typing import Any, Dict, Optional
+
+
+class MoneyPulseError(Exception):
+    def __init__(self, message: str, code: str = "unknown", status_code: int = 0):
+        super().__init__(message)
+        self.code = code
+        self.status_code = status_code
+
+
+class _Resource:
+    def __init__(self, client: "MoneyPulseClient", prefix: str, create_prefix: str = None):
+        self._client = client
+        self._prefix = prefix
+        self._create_prefix = create_prefix or prefix
+
+    def create(self, **params) -> Dict[str, Any]:
+        return self._client._request("POST", self._create_prefix, json=params)
+
+    def retrieve(self, id: str) -> Dict[str, Any]:
+        return self._client._request("GET", f"{self._prefix}/{id}")
+
+    def verify(self, id: str) -> Dict[str, Any]:
+        return self._client._request("GET", f"{self._prefix}/{id}/verify")
+
+    def list(self, page: int = 1, limit: int = 20, **filters) -> Dict[str, Any]:
+        params = {"page": page, "limit": limit, **filters}
+        return self._client._request("GET", self._prefix, params=params)
+
+
+class _PaymentResource(_Resource):
+    def __init__(self, client: "MoneyPulseClient"):
+        super().__init__(client, "/api/v1/payments", "/api/v1/payments/initiate")
+
+
+class _PayoutResource(_Resource):
+    def __init__(self, client: "MoneyPulseClient"):
+        super().__init__(client, "/api/v1/payouts", "/api/v1/payouts/initiate")
+
+
+class MoneyPulseClient:
+    """
+    Official Money-Pulse Python client.
+
+    Usage:
+        import moneypulse
+        client = moneypulse.Client("mp_live_votre_cle_api")
+        payment = client.payments.create(
+            amount=10000, currency="XOF", country="CI",
+            customer={"email": "client@email.com"},
+            callback_url="https://your-site.com/webhook"
+        )
+    """
+
+    def __init__(self, api_key: str, base_url: str = "https://api.money-pulse.org"):
+        self._api_key = api_key
+        self._base_url = base_url.rstrip("/")
+        self._session = requests.Session()
+        self._session.headers.update({
+            "X-Api-Key": self._api_key,
+            "Content-Type": "application/json",
+            "X-SDK": "moneypulse-python/1.0.0",
+        })
+        self.payments = _PaymentResource(self)
+        self.payouts = _PayoutResource(self)
+
+    def _request(self, method: str, path: str, json: Optional[dict] = None, params: Optional[dict] = None) -> Dict[str, Any]:
+        url = f"{self._base_url}{path}"
+        response = self._session.request(method, url, json=json, params=params, timeout=30)
+
+        data = response.json()
+
+        if response.status_code >= 400:
+            error = data.get("error", {})
+            msg = error.get("message", str(error)) if isinstance(error, dict) else str(error)
+            code = error.get("code", "unknown") if isinstance(error, dict) else "unknown"
+            raise MoneyPulseError(msg, code, response.status_code)
+
+        return data.get("data", data)

moneypulse-1.0.0/moneypulse.egg-info/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: moneypulse
+Version: 1.0.0
+Summary: Official Money-Pulse Python SDK — Accept payments and process payouts across Africa.
+Home-page: https://github.com/nocyl-pulse/moneypulse-python
+Author: NOCYL-PULSE
+Author-email: NOCYL-PULSE <dev@money-pulse.org>
+License: MIT
+Project-URL: Homepage, https://money-pulse.org
+Project-URL: Repository, https://github.com/nocyl-pulse/moneypulse-python
+Project-URL: Issues, https://github.com/nocyl-pulse/moneypulse-python/issues
+Keywords: money-pulse,payments,africa,mobile-money,sdk
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python
+
+# moneypulse
+
+Official Python SDK for [Money-Pulse](https://money-pulse.org).
+
+## Installation
+
+```bash
+pip install moneypulse
+```
+
+## Quick start
+
+```python
+import moneypulse
+client = moneypulse.Client("mp_live_xxx")
+
+payment = client.payments.create(
+    amount=10000, currency="XOF", country="CI",
+    customer={"email": "client@email.com", "phone": "+22507000000"},
+    callback_url="https://your-site.com/webhook",
+)
+print(payment["checkout_url"])
+```
+
+## Payouts
+
+```python
+payout = client.payouts.create(
+    amount=50000, currency="XOF", country="CI",
+    recipient={"type": "mobile_money", "phone": "+22507000000", "name": "Jean Kouassi"},
+)
+```
+
+## Webhook verification (HMAC SHA-256)
+
+### Django
+
+```python
+import hmac, hashlib, json
+from django.http import HttpResponse
+from django.views.decorators.csrf import csrf_exempt
+
+@csrf_exempt
+def mp_webhook(request):
+    signature = request.headers.get("X-MoneyPulse-Signature", "")
+    expected = hmac.new(
+        settings.MP_WEBHOOK_SECRET.encode(),
+        request.body, hashlib.sha256
+    ).hexdigest()
+    if not hmac.compare_digest(signature, expected):
+        return HttpResponse(status=401)
+
+    event = json.loads(request.body)
+    if event["type"] == "payment.success":
+        # fulfill order
+        pass
+    return HttpResponse(status=200)
+```
+
+### FastAPI
+
+```python
+from fastapi import FastAPI, Request, HTTPException
+import hmac, hashlib
+
+app = FastAPI()
+
+@app.post("/webhook")
+async def webhook(req: Request):
+    body = await req.body()
+    signature = req.headers.get("x-moneypulse-signature", "")
+    expected = hmac.new(SECRET.encode(), body, hashlib.sha256).hexdigest()
+    if not hmac.compare_digest(signature, expected):
+        raise HTTPException(401)
+    return {"received": True}
+```
+
+## Simulation mode
+
+```python
+result = client.payments.create(
+    amount=1000, currency="XOF", country="CI",
+    customer={"email": "t@t.com"},
+    simulate=True,  # no funds, no webhook, no billing
+)
+```
+
+## Error handling
+
+```python
+from moneypulse.client import MoneyPulseError
+
+try:
+    client.payments.create(...)
+except MoneyPulseError as e:
+    print(e.code, e.status_code, e)
+```
+
+## License
+
+MIT © NOCYL-PULSE

moneypulse-1.0.0/moneypulse.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+setup.py
+moneypulse/__init__.py
+moneypulse/client.py
+moneypulse.egg-info/PKG-INFO
+moneypulse.egg-info/SOURCES.txt
+moneypulse.egg-info/dependency_links.txt
+moneypulse.egg-info/requires.txt
+moneypulse.egg-info/top_level.txt

moneypulse-1.0.0/moneypulse.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

moneypulse-1.0.0/moneypulse.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.0

moneypulse-1.0.0/moneypulse.egg-info/top_level.txt

@@ -0,0 +1 @@
+moneypulse

moneypulse-1.0.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "moneypulse"
+version = "1.0.0"
+description = "Official Money-Pulse Python SDK — Accept payments and process payouts across Africa."
+readme = "README.md"
+requires-python = ">=3.7"
+license = { text = "MIT" }
+authors = [{ name = "NOCYL-PULSE", email = "dev@money-pulse.org" }]
+keywords = ["money-pulse", "payments", "africa", "mobile-money", "sdk"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Topic :: Office/Business :: Financial",
+  "Intended Audience :: Developers",
+]
+dependencies = ["requests>=2.25.0"]
+
+[project.urls]
+Homepage = "https://money-pulse.org"
+Repository = "https://github.com/nocyl-pulse/moneypulse-python"
+Issues = "https://github.com/nocyl-pulse/moneypulse-python/issues"
+
+[tool.setuptools.packages.find]
+include = ["moneypulse*"]

moneypulse-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

moneypulse-1.0.0/setup.py

@@ -0,0 +1,20 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="moneypulse",
+    version="1.0.0",
+    description="Official Money-Pulse Python SDK — Accept payments and process payouts across Africa.",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    author="NOCYL-PULSE",
+    author_email="dev@money-pulse.org",
+    url="https://github.com/nocyl-pulse/moneypulse-python",
+    packages=find_packages(),
+    python_requires=">=3.7",
+    install_requires=["requests>=2.25.0"],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+)