ultraner 0.1.0__tar.gz

ultraner-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,17 @@
+name: publish
+on:
+  release:
+    types: [published]
+permissions:
+  id-token: write # OIDC, required for PyPI Trusted Publishing (no token needed)
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

ultraner-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hernatter Limited (Ultraner)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ultraner-0.1.0/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: ultraner
+Version: 0.1.0
+Summary: Ultraner Python SDK, one API for payments across Africa (mobile money, cards, PayPal, wallets).
+Project-URL: Homepage, https://ultraner.com/ai
+Project-URL: Documentation, https://ultraner.com/docs
+Project-URL: Source, https://github.com/ultraner/ultraner-python
+Author: Hernatter Limited
+License: MIT
+License-File: LICENSE
+Keywords: africa,airtel money,mobile money,mpesa,mtn momo,payments,paypal,stripe,ultraner
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# Ultraner Python SDK
+
+One API for payments across Africa: mobile money, cards, PayPal and wallets. Live in Tanzania and Rwanda, expanding across the continent.
+
+- Docs: https://ultraner.com/docs
+- OpenAPI: https://ultraner.com/openapi.json
+- For AI: https://ultraner.com/ai
+
+## Install
+
+```bash
+pip install ultraner
+```
+
+## Usage
+
+```python
+from ultraner import Ultraner
+
+client = Ultraner(api_key="sk_live_...")
+
+# Charge a mobile-money wallet
+payment = client.payments.create_mobile_money(
+    amount=5000,
+    currency="TZS",
+    provider="Vodacom",
+    accountNumber="255700000000",
+    externalId="order_1001",
+)
+
+# Poll status
+status = client.payments.get_status(payment["reference"])
+
+# Wallet, transactions
+client.wallet.get()
+client.transactions.list(page=1, limit=20)
+
+# Escrow
+escrow = client.escrow.create(amount=10000, currency="TZS", recipient="vendor@example.com")
+client.escrow.release(escrow["escrowCode"])
+
+# International payers
+client.paypal.create_order(amount=25, currency="USD")
+client.stripe.create_session(amount=2500, currency="usd")
+```
+
+Errors raise `ultraner.UltranerError` with `.status` and `.code`.
+
+## License
+
+MIT

ultraner-0.1.0/README.md

@@ -0,0 +1,51 @@
+# Ultraner Python SDK
+
+One API for payments across Africa: mobile money, cards, PayPal and wallets. Live in Tanzania and Rwanda, expanding across the continent.
+
+- Docs: https://ultraner.com/docs
+- OpenAPI: https://ultraner.com/openapi.json
+- For AI: https://ultraner.com/ai
+
+## Install
+
+```bash
+pip install ultraner
+```
+
+## Usage
+
+```python
+from ultraner import Ultraner
+
+client = Ultraner(api_key="sk_live_...")
+
+# Charge a mobile-money wallet
+payment = client.payments.create_mobile_money(
+    amount=5000,
+    currency="TZS",
+    provider="Vodacom",
+    accountNumber="255700000000",
+    externalId="order_1001",
+)
+
+# Poll status
+status = client.payments.get_status(payment["reference"])
+
+# Wallet, transactions
+client.wallet.get()
+client.transactions.list(page=1, limit=20)
+
+# Escrow
+escrow = client.escrow.create(amount=10000, currency="TZS", recipient="vendor@example.com")
+client.escrow.release(escrow["escrowCode"])
+
+# International payers
+client.paypal.create_order(amount=25, currency="USD")
+client.stripe.create_session(amount=2500, currency="usd")
+```
+
+Errors raise `ultraner.UltranerError` with `.status` and `.code`.
+
+## License
+
+MIT

ultraner-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ultraner"
+version = "0.1.0"
+description = "Ultraner Python SDK, one API for payments across Africa (mobile money, cards, PayPal, wallets)."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "Hernatter Limited" }]
+keywords = ["ultraner", "payments", "africa", "mobile money", "mpesa", "mtn momo", "airtel money", "stripe", "paypal"]
+dependencies = []
+
+[project.urls]
+Homepage = "https://ultraner.com/ai"
+Documentation = "https://ultraner.com/docs"
+Source = "https://github.com/ultraner/ultraner-python"
+
+[tool.hatch.build.targets.wheel]
+packages = ["ultraner"]

