moneypulse 1.0.0

Official Money-Pulse Python SDK — Accept payments and process payouts across Africa.

moneypulse

Official Python SDK for Money-Pulse.

Installation

pip install moneypulse

Quick start

import moneypulse
client = moneypulse.Client("mp_live_xxx")

payment = client.payments.create(
    amount=10000, currency="XOF", country="CI",
    customer={"email": "[e-mail]", "phone": "[phone]"},
    callback_url="https://your-site.com/webhook",
)
print(payment["checkout_url"])

Payouts

payout = client.payouts.create(
    amount=50000, currency="XOF", country="CI",
    recipient={"type": "mobile_money", "phone": "[phone]", "name": "Jean Kouassi"},
)

Webhook verification (HMAC SHA-256)

Django

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

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

result = client.payments.create(
    amount=1000, currency="XOF", country="CI",
    customer={"email": "[e-mail]"},
    simulate=True,  # no funds, no webhook, no billing
)

Error handling

from moneypulse.client import MoneyPulseError

try:
    client.payments.create(...)
except MoneyPulseError as e:
    print(e.code, e.status_code, e)

License

MIT © NOCYL-PULSE