vexpay 0.1.0__tar.gz

vexpay-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+.venv/
+dist/
+__pycache__/
+.mypy_cache/
+.pytest_cache/
+*.egg-info/

vexpay-0.1.0/LICENSE

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

vexpay-0.1.0/PKG-INFO

@@ -0,0 +1,274 @@
+Metadata-Version: 2.5
+Name: vexpay
+Version: 0.1.0
+Summary: Official Python SDK for the VEXPay API — Venezuelan payments (Pago Móvil C2P, cards, débito inmediato), payouts, checkout sessions, and signed webhooks.
+Project-URL: Homepage, https://github.com/chuventures/vexpay-python
+Project-URL: Issues, https://github.com/chuventures/vexpay-python/issues
+Author: VEXPay
+License-Expression: MIT
+License-File: LICENSE
+Keywords: bolivares,c2p,pago movil,payments,sdk,venezuela,vexpay
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx<1,>=0.25
+Requires-Dist: pydantic<3,>=2.5
+Requires-Dist: typing-extensions>=4.7
+Description-Content-Type: text/markdown
+
+# VEXPay Python SDK
+
+The official Python library for the [VEXPay](https://vexwallet.co/vexpay) API: accept Venezuelan payments (Pago Móvil C2P, cards, débito inmediato), pay out to merchants, create checkout sessions, and verify signed webhooks.
+
+- Sync (`VexPay`) and async (`AsyncVexPay`) clients with the same methods
+- Typed Pydantic v2 models generated from the VEXPay OpenAPI contract
+- Safe retries: every `POST` carries an `Idempotency-Key`, so a retried charge never charges twice
+- Auto-pagination
+- Webhook signature verification with replay protection
+- Python 3.9+
+
+## Install
+
+```sh
+pip install vexpay
+```
+
+## Quickstart
+
+```python
+from vexpay import VexPay
+
+vexpay = VexPay()  # reads VEXPAY_API_KEY from the environment
+
+quote = vexpay.quotes.retrieve({"usdAmount": 25})
+print(f"$25 = Bs {quote.vesAmount} at BCV {quote.bcvRate}")
+```
+
+Keep your API key on the server. Use your test-mode key while you build; it runs against the sandbox provider. Request bodies and query parameters use the API's field names (`usdAmount`, `debtorBankCode`, …) — pass a `dict` or one of the models in `vexpay._generated.models`.
+
+## Collect a Pago Móvil C2P payment
+
+C2P is two steps: create an intent (the payer's bank sends them a token by SMS), then charge with the token your customer types in.
+
+```python
+from vexpay import VexPay
+
+vexpay = VexPay()
+
+payer = {
+    "usdAmount": 25,
+    "debtorId": "V12345678",
+    "debtorCellPhone": "584141234567",
+    "debtorBankCode": 102,
+}
+
+intent = vexpay.payments.c2p.request({**payer, "externalRef": "order-1042"})
+
+token = input("Bank token: ")  # the customer reads it from their bank SMS
+
+payment = vexpay.payments.c2p.execute({**payer, "intentId": intent.intentId, "token": token})
+print(payment.paymentId, payment.status)  # "COMPLETED" or "PENDING" — confirm with the payment.* webhook
+```
+
+## Checkout sessions (hosted or embedded)
+
+Let VEXPay collect the payment details. Redirect the buyer to `url`, or embed the checkout on your own site with [`@vexpay/js`](https://www.npmjs.com/package/@vexpay/js) and the one-time `clientSecret`.
+
+```python
+from vexpay import VexPay
+
+vexpay = VexPay()
+
+session = vexpay.checkout.sessions.create(
+    {
+        "amountUsd": 25,
+        "reference": "order-1042",
+        "description": "Pedido #1042",
+        "successUrl": "https://shop.example/gracias",
+        "metadata": {"orderId": "1042"},
+    }
+)
+print(session.url)  # redirect here, or send session.clientSecret to the browser (never log or store it)
+
+# Later — fulfil only after checking on the server:
+current = vexpay.checkout.sessions.retrieve(session.id)
+if current.status == "paid":
+    print("ship order 1042")
+```
+
+## Webhooks
+
+VEXPay signs every delivery with a `VexPay-Signature` header. Verify it with the **raw** request body — parsing and re-serializing JSON changes the bytes and breaks the signature (Flask: `request.get_data()`, Django: `request.body`, FastAPI: `await request.body()`).
+
+```python
+import os
+from typing import Optional
+
+from vexpay import PaymentEvent, SignatureVerificationError, Webhook
+
+
+def handle_webhook(raw_body: bytes, signature: Optional[str]) -> int:
+    """Framework-agnostic handler: returns the HTTP status to answer with."""
+    try:
+        event = Webhook.construct_event(raw_body, signature, os.environ["VEXPAY_WEBHOOK_SECRET"])
+    except SignatureVerificationError:
+        return 400
+
+    if isinstance(event, PaymentEvent) and event.event == "payment.completed":
+        data = event.data
+        reference = data.externalRef or (data.checkoutSession.reference if data.checkoutSession else None)
+        print("paid", data.paymentId, reference)
+    return 204
+```
+
+Deliveries older than 5 minutes are rejected as possible replays; pass `tolerance=` (seconds) to change that. Each delivery also carries a `VexPay-Event-Id` header you can use to deduplicate. In your own tests, sign fixtures with `Webhook.generate_test_header(payload, secret)`.
+
+## Errors
+
+Every error extends `VexPayError` and carries `status`, the API `code` (e.g. `insufficient_balance`), and the response `body`.
+
+```python
+from vexpay import ConflictError, InvalidRequestError, NotFoundError, VexPay, VexPayError
+
+vexpay = VexPay()
+
+try:
+    vexpay.payouts.create(
+        {
+            "merchantId": "4f0c6f1e-2b7d-4c1a-9e3f-5a6b7c8d9e0f",
+            "monto": "1523.40",
+            "concepto": "Liquidación semana 30",
+            "externalRef": "po_2026_30_maria",
+        }
+    )
+except InvalidRequestError as error:
+    print("fix the request:", error.code, error.message)
+except NotFoundError:
+    print("no such merchant")
+except ConflictError as error:
+    print("externalRef reused with a different payload", error.body)
+except VexPayError as error:
+    print(error.status, error.code, error.message)
+```
+
+| Class | When |
+|---|---|
+| `AuthenticationError` | 401 — missing or invalid API key |
+| `InvalidRequestError` | 400, 403, 410, 422 — fix the request |
+| `NotFoundError` | 404 |
+| `ConflictError` | 409 — e.g. `external_ref_conflict`, `idempotency_key_reused` |
+| `RateLimitError` | 429, after retries |
+| `APIError` | 5xx, after retries |
+| `APIConnectionError` / `APITimeoutError` | no HTTP answer, after retries |
+| `SignatureVerificationError` | a webhook did not verify |
+
+## Retries and idempotency
+
+The SDK retries connection errors, timeouts, `429`, `5xx`, and `409 idempotency_request_in_progress` up to `max_network_retries` times (default 2) with exponential backoff, honouring `Retry-After`. Every `POST` gets a random `Idempotency-Key` that stays the same across its retries. Supply your own to make retries safe across process restarts too:
+
+```python
+from vexpay import VexPay
+
+vexpay = VexPay(max_network_retries=3, timeout=20.0)
+
+quote = vexpay.quotes.retrieve({"usdAmount": 10}, timeout=5.0)
+session = vexpay.checkout.sessions.create(
+    {"amountUsd": 10, "reference": "order-1043"},
+    idempotency_key="order-1043-session",
+)
+print(quote.vesAmount, session.id)
+```
+
+## Pagination
+
+`list()` on payouts, merchants, and products returns the first page; iterate it to walk every item across pages:
+
+```python
+from vexpay import VexPay
+
+vexpay = VexPay()
+
+page = vexpay.merchants.list({"limit": 100})
+print(len(page.items), page.next_cursor)
+
+for merchant in vexpay.merchants.list({"status": "verified", "isActive": "true"}):
+    print(merchant.merchantId, merchant.name)
+
+recent = vexpay.payouts.list({"limit": 50}).to_list(limit=200)
+print(len(recent))
+```
+
+## Async
+
+`AsyncVexPay` has the same resources; await the calls, and use `async for` to paginate:
+
+```python
+import asyncio
+
+from vexpay import AsyncVexPay
+
+
+async def main() -> None:
+    async with AsyncVexPay() as vexpay:
+        banks = await vexpay.banks.list()
+        print(len(banks), "banks")
+
+        first_page = await vexpay.products.list({"limit": 10})
+        print(len(first_page.items))
+
+        async for payout in vexpay.payouts.list():
+            print(payout.payoutId, payout.status)
+
+
+asyncio.run(main())
+```
+
+## Configuration
+
+```python
+from vexpay import VexPay
+
+with VexPay(
+    api_key="sk_test_…",               # default: VEXPAY_API_KEY env var
+    base_url="http://localhost:3010",  # default: https://api.pay.vexwallet.co
+    timeout=30.0,
+    max_network_retries=2,
+) as vexpay:
+    print(len(vexpay.banks.list()), "banks")
+```
+
+Pass `http_client=httpx.Client(...)` (or `httpx.AsyncClient`) to control proxies, connection pooling, or instrumentation.
+
+## Resources
+
+| Namespace | Methods |
+|---|---|
+| `banks` | `list` |
+| `quotes` | `retrieve` |
+| `balance` | `retrieve` |
+| `payments` | `retrieve`, `retrieve_by_ref`, `reverse` |
+| `payments.c2p` | `request`, `execute` |
+| `payments.vpos` | `create` |
+| `payments.pago_movil` | `verify` |
+| `payments.debit` · `credit` · `operations` · `dispersals` · `change` | débito/crédito inmediato and disbursements (R4) |
+| `checkout.sessions` | `create`, `retrieve` |
+| `merchants` | `create`, `list`, `retrieve`, `retrieve_by_ref`, `update`, `delete`, `retrieve_balance`, `transfer`, `list_audit_events`, `start_verification`, `confirm_verification` |
+| `merchants.payout_methods` | `list`, `create`, `set_default`, `delete`, `start_verification`, `confirm_verification` |
+| `payouts` | `create`, `create_instant`, `create_batch`, `list`, `retrieve`, `retrieve_by_ref` |
+| `products` | `create`, `list`, `retrieve`, `update`, `delete`, `create_link`, `list_links` |
+| `payment_links` | `retrieve`, `update`, `delete` |
+| `tenant_payout_account` | `retrieve`, `upsert`, `create`, `start_verification`, `confirm_verification` |
+| `webhook_endpoints` | `create`, `list`, `update`, `delete`, `send_test` |
+| `Webhook` / `client.webhooks` | `construct_event`, `generate_test_header` (offline) |
+
+## License
+
+MIT

vexpay-0.1.0/README.md

@@ -0,0 +1,248 @@
+# VEXPay Python SDK
+
+The official Python library for the [VEXPay](https://vexwallet.co/vexpay) API: accept Venezuelan payments (Pago Móvil C2P, cards, débito inmediato), pay out to merchants, create checkout sessions, and verify signed webhooks.
+
+- Sync (`VexPay`) and async (`AsyncVexPay`) clients with the same methods
+- Typed Pydantic v2 models generated from the VEXPay OpenAPI contract
+- Safe retries: every `POST` carries an `Idempotency-Key`, so a retried charge never charges twice
+- Auto-pagination
+- Webhook signature verification with replay protection
+- Python 3.9+
+
+## Install
+
+```sh
+pip install vexpay
+```
+
+## Quickstart
+
+```python
+from vexpay import VexPay
+
+vexpay = VexPay()  # reads VEXPAY_API_KEY from the environment
+
+quote = vexpay.quotes.retrieve({"usdAmount": 25})
+print(f"$25 = Bs {quote.vesAmount} at BCV {quote.bcvRate}")
+```
+
+Keep your API key on the server. Use your test-mode key while you build; it runs against the sandbox provider. Request bodies and query parameters use the API's field names (`usdAmount`, `debtorBankCode`, …) — pass a `dict` or one of the models in `vexpay._generated.models`.
+
+## Collect a Pago Móvil C2P payment
+
+C2P is two steps: create an intent (the payer's bank sends them a token by SMS), then charge with the token your customer types in.
+
+```python
+from vexpay import VexPay
+
+vexpay = VexPay()
+
+payer = {
+    "usdAmount": 25,
+    "debtorId": "V12345678",
+    "debtorCellPhone": "584141234567",
+    "debtorBankCode": 102,
+}
+
+intent = vexpay.payments.c2p.request({**payer, "externalRef": "order-1042"})
+
+token = input("Bank token: ")  # the customer reads it from their bank SMS
+
+payment = vexpay.payments.c2p.execute({**payer, "intentId": intent.intentId, "token": token})
+print(payment.paymentId, payment.status)  # "COMPLETED" or "PENDING" — confirm with the payment.* webhook
+```
+
+## Checkout sessions (hosted or embedded)
+
+Let VEXPay collect the payment details. Redirect the buyer to `url`, or embed the checkout on your own site with [`@vexpay/js`](https://www.npmjs.com/package/@vexpay/js) and the one-time `clientSecret`.
+
+```python
+from vexpay import VexPay
+
+vexpay = VexPay()
+
+session = vexpay.checkout.sessions.create(
+    {
+        "amountUsd": 25,
+        "reference": "order-1042",
+        "description": "Pedido #1042",
+        "successUrl": "https://shop.example/gracias",
+        "metadata": {"orderId": "1042"},
+    }
+)
+print(session.url)  # redirect here, or send session.clientSecret to the browser (never log or store it)
+
+# Later — fulfil only after checking on the server:
+current = vexpay.checkout.sessions.retrieve(session.id)
+if current.status == "paid":
+    print("ship order 1042")
+```
+
+## Webhooks
+
+VEXPay signs every delivery with a `VexPay-Signature` header. Verify it with the **raw** request body — parsing and re-serializing JSON changes the bytes and breaks the signature (Flask: `request.get_data()`, Django: `request.body`, FastAPI: `await request.body()`).
+
+```python
+import os
+from typing import Optional
+
+from vexpay import PaymentEvent, SignatureVerificationError, Webhook
+
+
+def handle_webhook(raw_body: bytes, signature: Optional[str]) -> int:
+    """Framework-agnostic handler: returns the HTTP status to answer with."""
+    try:
+        event = Webhook.construct_event(raw_body, signature, os.environ["VEXPAY_WEBHOOK_SECRET"])
+    except SignatureVerificationError:
+        return 400
+
+    if isinstance(event, PaymentEvent) and event.event == "payment.completed":
+        data = event.data
+        reference = data.externalRef or (data.checkoutSession.reference if data.checkoutSession else None)
+        print("paid", data.paymentId, reference)
+    return 204
+```
+
+Deliveries older than 5 minutes are rejected as possible replays; pass `tolerance=` (seconds) to change that. Each delivery also carries a `VexPay-Event-Id` header you can use to deduplicate. In your own tests, sign fixtures with `Webhook.generate_test_header(payload, secret)`.
+
+## Errors
+
+Every error extends `VexPayError` and carries `status`, the API `code` (e.g. `insufficient_balance`), and the response `body`.
+
+```python
+from vexpay import ConflictError, InvalidRequestError, NotFoundError, VexPay, VexPayError
+
+vexpay = VexPay()
+
+try:
+    vexpay.payouts.create(
+        {
+            "merchantId": "4f0c6f1e-2b7d-4c1a-9e3f-5a6b7c8d9e0f",
+            "monto": "1523.40",
+            "concepto": "Liquidación semana 30",
+            "externalRef": "po_2026_30_maria",
+        }
+    )
+except InvalidRequestError as error:
+    print("fix the request:", error.code, error.message)
+except NotFoundError:
+    print("no such merchant")
+except ConflictError as error:
+    print("externalRef reused with a different payload", error.body)
+except VexPayError as error:
+    print(error.status, error.code, error.message)
+```
+
+| Class | When |
+|---|---|
+| `AuthenticationError` | 401 — missing or invalid API key |
+| `InvalidRequestError` | 400, 403, 410, 422 — fix the request |
+| `NotFoundError` | 404 |
+| `ConflictError` | 409 — e.g. `external_ref_conflict`, `idempotency_key_reused` |
+| `RateLimitError` | 429, after retries |
+| `APIError` | 5xx, after retries |
+| `APIConnectionError` / `APITimeoutError` | no HTTP answer, after retries |
+| `SignatureVerificationError` | a webhook did not verify |
+
+## Retries and idempotency
+
+The SDK retries connection errors, timeouts, `429`, `5xx`, and `409 idempotency_request_in_progress` up to `max_network_retries` times (default 2) with exponential backoff, honouring `Retry-After`. Every `POST` gets a random `Idempotency-Key` that stays the same across its retries. Supply your own to make retries safe across process restarts too:
+
+```python
+from vexpay import VexPay
+
+vexpay = VexPay(max_network_retries=3, timeout=20.0)
+
+quote = vexpay.quotes.retrieve({"usdAmount": 10}, timeout=5.0)
+session = vexpay.checkout.sessions.create(
+    {"amountUsd": 10, "reference": "order-1043"},
+    idempotency_key="order-1043-session",
+)
+print(quote.vesAmount, session.id)
+```
+
+## Pagination
+
+`list()` on payouts, merchants, and products returns the first page; iterate it to walk every item across pages:
+
+```python
+from vexpay import VexPay
+
+vexpay = VexPay()
+
+page = vexpay.merchants.list({"limit": 100})
+print(len(page.items), page.next_cursor)
+
+for merchant in vexpay.merchants.list({"status": "verified", "isActive": "true"}):
+    print(merchant.merchantId, merchant.name)
+
+recent = vexpay.payouts.list({"limit": 50}).to_list(limit=200)
+print(len(recent))
+```
+
+## Async
+
+`AsyncVexPay` has the same resources; await the calls, and use `async for` to paginate:
+
+```python
+import asyncio
+
+from vexpay import AsyncVexPay
+
+
+async def main() -> None:
+    async with AsyncVexPay() as vexpay:
+        banks = await vexpay.banks.list()
+        print(len(banks), "banks")
+
+        first_page = await vexpay.products.list({"limit": 10})
+        print(len(first_page.items))
+
+        async for payout in vexpay.payouts.list():
+            print(payout.payoutId, payout.status)
+
+
+asyncio.run(main())
+```
+
+## Configuration
+
+```python
+from vexpay import VexPay
+
+with VexPay(
+    api_key="sk_test_…",               # default: VEXPAY_API_KEY env var
+    base_url="http://localhost:3010",  # default: https://api.pay.vexwallet.co
+    timeout=30.0,
+    max_network_retries=2,
+) as vexpay:
+    print(len(vexpay.banks.list()), "banks")
+```
+
+Pass `http_client=httpx.Client(...)` (or `httpx.AsyncClient`) to control proxies, connection pooling, or instrumentation.
+
+## Resources
+
+| Namespace | Methods |
+|---|---|
+| `banks` | `list` |
+| `quotes` | `retrieve` |
+| `balance` | `retrieve` |
+| `payments` | `retrieve`, `retrieve_by_ref`, `reverse` |
+| `payments.c2p` | `request`, `execute` |
+| `payments.vpos` | `create` |
+| `payments.pago_movil` | `verify` |
+| `payments.debit` · `credit` · `operations` · `dispersals` · `change` | débito/crédito inmediato and disbursements (R4) |
+| `checkout.sessions` | `create`, `retrieve` |
+| `merchants` | `create`, `list`, `retrieve`, `retrieve_by_ref`, `update`, `delete`, `retrieve_balance`, `transfer`, `list_audit_events`, `start_verification`, `confirm_verification` |
+| `merchants.payout_methods` | `list`, `create`, `set_default`, `delete`, `start_verification`, `confirm_verification` |
+| `payouts` | `create`, `create_instant`, `create_batch`, `list`, `retrieve`, `retrieve_by_ref` |
+| `products` | `create`, `list`, `retrieve`, `update`, `delete`, `create_link`, `list_links` |
+| `payment_links` | `retrieve`, `update`, `delete` |
+| `tenant_payout_account` | `retrieve`, `upsert`, `create`, `start_verification`, `confirm_verification` |
+| `webhook_endpoints` | `create`, `list`, `update`, `delete`, `send_test` |
+| `Webhook` / `client.webhooks` | `construct_event`, `generate_test_header` (offline) |
+
+## License
+
+MIT

vexpay-0.1.0/pyproject.toml

@@ -0,0 +1,59 @@
+[build-system]
+requires = ["hatchling>=1.24"]
+build-backend = "hatchling.build"
+
+[project]
+name = "vexpay"
+version = "0.1.0"
+description = "Official Python SDK for the VEXPay API — Venezuelan payments (Pago Móvil C2P, cards, débito inmediato), payouts, checkout sessions, and signed webhooks."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+authors = [{ name = "VEXPay" }]
+keywords = ["vexpay", "venezuela", "payments", "pago movil", "c2p", "bolivares", "sdk"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "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",
+  "Typing :: Typed",
+]
+dependencies = [
+  "httpx>=0.25,<1",
+  "pydantic>=2.5,<3",
+  "typing-extensions>=4.7",
+]
+
+[project.urls]
+Homepage = "https://github.com/chuventures/vexpay-python"
+Issues = "https://github.com/chuventures/vexpay-python/issues"
+
+[dependency-groups]
+dev = [
+  "pytest>=8",
+  "pytest-asyncio>=0.23",
+  "mypy>=1.10",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/vexpay"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/vexpay", "README.md", "LICENSE", "pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+
+[tool.mypy]
+strict = true
+python_version = "3.9"
+files = ["src/vexpay"]
+plugins = ["pydantic.mypy"]

vexpay-0.1.0/src/vexpay/__init__.py

@@ -0,0 +1,58 @@
+"""Official Python SDK for the VEXPay API."""
+
+from ._client import AsyncVexPay, VexPay
+from ._core import DEFAULT_BASE_URL, RequestOptions
+from ._pagination import AsyncPage, SyncPage
+from ._errors import (
+    APIConnectionError,
+    APIError,
+    APITimeoutError,
+    AuthenticationError,
+    ConfigurationError,
+    ConflictError,
+    InvalidRequestError,
+    NotFoundError,
+    RateLimitError,
+    SignatureVerificationError,
+    VexPayError,
+)
+from ._version import __version__
+from ._webhooks import (
+    DEFAULT_TOLERANCE,
+    SIGNATURE_HEADER,
+    WEBHOOK_EVENT_NAMES,
+    GenericEvent,
+    PaymentEvent,
+    PaymentWebhookData,
+    Webhook,
+    WebhookEvent,
+)
+
+__all__ = [
+    "DEFAULT_TOLERANCE",
+    "GenericEvent",
+    "PaymentEvent",
+    "PaymentWebhookData",
+    "SIGNATURE_HEADER",
+    "WEBHOOK_EVENT_NAMES",
+    "Webhook",
+    "WebhookEvent",
+    "APIConnectionError",
+    "APIError",
+    "APITimeoutError",
+    "AsyncPage",
+    "AsyncVexPay",
+    "AuthenticationError",
+    "ConfigurationError",
+    "ConflictError",
+    "DEFAULT_BASE_URL",
+    "InvalidRequestError",
+    "NotFoundError",
+    "RateLimitError",
+    "RequestOptions",
+    "SignatureVerificationError",
+    "SyncPage",
+    "VexPay",
+    "VexPayError",
+    "__version__",
+]