sapliyio-fintech 0.0.1__tar.gz → 1.0.0__tar.gz

sapliyio_fintech-1.0.0/PKG-INFO

@@ -0,0 +1,254 @@
+Metadata-Version: 2.4
+Name: sapliyio-fintech
+Version: 1.0.0
+Summary: Official Sapliy Fintech Ecosystem SDK for Python
+Author-email: Sapliy <dev@sapliy.com>
+Project-URL: Homepage, https://github.com/Sapliy/fintech-ecosystem
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: urllib3<3.0.0,>=2.1.0
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: typing-extensions>=4.7.1
+Dynamic: license-file
+
+# sapliyio-fintech
+
+[![PyPI version](https://badge.fury.io/py/sapliyio-fintech.svg)](https://badge.fury.io/py/sapliyio-fintech)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Official Python SDK for the Sapliy Fintech Ecosystem. Build financial applications with a clean, Pythonic API.
+
+## Features
+
+- **Payments** — Create charges, handle refunds, manage payment lifecycle
+- **Wallets** — User balances and internal accounting
+- **Ledger** — Double-entry bookkeeping for high-integrity transactions
+- **Billing** — Subscriptions and recurring billing
+- **Connect** — Multi-tenant support and managed accounts
+- **Webhooks** — Event handling with signature verification
+- **Type Hints** — Full typing support for IDE autocomplete
+
+## Installation
+
+```bash
+pip install sapliyio-fintech
+```
+
+## Quick Start
+
+```python
+from sapliyio_fintech import FintechClient
+
+client = FintechClient(api_key="sk_test_...")
+
+# Create a payment
+payment = client.payments.create(
+    amount=2000,  # $20.00
+    currency="USD",
+    source_id="src_123",
+    description="Order #1234"
+)
+
+print(f"Payment created: {payment.id}")
+```
+
+## Configuration
+
+```python
+# Custom base URL (for self-hosted)
+client = FintechClient(
+    api_key="sk_test_...",
+    base_url="https://api.yourdomain.com"
+)
+
+# Custom timeout
+client = FintechClient(
+    api_key="sk_test_...",
+    timeout=30  # seconds
+)
+```
+
+## API Reference
+
+### Payments
+
+```python
+# Create a charge
+payment = client.payments.create(
+    amount=1000,
+    currency="USD",
+    source_id="src_123",
+    description="Coffee"
+)
+
+# Get payment details
+payment = client.payments.get("pay_123")
+
+# Refund a payment
+payment = client.payments.refund("pay_123", amount=500)  # partial refund
+```
+
+### Wallets
+
+```python
+# Create a wallet
+wallet = client.wallets.create(
+    name="User Wallet",
+    currency="USD"
+)
+
+# Get wallet balance
+wallet = client.wallets.get("wal_123")
+
+# Credit (add funds)
+wallet = client.wallets.credit(
+    wallet_id="wal_123",
+    amount=1000,
+    description="Deposit"
+)
+
+# Debit (withdraw funds)
+wallet = client.wallets.debit(
+    wallet_id="wal_123",
+    amount=500,
+    description="Purchase"
+)
+```
+
+### Ledger
+
+```python
+# Record a transaction
+response = client.ledger.record_transaction(
+    account_id="acc_123",
+    amount=1000,
+    currency="USD",
+    description="Payment received",
+    reference_id="ref_456"
+)
+
+# Get account details
+account = client.ledger.get_account("acc_123")
+print(f"Balance: {account.balance}")
+```
+
+### Billing
+
+```python
+# Create a subscription
+subscription = client.billing.create_subscription(
+    customer_id="cust_123",
+    plan_id="plan_monthly"
+)
+
+# Get subscription
+subscription = client.billing.get_subscription("sub_123")
+
+# Cancel subscription
+client.billing.cancel_subscription("sub_123")
+```
+
+## Webhook Handling
+
+### Flask Example
+
+```python
+from flask import Flask, request
+from sapliyio_fintech import FintechClient
+
+app = Flask(__name__)
+client = FintechClient(api_key="sk_test_...")
+
+@app.route("/webhooks", methods=["POST"])
+def webhook():
+    payload = request.data
+    signature = request.headers.get("X-Sapliy-Signature")
+    secret = "whsec_..."
+
+    try:
+        event = client.webhooks.construct_event(payload, signature, secret)
+    except ValueError:
+        return "Invalid signature", 400
+
+    if event.type == "payment.succeeded":
+        payment = event.data.object
+        # Handle successful payment
+    elif event.type == "payment.failed":
+        # Handle failed payment
+        pass
+
+    return {"received": True}
+```
+
+### Django Example
+
+```python
+from django.http import JsonResponse
+from django.views.decorators.csrf import csrf_exempt
+from sapliyio_fintech import FintechClient
+
+client = FintechClient(api_key="sk_test_...")
+
+@csrf_exempt
+def webhook_view(request):
+    payload = request.body
+    signature = request.headers.get("X-Sapliy-Signature")
+    secret = "whsec_..."
+
+    try:
+        event = client.webhooks.construct_event(payload, signature, secret)
+    except ValueError:
+        return JsonResponse({"error": "Invalid signature"}, status=400)
+
+    # Handle event
+    return JsonResponse({"received": True})
+```
+
+## Async Support
+
+```python
+import asyncio
+from sapliyio_fintech import AsyncFintechClient
+
+async def main():
+    client = AsyncFintechClient(api_key="sk_test_...")
+
+    payment = await client.payments.create(
+        amount=2000,
+        currency="USD",
+        source_id="src_123",
+        description="Async payment"
+    )
+
+    print(f"Payment: {payment.id}")
+
+asyncio.run(main())
+```
+
+## Error Handling
+
+```python
+from sapliyio_fintech.exceptions import FintechError, PaymentError
+
+try:
+    payment = client.payments.get("invalid_id")
+except PaymentError as e:
+    print(f"Payment error: {e.message}")
+except FintechError as e:
+    print(f"API error ({e.status_code}): {e.message}")
+```
+
+## Part of Sapliy Fintech Ecosystem
+
+- [fintech-ecosystem](https://github.com/Sapliy/fintech-ecosystem) — Core backend
+- [fintech-sdk-node](https://github.com/Sapliy/fintech-sdk-node) — Node.js SDK
+- [fintech-sdk-go](https://github.com/Sapliy/fintech-sdk-go) — Go SDK
+
+## License
+
+MIT © [Sapliy](https://github.com/sapliy)

sapliyio_fintech-1.0.0/README.md

@@ -0,0 +1,236 @@
+# sapliyio-fintech
+
+[![PyPI version](https://badge.fury.io/py/sapliyio-fintech.svg)](https://badge.fury.io/py/sapliyio-fintech)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Official Python SDK for the Sapliy Fintech Ecosystem. Build financial applications with a clean, Pythonic API.
+
+## Features
+
+- **Payments** — Create charges, handle refunds, manage payment lifecycle
+- **Wallets** — User balances and internal accounting
+- **Ledger** — Double-entry bookkeeping for high-integrity transactions
+- **Billing** — Subscriptions and recurring billing
+- **Connect** — Multi-tenant support and managed accounts
+- **Webhooks** — Event handling with signature verification
+- **Type Hints** — Full typing support for IDE autocomplete
+
+## Installation
+
+```bash
+pip install sapliyio-fintech
+```
+
+## Quick Start
+
+```python
+from sapliyio_fintech import FintechClient
+
+client = FintechClient(api_key="sk_test_...")
+
+# Create a payment
+payment = client.payments.create(
+    amount=2000,  # $20.00
+    currency="USD",
+    source_id="src_123",
+    description="Order #1234"
+)
+
+print(f"Payment created: {payment.id}")
+```
+
+## Configuration
+
+```python
+# Custom base URL (for self-hosted)
+client = FintechClient(
+    api_key="sk_test_...",
+    base_url="https://api.yourdomain.com"
+)
+
+# Custom timeout
+client = FintechClient(
+    api_key="sk_test_...",
+    timeout=30  # seconds
+)
+```
+
+## API Reference
+
+### Payments
+
+```python
+# Create a charge
+payment = client.payments.create(
+    amount=1000,
+    currency="USD",
+    source_id="src_123",
+    description="Coffee"
+)
+
+# Get payment details
+payment = client.payments.get("pay_123")
+
+# Refund a payment
+payment = client.payments.refund("pay_123", amount=500)  # partial refund
+```
+
+### Wallets
+
+```python
+# Create a wallet
+wallet = client.wallets.create(
+    name="User Wallet",
+    currency="USD"
+)
+
+# Get wallet balance
+wallet = client.wallets.get("wal_123")
+
+# Credit (add funds)
+wallet = client.wallets.credit(
+    wallet_id="wal_123",
+    amount=1000,
+    description="Deposit"
+)
+
+# Debit (withdraw funds)
+wallet = client.wallets.debit(
+    wallet_id="wal_123",
+    amount=500,
+    description="Purchase"
+)
+```
+
+### Ledger
+
+```python
+# Record a transaction
+response = client.ledger.record_transaction(
+    account_id="acc_123",
+    amount=1000,
+    currency="USD",
+    description="Payment received",
+    reference_id="ref_456"
+)
+
+# Get account details
+account = client.ledger.get_account("acc_123")
+print(f"Balance: {account.balance}")
+```
+
+### Billing
+
+```python
+# Create a subscription
+subscription = client.billing.create_subscription(
+    customer_id="cust_123",
+    plan_id="plan_monthly"
+)
+
+# Get subscription
+subscription = client.billing.get_subscription("sub_123")
+
+# Cancel subscription
+client.billing.cancel_subscription("sub_123")
+```
+
+## Webhook Handling
+
+### Flask Example
+
+```python
+from flask import Flask, request
+from sapliyio_fintech import FintechClient
+
+app = Flask(__name__)
+client = FintechClient(api_key="sk_test_...")
+
+@app.route("/webhooks", methods=["POST"])
+def webhook():
+    payload = request.data
+    signature = request.headers.get("X-Sapliy-Signature")
+    secret = "whsec_..."
+
+    try:
+        event = client.webhooks.construct_event(payload, signature, secret)
+    except ValueError:
+        return "Invalid signature", 400
+
+    if event.type == "payment.succeeded":
+        payment = event.data.object
+        # Handle successful payment
+    elif event.type == "payment.failed":
+        # Handle failed payment
+        pass
+
+    return {"received": True}
+```
+
+### Django Example
+
+```python
+from django.http import JsonResponse
+from django.views.decorators.csrf import csrf_exempt
+from sapliyio_fintech import FintechClient
+
+client = FintechClient(api_key="sk_test_...")
+
+@csrf_exempt
+def webhook_view(request):
+    payload = request.body
+    signature = request.headers.get("X-Sapliy-Signature")
+    secret = "whsec_..."
+
+    try:
+        event = client.webhooks.construct_event(payload, signature, secret)
+    except ValueError:
+        return JsonResponse({"error": "Invalid signature"}, status=400)
+
+    # Handle event
+    return JsonResponse({"received": True})
+```
+
+## Async Support
+
+```python
+import asyncio
+from sapliyio_fintech import AsyncFintechClient
+
+async def main():
+    client = AsyncFintechClient(api_key="sk_test_...")
+
+    payment = await client.payments.create(
+        amount=2000,
+        currency="USD",
+        source_id="src_123",
+        description="Async payment"
+    )
+
+    print(f"Payment: {payment.id}")
+
+asyncio.run(main())
+```
+
+## Error Handling
+
+```python
+from sapliyio_fintech.exceptions import FintechError, PaymentError
+
+try:
+    payment = client.payments.get("invalid_id")
+except PaymentError as e:
+    print(f"Payment error: {e.message}")
+except FintechError as e:
+    print(f"API error ({e.status_code}): {e.message}")
+```
+
+## Part of Sapliy Fintech Ecosystem
+
+- [fintech-ecosystem](https://github.com/Sapliy/fintech-ecosystem) — Core backend
+- [fintech-sdk-node](https://github.com/Sapliy/fintech-sdk-node) — Node.js SDK
+- [fintech-sdk-go](https://github.com/Sapliy/fintech-sdk-go) — Go SDK
+
+## License
+
+MIT © [Sapliy](https://github.com/sapliy)

{sapliyio_fintech-0.0.1 → sapliyio_fintech-1.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sapliyio-fintech"
-version = "0.0.1"
+version = "1.0.0"
 authors = [
   { name="Sapliy", email="dev@sapliy.com" },
 ]
@@ -17,8 +17,14 @@ classifiers = [
     "Operating System :: OS Independent",
 ]
 dependencies = [
-    "requests>=2.25.0",
+    "urllib3 >= 2.1.0, < 3.0.0",
+    "python-dateutil >= 2.8.2",
+    "pydantic >= 2.0.0",
+    "typing-extensions >= 4.7.1",
 ]
 
 [project.urls]
 "Homepage" = "https://github.com/Sapliy/fintech-ecosystem"
+
+[tool.setuptools]
+packages = ["sapliyio_fintech"]

sapliyio_fintech-1.0.0/sapliyio_fintech/__init__.py

@@ -0,0 +1,28 @@
+from .api_client import ApiClient
+from .configuration import Configuration
+from .api.auth_service_api import AuthServiceApi
+from .api.billing_service_api import BillingServiceApi
+from .api.ledger_service_api import LedgerServiceApi
+from .api.notification_service_api import NotificationServiceApi
+from .api.payment_service_api import PaymentServiceApi
+from .api.wallet_service_api import WalletServiceApi
+# form .api.flow_service_api import FlowServiceApi
+# from .api.zone_service_api import ZoneServiceApi
+
+class SapliyClient:
+    def __init__(self, api_key: str, base_url: str = "http://localhost:8080"):
+        self.configuration = Configuration(
+            host=base_url,
+        )
+        self.configuration.api_key['X-API-Key'] = api_key
+        
+        self.api_client = ApiClient(self.configuration)
+        
+        self.auth = AuthServiceApi(self.api_client)
+        self.billing = BillingServiceApi(self.api_client)
+        self.ledger = LedgerServiceApi(self.api_client)
+        self.notifications = NotificationServiceApi(self.api_client)
+        self.payments = PaymentServiceApi(self.api_client)
+        self.wallets = WalletServiceApi(self.api_client)
+        # self.flows = FlowServiceApi(self.api_client)
+        # self.zones = ZoneServiceApi(self.api_client)