opensettle 0.1.0__tar.gz

opensettle-0.1.0/.gitignore

@@ -0,0 +1,19 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+build/
+dist/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.pyright_cache/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+.tox/
+.venv/
+.python-version
+uv.lock

opensettle-0.1.0/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+## 0.1.0 — 2026-05-12
+
+Initial release. Mirrors the surface area of the Node SDK
+(`@opensettle/sdk@0.2.0`).
+
+- Sync `OpenSettle` and async `AsyncOpenSettle` clients sharing a
+  single transport core.
+- 7 resources: customers, products, invoices, payments, subscriptions,
+  checkouts, webhook_endpoints.
+- Typed error hierarchy mirroring the API's 12 stable error codes.
+- HMAC-SHA256 signed-webhook verifier (`t=…,v1=…` scheme, constant-time
+  comparison, 300 s default tolerance).
+- Idempotent writes by default on money-adjacent routes.
+- Bounded retries with exponential backoff on 5xx, 429, and network
+  errors; `Retry-After` honored.
+- `py.typed` marker; passes `mypy --strict` and `pyright` strict.

opensettle-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenSettle
+
+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.

opensettle-0.1.0/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: opensettle
+Version: 0.1.0
+Summary: Official Python SDK for the OpenSettle API. Stablecoin billing on Base, Ethereum, Polygon, Arbitrum, Solana, and Tron.
+Project-URL: Homepage, https://opensettle.io
+Project-URL: Documentation, https://opensettle.io/docs/sdks
+Project-URL: Repository, https://github.com/OpenSettle/opensettle-sdk-python
+Project-URL: Issues, https://github.com/OpenSettle/opensettle-sdk-python/issues
+Project-URL: Changelog, https://github.com/OpenSettle/opensettle-sdk-python/blob/main/CHANGELOG.md
+Author-email: OpenSettle <support@opensettle.io>
+License: MIT License
+        
+        Copyright (c) 2026 OpenSettle
+        
+        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.
+License-File: LICENSE
+Keywords: billing,evm,non-custodial,opensettle,solana,stablecoin,subscriptions,tron,usdc,usdt
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: typing-extensions>=4.7; python_version < '3.11'
+Provides-Extra: dev
+Requires-Dist: freezegun>=1.5; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pyright>=1.1.370; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# opensettle
+
+Official Python SDK for the [OpenSettle](https://opensettle.io) API.
+
+Non-custodial stablecoin billing on Base, Ethereum, Polygon, Arbitrum,
+Solana and Tron. Typed end-to-end, sync **and** async, signed-webhook
+verifier included, idempotent writes by default.
+
+## Install
+
+```bash
+pip install opensettle
+```
+
+Requires Python 3.9+.
+
+## Quickstart
+
+```python
+from opensettle import OpenSettle
+
+os = OpenSettle(
+    api_key="sk_test_…",         # or os.environ["OPENSETTLE_KEY"]
+    workspace_id="ws_…",         # or os.environ["OPENSETTLE_WORKSPACE"]
+)
+
+customer = os.customers.create(email="ada@example.com")
+invoice = os.invoices.create(
+    customer_id=customer["id"],
+    amount_minor=19_900,
+    currency="USD",
+    chain="base",
+    token="USDC",
+    line_items=[
+        {"description": "Pro plan", "quantity": 1, "unit_amount_minor": 19_900}
+    ],
+)
+os.invoices.send(invoice["id"])
+```
+
+### Async
+
+```python
+import asyncio
+from opensettle import AsyncOpenSettle
+
+async def main() -> None:
+    async with AsyncOpenSettle(api_key="sk_test_…", workspace_id="ws_…") as os:
+        customer = await os.customers.create(email="ada@example.com")
+        print(customer["id"])
+
+asyncio.run(main())
+```
+
+### Webhooks
+
+```python
+from opensettle import verify_webhook, WebhookVerificationError
+
+@app.post("/webhooks/opensettle")
+async def handler(request):
+    raw = await request.body()
+    try:
+        event = verify_webhook(
+            raw_body=raw,
+            signature_header=request.headers.get("x-opensettle-signature"),
+            secret=os.environ["WHSEC"],
+        )
+    except WebhookVerificationError as e:
+        return Response(status=400, content=f"bad signature: {e.reason}")
+    # event.data is the decoded JSON; event.timestamp is the signed epoch
+    return Response(status=200)
+```
+
+### Error handling
+
+```python
+from opensettle import (
+    OpenSettle,
+    RateLimitError,
+    SettlementError,
+)
+
+try:
+    os.checkouts.create(...)
+except RateLimitError as e:
+    time.sleep(e.retry_after or 1)
+    retry()
+except SettlementError as e:
+    if e.code == "insufficient_confirmations":
+        wait_and_retry()
+```
+
+The full error hierarchy:
+
+```
+OpenSettleError
+├── InvalidRequestError
+├── InvalidStateTransitionError
+├── AuthenticationError
+├── ForbiddenError
+├── NotFoundError
+├── ConflictError
+├── RateLimitError              # carries `retry_after: float | None`
+├── SettlementError             # chain_reverted | insufficient_confirmations | signing_required
+├── StepUpRequiredError         # aal_required
+├── APIError                    # internal_error or forward-compat unknown codes
+└── NetworkError                # transport-layer / timeout
+```
+
+Every error carries `code`, `status`, `request_id`, and `param` so you
+can quote the request ID in support tickets.
+
+## Configuration
+
+```python
+os = OpenSettle(
+    api_key="sk_test_…",
+    workspace_id="ws_…",
+    base_url="https://api.opensettle.io",   # default; override for self-host
+    test_mode=None,                          # None | True | False env-assertion gate
+    timeout=30.0,                            # seconds; default 30s
+    max_network_retries=3,                   # 0 to disable retries
+)
+```
+
+`test_mode=True` refuses `sk_live_…` keys; `test_mode=False` refuses
+`sk_test_…`. Leave `None` to accept either and let the API decide.
+
+## Resources
+
+| Resource | Methods |
+|---|---|
+| `customers` | `list`, `retrieve`, `create`, `update`, `delete` |
+| `products` | `list`, `retrieve`, `create`, `update`, `list_prices`, `create_price`, `delete`, `delete_price` |
+| `invoices` | `list`, `retrieve`, `create`, `send`, `remind`, `void` |
+| `payments` | `list`, `retrieve`, `refund`, `refund_broadcast` |
+| `subscriptions` | `list`, `retrieve`, `create`, `pause`, `resume`, `cancel`, `change_plan` |
+| `checkouts` | `create`, `retrieve` |
+| `webhook_endpoints` | `list`, `retrieve`, `create`, `update`, `delete`, `rotate_secret`, `test` |
+
+## License
+
+MIT — see [LICENSE](LICENSE).

opensettle-0.1.0/README.md

@@ -0,0 +1,144 @@
+# opensettle
+
+Official Python SDK for the [OpenSettle](https://opensettle.io) API.
+
+Non-custodial stablecoin billing on Base, Ethereum, Polygon, Arbitrum,
+Solana and Tron. Typed end-to-end, sync **and** async, signed-webhook
+verifier included, idempotent writes by default.
+
+## Install
+
+```bash
+pip install opensettle
+```
+
+Requires Python 3.9+.
+
+## Quickstart
+
+```python
+from opensettle import OpenSettle
+
+os = OpenSettle(
+    api_key="sk_test_…",         # or os.environ["OPENSETTLE_KEY"]
+    workspace_id="ws_…",         # or os.environ["OPENSETTLE_WORKSPACE"]
+)
+
+customer = os.customers.create(email="ada@example.com")
+invoice = os.invoices.create(
+    customer_id=customer["id"],
+    amount_minor=19_900,
+    currency="USD",
+    chain="base",
+    token="USDC",
+    line_items=[
+        {"description": "Pro plan", "quantity": 1, "unit_amount_minor": 19_900}
+    ],
+)
+os.invoices.send(invoice["id"])
+```
+
+### Async
+
+```python
+import asyncio
+from opensettle import AsyncOpenSettle
+
+async def main() -> None:
+    async with AsyncOpenSettle(api_key="sk_test_…", workspace_id="ws_…") as os:
+        customer = await os.customers.create(email="ada@example.com")
+        print(customer["id"])
+
+asyncio.run(main())
+```
+
+### Webhooks
+
+```python
+from opensettle import verify_webhook, WebhookVerificationError
+
+@app.post("/webhooks/opensettle")
+async def handler(request):
+    raw = await request.body()
+    try:
+        event = verify_webhook(
+            raw_body=raw,
+            signature_header=request.headers.get("x-opensettle-signature"),
+            secret=os.environ["WHSEC"],
+        )
+    except WebhookVerificationError as e:
+        return Response(status=400, content=f"bad signature: {e.reason}")
+    # event.data is the decoded JSON; event.timestamp is the signed epoch
+    return Response(status=200)
+```
+
+### Error handling
+
+```python
+from opensettle import (
+    OpenSettle,
+    RateLimitError,
+    SettlementError,
+)
+
+try:
+    os.checkouts.create(...)
+except RateLimitError as e:
+    time.sleep(e.retry_after or 1)
+    retry()
+except SettlementError as e:
+    if e.code == "insufficient_confirmations":
+        wait_and_retry()
+```
+
+The full error hierarchy:
+
+```
+OpenSettleError
+├── InvalidRequestError
+├── InvalidStateTransitionError
+├── AuthenticationError
+├── ForbiddenError
+├── NotFoundError
+├── ConflictError
+├── RateLimitError              # carries `retry_after: float | None`
+├── SettlementError             # chain_reverted | insufficient_confirmations | signing_required
+├── StepUpRequiredError         # aal_required
+├── APIError                    # internal_error or forward-compat unknown codes
+└── NetworkError                # transport-layer / timeout
+```
+
+Every error carries `code`, `status`, `request_id`, and `param` so you
+can quote the request ID in support tickets.
+
+## Configuration
+
+```python
+os = OpenSettle(
+    api_key="sk_test_…",
+    workspace_id="ws_…",
+    base_url="https://api.opensettle.io",   # default; override for self-host
+    test_mode=None,                          # None | True | False env-assertion gate
+    timeout=30.0,                            # seconds; default 30s
+    max_network_retries=3,                   # 0 to disable retries
+)
+```
+
+`test_mode=True` refuses `sk_live_…` keys; `test_mode=False` refuses
+`sk_test_…`. Leave `None` to accept either and let the API decide.
+
+## Resources
+
+| Resource | Methods |
+|---|---|
+| `customers` | `list`, `retrieve`, `create`, `update`, `delete` |
+| `products` | `list`, `retrieve`, `create`, `update`, `list_prices`, `create_price`, `delete`, `delete_price` |
+| `invoices` | `list`, `retrieve`, `create`, `send`, `remind`, `void` |
+| `payments` | `list`, `retrieve`, `refund`, `refund_broadcast` |
+| `subscriptions` | `list`, `retrieve`, `create`, `pause`, `resume`, `cancel`, `change_plan` |
+| `checkouts` | `create`, `retrieve` |
+| `webhook_endpoints` | `list`, `retrieve`, `create`, `update`, `delete`, `rotate_secret`, `test` |
+
+## License
+
+MIT — see [LICENSE](LICENSE).

opensettle-0.1.0/pyproject.toml

@@ -0,0 +1,188 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "opensettle"
+version = "0.1.0"
+description = "Official Python SDK for the OpenSettle API. Stablecoin billing on Base, Ethereum, Polygon, Arbitrum, Solana, and Tron."
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.9"
+authors = [{ name = "OpenSettle", email = "support@opensettle.io" }]
+keywords = [
+  "opensettle",
+  "stablecoin",
+  "billing",
+  "subscriptions",
+  "usdc",
+  "usdt",
+  "evm",
+  "solana",
+  "tron",
+  "non-custodial",
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: Implementation :: CPython",
+  "Topic :: Office/Business :: Financial",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Typing :: Typed",
+]
+dependencies = [
+  "httpx>=0.27,<1",
+  "typing-extensions>=4.7; python_version < '3.11'",
+]
+
+[project.urls]
+Homepage = "https://opensettle.io"
+Documentation = "https://opensettle.io/docs/sdks"
+Repository = "https://github.com/OpenSettle/opensettle-sdk-python"
+Issues = "https://github.com/OpenSettle/opensettle-sdk-python/issues"
+Changelog = "https://github.com/OpenSettle/opensettle-sdk-python/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.0",
+  "pytest-asyncio>=0.23",
+  "pytest-cov>=5.0",
+  "respx>=0.21",
+  "freezegun>=1.5",
+  "mypy>=1.10",
+  "pyright>=1.1.370",
+  "ruff>=0.6",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/opensettle"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "/src",
+  "/tests",
+  "/README.md",
+  "/CHANGELOG.md",
+  "/LICENSE",
+  "/pyproject.toml",
+]
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+testpaths = ["tests"]
+addopts = [
+  "-ra",
+  "--strict-markers",
+  "--strict-config",
+]
+asyncio_mode = "auto"
+filterwarnings = [
+  "error",
+  "ignore::DeprecationWarning:respx.*",
+]
+
+[tool.coverage.run]
+branch = true
+source = ["opensettle"]
+
+[tool.coverage.report]
+show_missing = true
+exclude_lines = [
+  "pragma: no cover",
+  "raise NotImplementedError",
+  "if TYPE_CHECKING:",
+  "if typing.TYPE_CHECKING:",
+]
+
+[tool.ruff]
+target-version = "py39"
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+  "E",      # pycodestyle errors
+  "W",      # pycodestyle warnings
+  "F",      # pyflakes
+  "I",      # isort
+  "B",      # bugbear
+  "UP",     # pyupgrade
+  "SIM",    # simplify
+  "PT",     # pytest style
+  "RUF",    # ruff-specific
+  "TID",    # tidy imports
+  "PIE",    # misc lints
+  "PYI",    # stub files
+  "S",      # security
+]
+ignore = [
+  "E501",   # line length handled by formatter
+  "S101",   # asserts are fine in tests
+  "S311",   # standard-random is fine for idempotency-key fallback
+  "PT011",  # broad raises in parametrize — explicit message coverage instead
+  # 3.9-compat: keep ``Optional[X]`` / ``Union[X, Y]`` / ``Dict[…]`` forms.
+  # We have ``from __future__ import annotations`` everywhere so the
+  # modern syntax would work for *annotations*, but the SDK also uses
+  # these in non-annotation positions (``cast``, ``isinstance``-adjacent
+  # type aliases) and the matching industry practice from openai-python
+  # and anthropic-sdk is to ship the ``Optional[X]`` form for max reach.
+  "UP006",
+  "UP007",
+  "UP045",
+  # Relative imports between sibling private modules within the package
+  # are idiomatic and intended; ``from ._http import HttpClient`` is the
+  # right form, not ``from opensettle._http import HttpClient``.
+  "TID252",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["S", "B", "PT006", "PT007", "PT017", "SIM117"]
+"src/opensettle/types.py" = ["UP035"]
+"src/opensettle/resources/subscriptions.py" = ["UP035"]
+"src/opensettle/resources/webhook_endpoints.py" = ["UP035"]
+"src/opensettle/_errors.py" = ["UP035"]
+"src/opensettle/_webhooks.py" = ["UP035"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+[tool.mypy]
+# Source supports Python 3.9 at runtime (see ``requires-python`` and the
+# test suite running on 3.11). Static analysis runs against 3.10+ because
+# modern mypy dropped 3.9 type-check support; we still verify 3.9 runtime
+# behavior through the pytest matrix.
+python_version = "3.10"
+strict = true
+warn_unreachable = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+no_implicit_reexport = false
+show_error_codes = true
+files = ["src/opensettle"]
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+check_untyped_defs = true
+
+[tool.pyright]
+include = ["src/opensettle"]
+pythonVersion = "3.10"
+# Standard mode rather than strict: strict reports false positives on
+# our dynamic-JSON envelope-parsing path (every ``Any.get()`` becomes an
+# "Unknown" propagation error). The mypy --strict run is the primary
+# typecheck gate; pyright standard is the cross-checker.
+typeCheckingMode = "standard"
+reportMissingTypeStubs = false
+venvPath = "."
+venv = ".venv"

opensettle-0.1.0/src/opensettle/__init__.py

@@ -0,0 +1,54 @@
+"""Official Python SDK for the OpenSettle API.
+
+Public surface is intentionally narrow: the high-level clients
+(:class:`OpenSettle`, :class:`AsyncOpenSettle`), the typed error
+hierarchy, and the webhook verifier. Everything else is private and may
+change without a major-version bump.
+"""
+
+from __future__ import annotations
+
+from ._errors import (
+    APIError,
+    AuthenticationError,
+    ConflictError,
+    ErrorCode,
+    ForbiddenError,
+    InvalidRequestError,
+    InvalidStateTransitionError,
+    NetworkError,
+    NotFoundError,
+    OpenSettleError,
+    RateLimitError,
+    SettlementError,
+    StepUpRequiredError,
+)
+from ._version import SDK_VERSION
+from ._webhooks import (
+    VerifiedWebhook,
+    WebhookVerificationError,
+    verify_webhook,
+)
+from .client import AsyncOpenSettle, OpenSettle
+
+__all__ = [
+    "SDK_VERSION",
+    "APIError",
+    "AsyncOpenSettle",
+    "AuthenticationError",
+    "ConflictError",
+    "ErrorCode",
+    "ForbiddenError",
+    "InvalidRequestError",
+    "InvalidStateTransitionError",
+    "NetworkError",
+    "NotFoundError",
+    "OpenSettle",
+    "OpenSettleError",
+    "RateLimitError",
+    "SettlementError",
+    "StepUpRequiredError",
+    "VerifiedWebhook",
+    "WebhookVerificationError",
+    "verify_webhook",
+]