ultraner-0.1.0/ultraner/__init__.py

@@ -0,0 +1,127 @@
+"""
+Ultraner Python SDK
+One API for payments across Africa: mobile money, cards, PayPal, wallets.
+Docs: https://ultraner.com/docs  ·  Spec: https://ultraner.com/openapi.json
+"""
+
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.parse
+import urllib.request
+from typing import Any, Optional
+
+__version__ = "0.1.0"
+__all__ = ["Ultraner", "UltranerError"]
+
+
+class UltranerError(Exception):
+    def __init__(self, message: str, code: str = "ERROR", status: int = 0):
+        super().__init__(message)
+        self.message = message
+        self.code = code
+        self.status = status
+
+
+class _Resource:
+    def __init__(self, client: "Ultraner"):
+        self._c = client
+
+
+class _Payments(_Resource):
+    def create_mobile_money(self, **body: Any) -> dict:
+        return self._c.request("POST", "/v1/payments/express/mno", body)
+
+    def get_status(self, reference: str) -> dict:
+        return self._c.request("GET", f"/v1/payments/express/status/{urllib.parse.quote(reference)}")
+
+
+class _Disbursements(_Resource):
+    def create(self, **body: Any) -> dict:
+        return self._c.request("POST", "/v1/disbursements", body)
+
+
+class _Wallet(_Resource):
+    def get(self) -> dict:
+        return self._c.request("GET", "/v1/wallet")
+
+    def transfer(self, **body: Any) -> dict:
+        return self._c.request("POST", "/v1/transfer", body)
+
+
+class _Transactions(_Resource):
+    def list(self, page: Optional[int] = None, limit: Optional[int] = None) -> dict:
+        params = {k: v for k, v in {"page": page, "limit": limit}.items() if v is not None}
+        qs = ("?" + urllib.parse.urlencode(params)) if params else ""
+        return self._c.request("GET", f"/v1/transactions{qs}")
+
+
+class _Escrow(_Resource):
+    def create(self, **body: Any) -> dict:
+        return self._c.request("POST", "/v1/escrow", body)
+
+    def release(self, escrow_code: str) -> dict:
+        return self._c.request("POST", f"/v1/escrow/{urllib.parse.quote(escrow_code)}/release")
+
+    def list(self) -> dict:
+        return self._c.request("GET", "/v1/escrow")
+
+
+class _PayPal(_Resource):
+    def create_order(self, **body: Any) -> dict:
+        return self._c.request("POST", "/paypal/orders", body)
+
+    def capture_order(self, order_id: str) -> dict:
+        return self._c.request("POST", f"/paypal/orders/{urllib.parse.quote(order_id)}/capture")
+
+
+class _Stripe(_Resource):
+    def create_session(self, **body: Any) -> dict:
+        return self._c.request("POST", "/stripe/sessions", body)
+
+
+class Ultraner:
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = "https://api.ultraner.com",
+        timeout: float = 30.0,
+    ):
+        if not api_key:
+            raise ValueError("Ultraner: an API key is required.")
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.payments = _Payments(self)
+        self.disbursements = _Disbursements(self)
+        self.wallet = _Wallet(self)
+        self.transactions = _Transactions(self)
+        self.escrow = _Escrow(self)
+        self.paypal = _PayPal(self)
+        self.stripe = _Stripe(self)
+
+    def request(self, method: str, path: str, body: Optional[dict] = None) -> Any:
+        data = json.dumps(body).encode("utf-8") if body is not None else None
+        req = urllib.request.Request(
+            f"{self.base_url}{path}",
+            data=data,
+            method=method,
+            headers={
+                "Content-Type": "application/json",
+                "Authorization": f"Bearer {self.api_key}",
+            },
+        )
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as resp:
+                text = resp.read().decode("utf-8")
+                payload = json.loads(text) if text else {}
+                return payload.get("data", payload)
+        except urllib.error.HTTPError as e:
+            text = e.read().decode("utf-8") if e.fp else ""
+            payload = json.loads(text) if text else {}
+            raise UltranerError(
+                payload.get("message", "Request failed"),
+                payload.get("code", "ERROR"),
+                e.code,
+            ) from None