sapliyio-fintech 0.0.1__py3-none-any.whl → 1.0.0__py3-none-any.whl

sapliyio_fintech-1.0.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,12 @@
+sapliyio_fintech/__init__.py,sha256=2DAWNG-Os91u1vrGNmJ6SsYru-Nq4dW5hnWs75SeKF0,1281
+sapliyio_fintech/api_client.py,sha256=6sXWPBdncpVqG7nbxcGs17PHFedn7HBK-xma3mL8QQg,27833
+sapliyio_fintech/api_response.py,sha256=eMxw1mpmJcoGZ3gs9z6jM4oYoZ10Gjk333s9sKxGv7s,652
+sapliyio_fintech/configuration.py,sha256=AgiCC9O8t_KsTILlZwJtdlzpZRG9bbgWA4K4XUkSrDo,18232
+sapliyio_fintech/exceptions.py,sha256=F2KEnJprvuYOhB2EmIJqfH9aNl0sKlWx1kKR28QmzQY,6570
+sapliyio_fintech/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sapliyio_fintech/rest.py,sha256=3xE7tv1BVl1hZNNpp-3K7_lICVcU5X2HaTf_kPUz5EM,9689
+sapliyio_fintech-1.0.0.dist-info/licenses/LICENSE,sha256=B6WOalWo1F2oEzXNe12QKc57W58900MGSxQH6eHJPXY,1063
+sapliyio_fintech-1.0.0.dist-info/METADATA,sha256=LbTXHxv3H0g8CXqligguXxc5RRsW0uObf6REvk4VMRM,5870
+sapliyio_fintech-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+sapliyio_fintech-1.0.0.dist-info/top_level.txt,sha256=vfArSMzRxE7n6Ly1x0PSAvDNUCv-k93CY-8JLy9bc9k,17
+sapliyio_fintech-1.0.0.dist-info/RECORD,,

sapliyio_fintech-0.0.1.dist-info/METADATA

@@ -1,44 +0,0 @@
-Metadata-Version: 2.4
-Name: sapliyio-fintech
-Version: 0.0.1
-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: requests>=2.25.0
-Dynamic: license-file
-
-# Sapliy Fintech Python SDK
-
-Official Python SDK for the Sapliy Fintech Ecosystem.
-
-## Installation
-
-```bash
-pip install sapliy-fintech
-```
-
-## Usage
-
-```python
-from sapliy_fintech import FintechClient
-
-# Initialize the client
-client = FintechClient(api_key="your_api_key")
-
-# Example: Record a transaction
-response = client.ledger.record_transaction(
-    account_id="acc_123",
-    amount=1000,
-    currency="USD",
-    description="Coffee",
-    reference_id="ref_456"
-)
-
-print(response)
-```

sapliyio_fintech-0.0.1.dist-info/RECORD

@@ -1,6 +0,0 @@
-sapliyio_fintech/__init__.py,sha256=Fz7taHihBIRxNTDFd-Bw12a2peIpd1WBNFYVStHiZ9o,6280
-sapliyio_fintech-0.0.1.dist-info/licenses/LICENSE,sha256=B6WOalWo1F2oEzXNe12QKc57W58900MGSxQH6eHJPXY,1063
-sapliyio_fintech-0.0.1.dist-info/METADATA,sha256=dGAWk7BcqTcv-5TvJk9gFoBQrIj6RfOyKbhA5donqcU,1000
-sapliyio_fintech-0.0.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-sapliyio_fintech-0.0.1.dist-info/top_level.txt,sha256=vfArSMzRxE7n6Ly1x0PSAvDNUCv-k93CY-8JLy9bc9k,17
-sapliyio_fintech-0.0.1.dist-info/RECORD,,