pay-engine 0.1.0__tar.gz

pay_engine-0.1.0/LICENSE

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

pay_engine-0.1.0/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.5
+Name: pay-engine
+Version: 0.1.0
+Summary: All-in-one payment engine for Uzbekistan (Payme, Click, Uzum Bank) with one-liner links, Telegram buttons, and auto-charge.
+Project-URL: Homepage, https://github.com/developer/pay-engine
+Project-URL: Bug Tracker, https://github.com/developer/pay-engine/issues
+Author-email: Developer <dev@example.com>
+License: MIT
+License-File: LICENSE
+Keywords: aiogram,click,fastapi,fintech,payme,payment,telegram,uzbekistan,uzum
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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: Topic :: Office/Business :: Financial :: Point-Of-Sale
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.25.0
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.100.0; extra == 'fastapi'
+Provides-Extra: telegram
+Requires-Dist: aiogram>=3.0.0; extra == 'telegram'
+Description-Content-Type: text/markdown
+
+# 💳 pay-engine
+
+[![PyPI version](https://img.shields.io/badge/pypi-0.1.0-blue.svg)](https://pypi.org/project/pay-engine/)
+[![Python](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://pypi.org/project/pay-engine/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**pay-engine** — O'zbekistonning barcha asosiy to'lov tizimlarini (**Payme**, **Click**, **Uzum Bank**) birlashtiruvchi, bir qator kod bilan to'lov havolalari yaratish, Telegram bot tugmalari hosil qilish va avtomatik pul yechish (auto-charge) imkonini beruvchi zamonaviy Python kutubxonasi.
+
+---
+
+## 🚀 Imkoniyatlar (Features)
+
+- ⚡ **1 qatorlik to'lov havolalari:** Payme, Click va Uzum Bank uchun bir lahzada to'lov linklarini olish.
+- 🤖 **Telegram Botlar uchun tayyor klaviaturalar:** `aiogram` va boshqa botlar uchun tayyor `InlineKeyboardMarkup` tugmalari.
+- 🛡️ **Avtomatlashtirilgan Webhooklar:** FastAPI va boshqa freymvorklarda imzolarni tekshirish va JSON-RPC protokoli bilan bosh qotirmasdan, faqat `on_success(order_id, amount)` orqali pul tushganini qabul qilish.
+- 🔄 **Avtomatik yechish (Card Token / Auto-charge):** Karta tokeni orqali qayta SMS-kodsiz to'lov yechish (obunalar va Yandex Go kabi xizmatlar uchun).
+- 🧩 **Zero-boilerplate:** `.env` faylidan kalitlarni avtomatik o'qib olish.
+
+---
+
+## 📦 O'rnatish (Installation)
+
+```bash
+pip install pay-engine
+```
+
+FastAPI yoki Telegram bot integratsiyasi bilan birga o'rnatish uchun:
+```bash
+pip install "pay-engine[fastapi,telegram]"
+```
+
+---
+
+## ⚙️ Sozlash (.env)
+
+Loyihangizning `.env` fayliga kerakli to'lov tizimlari kalitlarini kiriting:
+
+```env
+# Payme
+PAYME_MERCHANT_ID=your_payme_merchant_id
+PAYME_SECRET_KEY=your_payme_secret_key
+PAYME_TEST_MODE=false
+
+# Click
+CLICK_SERVICE_ID=your_click_service_id
+CLICK_MERCHANT_ID=your_click_merchant_id
+CLICK_SECRET_KEY=your_click_secret_key
+CLICK_MERCHANT_USER_ID=your_click_user_id
+
+# Uzum Bank
+UZUM_SHOP_ID=your_uzum_shop_id
+UZUM_SECRET_KEY=your_uzum_secret_key
+```
+
+---
+
+## 📖 Foydalanish (Quickstart)
+
+### 1. To'lov havolasini olish (1 qatorda)
+
+```python
+from pay_engine import payme, click, uzum
+
+# Payme havolasi:
+payme_url = payme.link(amount=100_000, order_id="ORDER_123")
+
+# Click havolasi:
+click_url = click.link(amount=100_000, order_id="ORDER_123")
+
+# Uzum Bank havolasi:
+uzum_url = uzum.link(amount=100_000, order_id="ORDER_123")
+```
+
+---
+
+### 2. Telegram Botda to'lov tugmalarini chiqarish (aiogram)
+
+```python
+from aiogram import Bot, Dispatcher, types
+from pay_engine.integrations.telegram import payment_buttons
+
+bot = Bot(token="BOT_TOKEN")
+dp = Dispatcher()
+
+@dp.message(lambda msg: msg.text == "/tolov")
+async def pay_command(message: types.Message):
+    # Bir qatorda Payme, Click va Uzum tugmalarini yasaymiz:
+    keyboard = payment_buttons(
+        amount=75_000, 
+        order_id=message.from_user.id
+    )
+    
+    await message.answer(
+        "To'lov qilish uchun qulay tizimni tanlang:",
+        reply_markup=keyboard
+    )
+```
+
+---
+
+### 3. FastAPI da pul tushganini ushlash (Webhook)
+
+```python
+from fastapi import FastAPI
+from pay_engine.integrations.fastapi import pay_router
+
+app = FastAPI()
+
+# Pul muvaffaqiyatli tushganda bajariladigan funksiya:
+async def tolov_tasdiqlandi(order_id: str, amount: float):
+    print(f"✅ Pul to'landi: Buyurtma #{order_id}, Summa: {amount:,.0f} so'm")
+    # Bazangizda buyurtma statusini o'zgartiring
+
+# Bitta qatorda /payments/payme, /payments/click, /payments/uzum ulanadi:
+app.include_router(pay_router(on_success=tolov_tasdiqlandi))
+```
+
+---
+
+### 4. Avtomatik yechish (Card Token Auto-charge)
+
+Mijozning saqlangan karta tokeni orqali hisobidan avtomatik pul yechib olish:
+
+```python
+from pay_engine import payme
+
+result = payme.charge(
+    card_token="saved_card_token_abc123",
+    amount=50_000,
+    order_id="SUB_999",
+    description="Oylik obuna to'lovi"
+)
+
+if result.success:
+    print(f"Pul yechildi! Tranzaksiya ID: {result.transaction_id}")
+else:
+    print(f"Xatolik yuz berdi: {result.message}")
+```
+
+---
+
+## 🧪 Testlarni ishga tushirish
+
+```bash
+python -m unittest discover -s tests -p "test_*.py"
+```
+
+---
+
+## 📄 Litsenziya
+
+MIT License. Ochiq va bepul foydalanish mumkin!

pay_engine-0.1.0/README.md

@@ -0,0 +1,152 @@
+# 💳 pay-engine
+
+[![PyPI version](https://img.shields.io/badge/pypi-0.1.0-blue.svg)](https://pypi.org/project/pay-engine/)
+[![Python](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://pypi.org/project/pay-engine/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**pay-engine** — O'zbekistonning barcha asosiy to'lov tizimlarini (**Payme**, **Click**, **Uzum Bank**) birlashtiruvchi, bir qator kod bilan to'lov havolalari yaratish, Telegram bot tugmalari hosil qilish va avtomatik pul yechish (auto-charge) imkonini beruvchi zamonaviy Python kutubxonasi.
+
+---
+
+## 🚀 Imkoniyatlar (Features)
+
+- ⚡ **1 qatorlik to'lov havolalari:** Payme, Click va Uzum Bank uchun bir lahzada to'lov linklarini olish.
+- 🤖 **Telegram Botlar uchun tayyor klaviaturalar:** `aiogram` va boshqa botlar uchun tayyor `InlineKeyboardMarkup` tugmalari.
+- 🛡️ **Avtomatlashtirilgan Webhooklar:** FastAPI va boshqa freymvorklarda imzolarni tekshirish va JSON-RPC protokoli bilan bosh qotirmasdan, faqat `on_success(order_id, amount)` orqali pul tushganini qabul qilish.
+- 🔄 **Avtomatik yechish (Card Token / Auto-charge):** Karta tokeni orqali qayta SMS-kodsiz to'lov yechish (obunalar va Yandex Go kabi xizmatlar uchun).
+- 🧩 **Zero-boilerplate:** `.env` faylidan kalitlarni avtomatik o'qib olish.
+
+---
+
+## 📦 O'rnatish (Installation)
+
+```bash
+pip install pay-engine
+```
+
+FastAPI yoki Telegram bot integratsiyasi bilan birga o'rnatish uchun:
+```bash
+pip install "pay-engine[fastapi,telegram]"
+```
+
+---
+
+## ⚙️ Sozlash (.env)
+
+Loyihangizning `.env` fayliga kerakli to'lov tizimlari kalitlarini kiriting:
+
+```env
+# Payme
+PAYME_MERCHANT_ID=your_payme_merchant_id
+PAYME_SECRET_KEY=your_payme_secret_key
+PAYME_TEST_MODE=false
+
+# Click
+CLICK_SERVICE_ID=your_click_service_id
+CLICK_MERCHANT_ID=your_click_merchant_id
+CLICK_SECRET_KEY=your_click_secret_key
+CLICK_MERCHANT_USER_ID=your_click_user_id
+
+# Uzum Bank
+UZUM_SHOP_ID=your_uzum_shop_id
+UZUM_SECRET_KEY=your_uzum_secret_key
+```
+
+---
+
+## 📖 Foydalanish (Quickstart)
+
+### 1. To'lov havolasini olish (1 qatorda)
+
+```python
+from pay_engine import payme, click, uzum
+
+# Payme havolasi:
+payme_url = payme.link(amount=100_000, order_id="ORDER_123")
+
+# Click havolasi:
+click_url = click.link(amount=100_000, order_id="ORDER_123")
+
+# Uzum Bank havolasi:
+uzum_url = uzum.link(amount=100_000, order_id="ORDER_123")
+```
+
+---
+
+### 2. Telegram Botda to'lov tugmalarini chiqarish (aiogram)
+
+```python
+from aiogram import Bot, Dispatcher, types
+from pay_engine.integrations.telegram import payment_buttons
+
+bot = Bot(token="BOT_TOKEN")
+dp = Dispatcher()
+
+@dp.message(lambda msg: msg.text == "/tolov")
+async def pay_command(message: types.Message):
+    # Bir qatorda Payme, Click va Uzum tugmalarini yasaymiz:
+    keyboard = payment_buttons(
+        amount=75_000, 
+        order_id=message.from_user.id
+    )
+    
+    await message.answer(
+        "To'lov qilish uchun qulay tizimni tanlang:",
+        reply_markup=keyboard
+    )
+```
+
+---
+
+### 3. FastAPI da pul tushganini ushlash (Webhook)
+
+```python
+from fastapi import FastAPI
+from pay_engine.integrations.fastapi import pay_router
+
+app = FastAPI()
+
+# Pul muvaffaqiyatli tushganda bajariladigan funksiya:
+async def tolov_tasdiqlandi(order_id: str, amount: float):
+    print(f"✅ Pul to'landi: Buyurtma #{order_id}, Summa: {amount:,.0f} so'm")
+    # Bazangizda buyurtma statusini o'zgartiring
+
+# Bitta qatorda /payments/payme, /payments/click, /payments/uzum ulanadi:
+app.include_router(pay_router(on_success=tolov_tasdiqlandi))
+```
+
+---
+
+### 4. Avtomatik yechish (Card Token Auto-charge)
+
+Mijozning saqlangan karta tokeni orqali hisobidan avtomatik pul yechib olish:
+
+```python
+from pay_engine import payme
+
+result = payme.charge(
+    card_token="saved_card_token_abc123",
+    amount=50_000,
+    order_id="SUB_999",
+    description="Oylik obuna to'lovi"
+)
+
+if result.success:
+    print(f"Pul yechildi! Tranzaksiya ID: {result.transaction_id}")
+else:
+    print(f"Xatolik yuz berdi: {result.message}")
+```
+
+---
+
+## 🧪 Testlarni ishga tushirish
+
+```bash
+python -m unittest discover -s tests -p "test_*.py"
+```
+
+---
+
+## 📄 Litsenziya
+
+MIT License. Ochiq va bepul foydalanish mumkin!

pay_engine-0.1.0/pyproject.toml

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pay-engine"
+version = "0.1.0"
+authors = [
+  { name = "Developer", email = "dev@example.com" }
+]
+description = "All-in-one payment engine for Uzbekistan (Payme, Click, Uzum Bank) with one-liner links, Telegram buttons, and auto-charge."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+keywords = ["payme", "click", "uzum", "payment", "uzbekistan", "fintech", "fastapi", "telegram", "aiogram"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "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",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Office/Business :: Financial :: Point-Of-Sale",
+]
+dependencies = [
+    "httpx>=0.25.0",
+]
+
+[project.optional-dependencies]
+fastapi = [
+    "fastapi>=0.100.0",
+]
+telegram = [
+    "aiogram>=3.0.0",
+]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "build",
+    "twine",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/developer/pay-engine"
+"Bug Tracker" = "https://github.com/developer/pay-engine/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pay_engine"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/README.md",
+    "/LICENSE",
+    "/pyproject.toml",
+]
+

pay_engine-0.1.0/src/pay_engine/__init__.py

@@ -0,0 +1,168 @@
+"""
+pay-engine: All-in-one payment engine for Uzbekistan.
+Supports Payme, Click, and Uzum Bank with one-liners, Telegram buttons, and auto-charge.
+"""
+
+from typing import Any, Dict, List, Optional, Union
+
+from .core.config import ClickConfig, PaymeConfig, UzumConfig
+from .core.exceptions import (
+    CardTokenError,
+    ConfigurationError,
+    InvalidAmountError,
+    OrderNotFoundError,
+    PayEngineError,
+    SignatureVerificationError,
+)
+from .core.models import (
+    CardChargeRequest,
+    CardChargeResult,
+    PaymentRequest,
+    TransactionStatus,
+    WebhookResult,
+)
+from .providers.click.client import ClickClient
+from .providers.click.handler import ClickHandler
+from .providers.payme.client import PaymeClient
+from .providers.payme.handler import PaymeHandler
+from .providers.uzum.client import UzumClient
+from .providers.uzum.handler import UzumHandler
+
+__version__ = "0.1.0"
+
+
+class _PaymeProxy:
+    """Convenience helper for Payme one-liners."""
+
+    @staticmethod
+    def link(
+        amount: float,
+        order_id: Union[str, int],
+        return_url: Optional[str] = None,
+        merchant_id: Optional[str] = None,
+        test_mode: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> str:
+        client = PaymeClient(merchant_id=merchant_id, test_mode=test_mode)
+        return client.create_link(amount=amount, order_id=order_id, return_url=return_url, **kwargs)
+
+    @staticmethod
+    def charge(
+        card_token: str,
+        amount: float,
+        order_id: Union[str, int],
+        secret_key: Optional[str] = None,
+        description: Optional[str] = None,
+        **kwargs: Any,
+    ) -> CardChargeResult:
+        client = PaymeClient(secret_key=secret_key)
+        return client.charge_card(card_token=card_token, amount=amount, order_id=order_id, description=description, **kwargs)
+
+
+class _ClickProxy:
+    """Convenience helper for Click one-liners."""
+
+    @staticmethod
+    def link(
+        amount: float,
+        order_id: Union[str, int],
+        return_url: Optional[str] = None,
+        service_id: Optional[str] = None,
+        merchant_id: Optional[str] = None,
+        **kwargs: Any,
+    ) -> str:
+        client = ClickClient(service_id=service_id, merchant_id=merchant_id)
+        return client.create_link(amount=amount, order_id=order_id, return_url=return_url, **kwargs)
+
+    @staticmethod
+    def charge(
+        card_token: str,
+        amount: float,
+        order_id: Union[str, int],
+        service_id: Optional[str] = None,
+        secret_key: Optional[str] = None,
+        merchant_user_id: Optional[str] = None,
+        **kwargs: Any,
+    ) -> CardChargeResult:
+        client = ClickClient(service_id=service_id, secret_key=secret_key, merchant_user_id=merchant_user_id)
+        return client.charge_card(card_token=card_token, amount=amount, order_id=order_id, **kwargs)
+
+
+class _UzumProxy:
+    """Convenience helper for Uzum Bank one-liners."""
+
+    @staticmethod
+    def link(
+        amount: float,
+        order_id: Union[str, int],
+        return_url: Optional[str] = None,
+        shop_id: Optional[str] = None,
+        **kwargs: Any,
+    ) -> str:
+        client = UzumClient(shop_id=shop_id)
+        return client.create_link(amount=amount, order_id=order_id, return_url=return_url, **kwargs)
+
+
+class PayEngine:
+    """Unified master engine for payments."""
+
+    def __init__(
+        self,
+        payme_merchant_id: Optional[str] = None,
+        payme_secret_key: Optional[str] = None,
+        click_service_id: Optional[str] = None,
+        click_merchant_id: Optional[str] = None,
+        click_secret_key: Optional[str] = None,
+        uzum_shop_id: Optional[str] = None,
+        uzum_secret_key: Optional[str] = None,
+        test_mode: bool = False,
+    ):
+        self.payme = PaymeClient(merchant_id=payme_merchant_id, secret_key=payme_secret_key, test_mode=test_mode) if (payme_merchant_id or PaymeConfig().merchant_id) else None
+        self.click = ClickClient(service_id=click_service_id, merchant_id=click_merchant_id, secret_key=click_secret_key) if (click_service_id or ClickConfig().service_id) else None
+        self.uzum = UzumClient(shop_id=uzum_shop_id, secret_key=uzum_secret_key) if (uzum_shop_id or UzumConfig().shop_id) else None
+
+    def get_links(
+        self,
+        amount: float,
+        order_id: Union[str, int],
+        return_url: Optional[str] = None,
+    ) -> Dict[str, str]:
+        """Returns checkout URLs for all configured providers."""
+        links = {}
+        if self.payme:
+            links["payme"] = self.payme.create_link(amount=amount, order_id=order_id, return_url=return_url)
+        if self.click:
+            links["click"] = self.click.create_link(amount=amount, order_id=order_id, return_url=return_url)
+        if self.uzum:
+            links["uzum"] = self.uzum.create_link(amount=amount, order_id=order_id, return_url=return_url)
+        return links
+
+
+# Public helper instances
+payme = _PaymeProxy()
+click = _ClickProxy()
+uzum = _UzumProxy()
+
+__all__ = [
+    "PayEngine",
+    "payme",
+    "click",
+    "uzum",
+    "PaymeClient",
+    "PaymeHandler",
+    "ClickClient",
+    "ClickHandler",
+    "UzumClient",
+    "UzumHandler",
+    "PayEngineError",
+    "ConfigurationError",
+    "SignatureVerificationError",
+    "InvalidAmountError",
+    "OrderNotFoundError",
+    "CardTokenError",
+    "TransactionStatus",
+    "PaymentRequest",
+    "WebhookResult",
+    "CardChargeRequest",
+    "CardChargeResult",
+]

pay_engine-0.1.0/src/pay_engine/core/__init__.py

@@ -0,0 +1,35 @@
+"""Core module for pay-engine."""
+
+from .config import ClickConfig, PaymeConfig, UzumConfig
+from .exceptions import (
+    CardTokenError,
+    ConfigurationError,
+    InvalidAmountError,
+    OrderNotFoundError,
+    PayEngineError,
+    SignatureVerificationError,
+)
+from .models import (
+    CardChargeRequest,
+    CardChargeResult,
+    PaymentRequest,
+    TransactionStatus,
+    WebhookResult,
+)
+
+__all__ = [
+    "PayEngineError",
+    "ConfigurationError",
+    "SignatureVerificationError",
+    "InvalidAmountError",
+    "OrderNotFoundError",
+    "CardTokenError",
+    "TransactionStatus",
+    "PaymentRequest",
+    "WebhookResult",
+    "CardChargeRequest",
+    "CardChargeResult",
+    "PaymeConfig",
+    "ClickConfig",
+    "UzumConfig",
+]

pay_engine-0.1.0/src/pay_engine/core/config.py

@@ -0,0 +1,74 @@
+"""Configuration management for pay-engine."""
+
+import os
+from dataclasses import dataclass
+from typing import Optional
+
+
+def _load_env_file():
+    """Simple parser to load .env file if it exists, without needing python-dotenv."""
+    env_path = os.path.join(os.getcwd(), ".env")
+    if os.path.isfile(env_path):
+        try:
+            with open(env_path, "r", encoding="utf-8") as f:
+                for line in f:
+                    line = line.strip()
+                    if not line or line.startswith("#") or "=" not in line:
+                        continue
+                    key, val = line.split("=", 1)
+                    key = key.strip()
+                    val = val.strip().strip("'\"")
+                    if key not in os.environ:
+                        os.environ[key] = val
+        except Exception:
+            pass
+
+
+# Automatically attempt to load .env on module import
+_load_env_file()
+
+
+@dataclass
+class PaymeConfig:
+    merchant_id: Optional[str] = None
+    secret_key: Optional[str] = None
+    test_mode: bool = False
+
+    def __post_init__(self):
+        if not self.merchant_id:
+            self.merchant_id = os.getenv("PAYME_MERCHANT_ID")
+        if not self.secret_key:
+            self.secret_key = os.getenv("PAYME_SECRET_KEY")
+        test_env = os.getenv("PAYME_TEST_MODE", "").lower()
+        if test_env in ("1", "true", "yes"):
+            self.test_mode = True
+
+
+@dataclass
+class ClickConfig:
+    service_id: Optional[str] = None
+    merchant_id: Optional[str] = None
+    secret_key: Optional[str] = None
+    merchant_user_id: Optional[str] = None
+
+    def __post_init__(self):
+        if not self.service_id:
+            self.service_id = os.getenv("CLICK_SERVICE_ID")
+        if not self.merchant_id:
+            self.merchant_id = os.getenv("CLICK_MERCHANT_ID")
+        if not self.secret_key:
+            self.secret_key = os.getenv("CLICK_SECRET_KEY")
+        if not self.merchant_user_id:
+            self.merchant_user_id = os.getenv("CLICK_MERCHANT_USER_ID")
+
+
+@dataclass
+class UzumConfig:
+    shop_id: Optional[str] = None
+    secret_key: Optional[str] = None
+
+    def __post_init__(self):
+        if not self.shop_id:
+            self.shop_id = os.getenv("UZUM_SHOP_ID")
+        if not self.secret_key:
+            self.secret_key = os.getenv("UZUM_SECRET_KEY")