paytechuz 0.1.3__py3-none-any.whl → 0.1.4__py3-none-any.whl

{paytechuz/core → core}/base.py

@@ -4,6 +4,7 @@ Base classes for payment gateways.
 from abc import ABC, abstractmethod
 from typing import Dict, Any, Optional, Union
 
+
 class BasePaymentGateway(ABC):
     """
     Base class for all payment gateways.
@@ -23,7 +24,12 @@ class BasePaymentGateway(ABC):
         self.is_test_mode = is_test_mode
 
     @abstractmethod
-    def create_payment(self, amount: Union[int, float, str], account_id: Union[int, str], **kwargs) -> Dict[str, Any]:
+    def create_payment(
+        self,
+        amount: Union[int, float, str],
+        account_id: Union[int, str],
+        **kwargs
+    ) -> Dict[str, Any]:
         """
         Create a payment.
 
@@ -51,7 +57,11 @@ class BasePaymentGateway(ABC):
         raise NotImplementedError
 
     @abstractmethod
-    def cancel_payment(self, transaction_id: str, reason: Optional[str] = None) -> Dict[str, Any]:
+    def cancel_payment(
+        self,
+        transaction_id: str,
+        reason: Optional[str] = None
+    ) -> Dict[str, Any]:
         """
         Cancel payment.
 
@@ -65,7 +75,6 @@ class BasePaymentGateway(ABC):
         raise NotImplementedError
 
 
-
 class BaseWebhookHandler(ABC):
     """
     Base class for payment gateway webhook handlers.

gateways/payme/client.py

@@ -0,0 +1,262 @@
+"""
+Payme payment gateway client.
+"""
+import logging
+from typing import Dict, Any, Optional, Union
+import base64
+
+from paytechuz.core.base import BasePaymentGateway
+from paytechuz.core.http import HttpClient
+from paytechuz.core.constants import PaymeNetworks
+from paytechuz.core.utils import format_amount, handle_exceptions
+from paytechuz.gateways.payme.cards import PaymeCards
+from paytechuz.gateways.payme.receipts import PaymeReceipts
+
+logger = logging.getLogger(__name__)
+
+
+class PaymeGateway(BasePaymentGateway):
+    """
+    Payme payment gateway implementation.
+
+    This class provides methods for interacting with the Payme payment gateway,
+    including creating payments, checking payment status, and canceling payments.
+    """
+
+    def __init__(
+        self,
+        payme_id: str,
+        payme_key: Optional[str] = None,
+        fallback_id: Optional[str] = None,
+        is_test_mode: bool = False
+    ):
+        """
+        Initialize the Payme gateway.
+
+        Args:
+            payme_id: Payme merchant ID
+            payme_key: Payme merchant key for authentication
+            fallback_id: Fallback merchant ID
+            is_test_mode: Whether to use the test environment
+        """
+        super().__init__(is_test_mode)
+        self.payme_id = payme_id
+        self.payme_key = payme_key
+        self.fallback_id = fallback_id
+
+        # Set the API URL based on the environment
+        url = PaymeNetworks.TEST_NET if is_test_mode else PaymeNetworks.PROD_NET
+
+        # Initialize HTTP client
+        self.http_client = HttpClient(base_url=url)
+
+        # Initialize components
+        self.cards = PaymeCards(http_client=self.http_client, payme_id=payme_id)
+        self.receipts = PaymeReceipts(
+            http_client=self.http_client,
+            payme_id=payme_id,
+            payme_key=payme_key
+        )
+
+    def generate_pay_link(
+        self,
+        id: Union[int, str],
+        amount: Union[int, float, str],
+        return_url: str,
+        account_field_name: str = "order_id"
+    ) -> str:
+        """
+        Generate a payment link for a specific order.
+
+        Parameters
+        ----------
+        id : Union[int, str]
+            Unique identifier for the account/order.
+        amount : Union[int, float, str]
+            Payment amount in som.
+        return_url : str
+            URL to redirect after payment completion.
+        account_field_name : str, optional
+            Field name for account identifier (default: "order_id").
+
+        Returns
+        -------
+        str
+            Payme checkout URL with encoded parameters.
+
+        References
+        ----------
+        https://developer.help.paycom.uz/initsializatsiya-platezhey/
+        """
+        # Convert amount to tiyin (1 som = 100 tiyin)
+        amount_tiyin = int(float(amount) * 100)
+
+        # Build parameters
+        params = (
+            f'm={self.payme_id};'
+            f'ac.{account_field_name}={id};'
+            f'a={amount_tiyin};'
+            f'c={return_url}'
+        )
+        encoded_params = base64.b64encode(params.encode("utf-8")).decode("utf-8")
+
+        # Return URL based on environment
+        base_url = "https://test.paycom.uz" if self.is_test_mode else "https://checkout.paycom.uz"
+        return f"{base_url}/{encoded_params}"
+
+    async def generate_pay_link_async(
+        self,
+        id: Union[int, str],
+        amount: Union[int, float, str],
+        return_url: str,
+        account_field_name: str = "order_id"
+    ) -> str:
+        """
+        Async version of generate_pay_link.
+
+        Parameters
+        ----------
+        id : Union[int, str]
+            Unique identifier for the account/order.
+        amount : Union[int, float, str]
+            Payment amount in som.
+        return_url : str
+            URL to redirect after payment completion.
+        account_field_name : str, optional
+            Field name for account identifier (default: "order_id").
+
+        Returns
+        -------
+        str
+            Payme checkout URL with encoded parameters.
+        """
+        return self.generate_pay_link(
+            id=id,
+            amount=amount,
+            return_url=return_url,
+            account_field_name=account_field_name
+        )
+
+    @handle_exceptions
+    def create_payment(
+        self,
+        id: Union[int, str],
+        amount: Union[int, float, str],
+        return_url: str = "",
+        account_field_name: str = "order_id"
+    ) -> str:
+        """
+        Create a payment using Payme.
+
+        Args:
+            amount: Payment amount in som
+            account_id: Account or order ID
+            return_url: Return URL after payment (default: "")
+            account_field_name: Field name for account ID (default: "order_id")
+
+        Returns:
+            str: Payme payment URL
+        """
+        return self.generate_pay_link(
+            id=id,
+            amount=amount,
+            return_url=return_url,
+            account_field_name=account_field_name
+        )
+
+    @handle_exceptions
+    async def create_payment_async(
+        self,
+        id: Union[int, str],
+        amount: Union[int, float, str],
+        return_url: str = "",
+        account_field_name: str = "order_id"
+    ) -> str:
+        """
+        Async version of create_payment.
+
+        Args:
+            amount: Payment amount in som
+            account_id: Account or order ID
+            return_url: Return URL after payment (default: "")
+            account_field_name: Field name for account ID (default: "order_id")
+
+        Returns:
+            str: Payme payment URL
+        """
+        return await self.generate_pay_link_async(
+            id=id,
+            amount=amount,
+            return_url=return_url,
+            account_field_name=account_field_name
+        )
+
+    @handle_exceptions
+    def check_payment(self, transaction_id: str) -> Dict[str, Any]:
+        """
+        Check payment status using Payme receipts.
+
+        Args:
+            transaction_id: The receipt ID to check
+
+        Returns:
+            Dict containing payment status and details
+        """
+        receipt_data = self.receipts.check(receipt_id=transaction_id)
+
+        # Extract receipt status
+        receipt = receipt_data.get('receipt', {})
+        status = receipt.get('state')
+
+        # Map Payme status to our status
+        status_mapping = {
+            0: 'created',
+            1: 'waiting',
+            2: 'paid',
+            3: 'cancelled',
+            4: 'refunded'
+        }
+
+        mapped_status = status_mapping.get(status, 'unknown')
+
+        return {
+            'transaction_id': transaction_id,
+            'status': mapped_status,
+            'amount': receipt.get('amount') / 100,  # Convert from tiyin to som
+            'paid_at': receipt.get('pay_time'),
+            'created_at': receipt.get('create_time'),
+            'cancelled_at': receipt.get('cancel_time'),
+            'raw_response': receipt_data
+        }
+
+    @handle_exceptions
+    def cancel_payment(
+        self,
+        transaction_id: str,
+        reason: Optional[str] = None
+    ) -> Dict[str, Any]:
+        """
+        Cancel payment using Payme receipts.
+
+        Args:
+            transaction_id: The receipt ID to cancel
+            reason: Optional reason for cancellation
+
+        Returns:
+            Dict containing cancellation status and details
+        """
+        receipt_data = self.receipts.cancel(
+            receipt_id=transaction_id,
+            reason=reason or "Cancelled by merchant"
+        )
+
+        # Extract receipt status
+        receipt = receipt_data.get('receipt', {})
+        status = receipt.get('state')
+
+        return {
+            'transaction_id': transaction_id,
+            'status': 'cancelled' if status == 3 else 'unknown',
+            'cancelled_at': receipt.get('cancel_time'),
+            'raw_response': receipt_data
+        }

paytechuz-0.1.4.dist-info/METADATA

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: paytechuz
+Version: 0.1.4
+Summary: Unified Python package for Uzbekistan payment gateways
+Home-page: https://github.com/Muhammadali-Akbarov/paytechuz
+Author: Muhammadali Akbarov
+Author-email: muhammadali17abc@gmail.com
+License: MIT
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: home-page
+Dynamic: requires-python
+
+# PayTechUZ
+
+[![PyPI version](https://badge.fury.io/py/paytechuz.svg)](https://badge.fury.io/py/paytechuz)
+[![Python Versions](https://img.shields.io/pypi/pyversions/paytechuz.svg)](https://pypi.org/project/paytechuz/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+## Installation
+
+### Basic Installation
+
+```bash
+pip install paytechuz
+```
+
+### Framework-Specific Installation
+
+```bash
+# For Django
+pip install paytechuz[django]
+
+# For FastAPI
+pip install paytechuz[fastapi]
+```
+
+## Quick Start
+
+### Generate Payment Links
+
+```python
+from paytechuz.gateways.payme import PaymeGateway
+from paytechuz.gateways.click import ClickGateway
+
+# Initialize gateways
+payme = PaymeGateway()
+click = ClickGateway()
+
+# Generate payment links
+payme_link = payme.generate_payment_link(
+    id="order_123",
+    amount=150000,  # amount in UZS
+    return_url="https://example.com/return"
+)
+
+click_link = click.generate_payment_link(
+    id="order_123",
+    amount=150000,  # amount in UZS
+    return_url="https://example.com/return"
+)
+```
+
+### Django Integration
+
+1. Add to `INSTALLED_APPS`:
+
+```python
+# settings.py
+INSTALLED_APPS = [
+    # ...
+    'paytechuz.integrations.django',
+]
+
+PAYME_ID = 'your_payme_merchant_id'
+PAYME_KEY = 'your_payme_merchant_key'
+PAYME_ACCOUNT_MODEL = 'your_app.models.YourModel'  # For example: 'orders.models.Order'
+PAYME_ACCOUNT_FIELD = 'id'
+PAYME_AMOUNT_FIELD = 'amount'  # Field for storing payment amount
+PAYME_ONE_TIME_PAYMENT = True  # Allow only one payment per account
+
+CLICK_SERVICE_ID = 'your_click_service_id'
+CLICK_MERCHANT_ID = 'your_click_merchant_id'
+CLICK_SECRET_KEY = 'your_click_secret_key'
+CLICK_ACCOUNT_MODEL = 'your_app.models.YourModel'
+CLICK_COMMISSION_PERCENT = 0.0
+```
+
+2. Create webhook handlers:
+
+```python
+# views.py
+from paytechuz.integrations.django.views import PaymeWebhookView
+from .models import Order
+
+class PaymeWebhookView(PaymeWebhookView):
+    def successfully_payment(self, params, transaction):
+        order = Order.objects.get(id=transaction.account_id)
+        order.status = 'paid'
+        order.save()
+        
+    def cancelled_payment(self, params, transaction):
+        order = Order.objects.get(id=transaction.account_id)
+        order.status = 'cancelled'
+        order.save()
+```
+
+### FastAPI Integration
+
+1. Create webhook handler:
+
+```python
+from fastapi import FastAPI, Request
+from paytechuz.integrations.fastapi import PaymeWebhookHandler
+
+app = FastAPI()
+
+class CustomPaymeWebhookHandler(PaymeWebhookHandler):
+    def successfully_payment(self, params, transaction):
+        # Handle successful payment
+        order = self.db.query(Order).filter(Order.id == transaction.account_id).first()
+        order.status = "paid"
+        self.db.commit()
+
+    def cancelled_payment(self, params, transaction):
+        # Handle cancelled payment
+        order = self.db.query(Order).filter(Order.id == transaction.account_id).first()
+        order.status = "cancelled"
+        self.db.commit()
+
+@app.post("/payments/payme/webhook")
+async def payme_webhook(request: Request):
+    handler = CustomPaymeWebhookHandler(
+        payme_id="your_merchant_id",
+        payme_key="your_merchant_key"
+    )
+    return await handler.handle_webhook(request)
+```
+
+## Documentation
+
+Detailed documentation is available in multiple languages:
+
+- 📖 [English Documentation](docs/en/index.md)
+- 📖 [O'zbek tilidagi hujjatlar](docs/uz/index.md)

paytechuz-0.1.4.dist-info/RECORD

@@ -0,0 +1,35 @@
+core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+core/base.py,sha256=pW_0QrlyX0F8XVToeeDEI78ygAF2IgvvvyUGYMHH9bs,2565
+core/constants.py,sha256=P2zeZ_cfZIttdC1vqkpIngkfRFh6loWzJYEgzQb5cKA,1660
+core/exceptions.py,sha256=XMJkqiponTkvhjoh3S2iFNuU3UbBdFW4130kd0hpudg,5489
+core/http.py,sha256=qmLR6ujxmIPjwoTS4vvKRIvDnNcpl84sS1HmVB890b0,7686
+core/utils.py,sha256=ETHMzwu7_dirc-QfBUjpSTQmyS6_vBiNq97Dq9CNZto,4718
+core/payme/errors.py,sha256=CZE62MbYDMsRfNIX23Syt6of_tPMMGLnXhYMii4hw3A,542
+gateways/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gateways/click/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gateways/click/client.py,sha256=XTri3iogq4_MgvZehBK2CScVCMubvg1GNXV9whGAS6I,6663
+gateways/click/merchant.py,sha256=vJ_DivA1KfRT5p3sfA5yZGMYXoUmVbAM7QHvaXr6VCU,7254
+gateways/click/webhook.py,sha256=rph-NmjjnBKMW4rcxQTXrHHdK-uMrU39kXnbqK56leo,7936
+gateways/payme/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gateways/payme/cards.py,sha256=aL6su_ZTCBPU8qmrz2Jcw_Wn7Zf9RwIu8k10o4AWFTs,5420
+gateways/payme/client.py,sha256=B4jxjX_7J_uR-NP8-B6wO_VrnwO_RRh1ATiKsO4ZinM,7855
+gateways/payme/receipts.py,sha256=DdrZMPeDvQmGyqAEOTmtUorfcIVVb3t2tg31l7TXqHo,8904
+gateways/payme/webhook.py,sha256=-0O8vzMtiu4U8FWFKDA6EfyoX4NEGqcEq-T0yNtVhM4,12374
+integrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+integrations/django/__init__.py,sha256=YDgD1Ux1E3CJxQMT-9tulhXmuLOEaUSv320LeaVgJ00,116
+integrations/django/admin.py,sha256=6fs6GiKcdc-hGlLxJ0BthY7TFo_2RVVJRhQwhxMroCY,2664
+integrations/django/apps.py,sha256=57svd2aqSuoASWMI3Jnh70ZXrYN1oQ8EnvLl_5LNyl0,473
+integrations/django/models.py,sha256=83PjBnombavEjfPm2EcVFo2R5BO6VRIjp0MlNCp-fbg,5819
+integrations/django/signals.py,sha256=VtNYEAnu13wi9PqadEaCU9LY_k2tY26AS4bnPIAqw7M,1319
+integrations/django/views.py,sha256=nP2HRMx02tMbdv_KfDqIA5vQAwZ6TUuZazrZ2zoNfqQ,3029
+integrations/django/webhooks.py,sha256=cP_Jc3VlyyvyzDbBd2yEVHikw60th1_-L9_vtsRfwgs,31335
+integrations/django/migrations/0001_initial.py,sha256=YLDUp1w0V3Zvuz5TssQDrx3PlccduoHqdLD109Hg8Z4,2326
+integrations/django/migrations/__init__.py,sha256=KLQ5NdjOMLDS21-u3b_g08G1MjPMMhG95XI_N8m4FSo,41
+integrations/fastapi/__init__.py,sha256=DLnhAZQZf2ghu8BuFFfE7FzbNKWQQ2SLG8qxldRuwR4,565
+integrations/fastapi/models.py,sha256=eWGUpiKufj47AK8Hld4A91jRDj0ZKQzAf95CyUozmvo,4638
+integrations/fastapi/routes.py,sha256=D17QeyY4-aX6tCNmk5h3UiavukvVrE5e6JOFCy4t_n8,36629
+integrations/fastapi/schemas.py,sha256=CkNohj22mQQje8Pu_IkTQwUPAoYHNOKXlGjqaRX_SGQ,3784
+paytechuz-0.1.4.dist-info/METADATA,sha256=4QSapmW-hD_4AJm0rE-OvnXIhRRgsePVnsX6UKczfh4,3861
+paytechuz-0.1.4.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+paytechuz-0.1.4.dist-info/top_level.txt,sha256=tfgxeqY7QDfOFb07FwoMkscdgKV9VIbJLnJnh2FNjRM,27
+paytechuz-0.1.4.dist-info/RECORD,,

paytechuz-0.1.4.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+core
+gateways
+integrations

paytechuz/__init__.py

@@ -1,76 +0,0 @@
-"""PayTechUZ - Unified payment library for Uzbekistan payment systems.
-
-This library provides a unified interface for working with Payme and Click
-payment systems in Uzbekistan. It supports Django, Flask, and FastAPI.
-"""
-from typing import Any
-
-__version__ = '0.1.1'
-
-
-
-# Define dummy classes to avoid import errors
-class PaymeGateway:
-    """Dummy PaymeGateway class to avoid import errors."""
-    def __init__(self, **kwargs):
-        pass
-
-
-class ClickGateway:
-    """Dummy ClickGateway class to avoid import errors."""
-    def __init__(self, **kwargs):
-        pass
-
-
-class PaymentGateway:
-    """Dummy PaymentGateway enum to avoid import errors."""
-    class PAYME:
-        value = 'payme'
-
-    class CLICK:
-        value = 'click'
-
-
-# Import framework integrations - these imports are used to check availability
-# of frameworks, not for direct usage
-try:
-    import django  # noqa: F401 - Used for availability check
-    HAS_DJANGO = True
-except ImportError:
-    HAS_DJANGO = False
-
-try:
-    import fastapi  # noqa: F401 - Used for availability check
-    HAS_FASTAPI = True
-except ImportError:
-    HAS_FASTAPI = False
-
-try:
-    import flask  # noqa: F401 - Used for availability check
-    HAS_FLASK = True
-except ImportError:
-    HAS_FLASK = False
-
-
-def create_gateway(gateway_type: str, **kwargs) -> Any:
-    """
-    Create a payment gateway instance.
-
-    Args:
-        gateway_type: Type of gateway ('payme' or 'click')
-        **kwargs: Gateway-specific configuration
-
-    Returns:
-        Payment gateway instance
-
-    Raises:
-        ValueError: If the gateway type is not supported
-        ImportError: If the required gateway module is not available
-    """
-    # Just use the dummy classes for now
-    if gateway_type.lower() == 'payme':
-        return PaymeGateway(**kwargs)
-    if gateway_type.lower() == 'click':
-        return ClickGateway(**kwargs)
-
-    raise ValueError(f"Unsupported gateway type: {gateway_type}")

paytechuz/gateways/payme/client.py

@@ -1,238 +0,0 @@
-"""
-Payme payment gateway client.
-"""
-import logging
-from typing import Dict, Any, Optional, Union
-
-from paytechuz.core.base import BasePaymentGateway
-from paytechuz.core.http import HttpClient
-from paytechuz.core.constants import PaymeNetworks
-from paytechuz.core.utils import format_amount, handle_exceptions
-from paytechuz.gateways.payme.cards import PaymeCards
-from paytechuz.gateways.payme.receipts import PaymeReceipts
-
-logger = logging.getLogger(__name__)
-
-class PaymeGateway(BasePaymentGateway):
-    """
-    Payme payment gateway implementation.
-
-    This class provides methods for interacting with the Payme payment gateway,
-    including creating payments, checking payment status, and canceling payments.
-    """
-
-    def __init__(
-        self,
-        payme_id: str,
-        payme_key: Optional[str] = None,
-        fallback_id: Optional[str] = None,
-        is_test_mode: bool = False
-    ):
-        """
-        Initialize the Payme gateway.
-
-        Args:
-            payme_id: Payme merchant ID
-            payme_key: Payme merchant key for authentication
-            fallback_id: Fallback merchant ID
-            is_test_mode: Whether to use the test environment
-        """
-        super().__init__(is_test_mode)
-        self.payme_id = payme_id
-        self.payme_key = payme_key
-        self.fallback_id = fallback_id
-
-        # Set the API URL based on the environment
-        url = PaymeNetworks.TEST_NET if is_test_mode else PaymeNetworks.PROD_NET
-
-        # Initialize HTTP client
-        self.http_client = HttpClient(base_url=url)
-
-        # Initialize components
-        self.cards = PaymeCards(http_client=self.http_client, payme_id=payme_id)
-        self.receipts = PaymeReceipts(
-            http_client=self.http_client,
-            payme_id=payme_id,
-            payme_key=payme_key
-        )
-
-    @handle_exceptions
-    def create_payment(
-        self,
-        amount: Union[int, float, str],
-        account_id: Union[int, str],
-        **kwargs
-    ) -> Dict[str, Any]:
-        """
-        Create a payment using Payme receipts.
-
-        Args:
-            amount: The payment amount in som
-            account_id: The account ID or order ID
-            **kwargs: Additional parameters for the payment
-                - description: Payment description
-                - detail: Payment details
-                - callback_url: URL to redirect after payment
-                - return_url: URL to return after payment
-                - phone: Customer phone number
-                - email: Customer email
-                - language: Language code (uz, ru, en)
-                - expire_minutes: Payment expiration time in minutes
-
-        Returns:
-            Dict containing payment details including transaction ID and payment URL
-        """
-        # Format amount to tiyin (1 som = 100 tiyin)
-        amount_tiyin = format_amount(amount)
-
-        # Extract additional parameters
-        description = kwargs.get('description', f'Payment for account {account_id}')
-        detail = kwargs.get('detail', {})
-        callback_url = kwargs.get('callback_url')
-        return_url = kwargs.get('return_url')
-        phone = kwargs.get('phone')
-        email = kwargs.get('email')
-        language = kwargs.get('language', 'uz')
-        expire_minutes = kwargs.get('expire_minutes', 60)  # Default 1 hour
-
-        # Check if we have a merchant key
-        if self.payme_key:
-            # Create receipt using the API
-            receipt_data = self.receipts.create(
-                amount=amount_tiyin,
-                account={"account_id": str(account_id)},
-                description=description,
-                detail=detail,
-                callback_url=callback_url,
-                return_url=return_url,
-                phone=phone,
-                email=email,
-                language=language,
-                expire_minutes=expire_minutes
-            )
-
-            # Extract receipt ID and payment URL
-            receipt_id = receipt_data.get('receipt', {}).get('_id')
-            payment_url = receipt_data.get('receipt', {}).get('pay_url')
-
-            return {
-                'transaction_id': receipt_id,
-                'payment_url': payment_url,
-                'amount': amount,
-                'account_id': account_id,
-                'status': 'created',
-                'raw_response': receipt_data
-            }
-        else:
-            # Generate a payment URL using payme-pkg style
-            # This is a fallback method that doesn't require authentication
-            import base64
-            from paytechuz.core.utils import generate_id
-
-            # Generate a unique transaction ID
-            transaction_id = generate_id("payme")
-
-            # Format amount to the smallest currency unit (tiyin)
-            # amount_tiyin is already in tiyin format
-
-            # Build the payment parameters string
-            # Format: m=merchant_id;ac.field=value;a=amount;c=callback_url
-            params_str = f"m={self.payme_id};ac.id={account_id};a={amount_tiyin}"
-
-            # Add callback URL if provided (this is used for return URL in payme-pkg)
-            if return_url:
-                params_str += f";c={return_url}"
-
-            # Encode the parameters string to base64
-            encoded_params = base64.b64encode(params_str.encode("utf-8")).decode("utf-8")
-
-            # Build the payment URL
-            if self.is_test_mode:
-                payment_url = f"https://test.paycom.uz/{encoded_params}"
-            else:
-                payment_url = f"https://checkout.paycom.uz/{encoded_params}"
-
-            # Print the parameters for debugging
-            print("Payme payment parameters:")
-            print(f"Parameters string: {params_str}")
-            print(f"Encoded parameters: {encoded_params}")
-            print(f"Payment URL: {payment_url}")
-
-            return {
-                'transaction_id': transaction_id,
-                'payment_url': payment_url,
-                'amount': amount,
-                'account_id': account_id,
-                'status': 'created',
-                'raw_response': {}
-            }
-
-    @handle_exceptions
-    def check_payment(self, transaction_id: str) -> Dict[str, Any]:
-        """
-        Check payment status using Payme receipts.
-
-        Args:
-            transaction_id: The receipt ID to check
-
-        Returns:
-            Dict containing payment status and details
-        """
-        receipt_data = self.receipts.check(receipt_id=transaction_id)
-
-        # Extract receipt status
-        receipt = receipt_data.get('receipt', {})
-        status = receipt.get('state')
-
-        # Map Payme status to our status
-        status_mapping = {
-            0: 'created',
-            1: 'waiting',
-            2: 'paid',
-            3: 'cancelled',
-            4: 'refunded'
-        }
-
-        mapped_status = status_mapping.get(status, 'unknown')
-
-        return {
-            'transaction_id': transaction_id,
-            'status': mapped_status,
-            'amount': receipt.get('amount') / 100,  # Convert from tiyin to som
-            'paid_at': receipt.get('pay_time'),
-            'created_at': receipt.get('create_time'),
-            'cancelled_at': receipt.get('cancel_time'),
-            'raw_response': receipt_data
-        }
-
-    @handle_exceptions
-    def cancel_payment(
-        self,
-        transaction_id: str,
-        reason: Optional[str] = None
-    ) -> Dict[str, Any]:
-        """
-        Cancel payment using Payme receipts.
-
-        Args:
-            transaction_id: The receipt ID to cancel
-            reason: Optional reason for cancellation
-
-        Returns:
-            Dict containing cancellation status and details
-        """
-        receipt_data = self.receipts.cancel(
-            receipt_id=transaction_id,
-            reason=reason or "Cancelled by merchant"
-        )
-
-        # Extract receipt status
-        receipt = receipt_data.get('receipt', {})
-        status = receipt.get('state')
-
-        return {
-            'transaction_id': transaction_id,
-            'status': 'cancelled' if status == 3 else 'unknown',
-            'cancelled_at': receipt.get('cancel_time'),
-            'raw_response': receipt_data
-        }

paytechuz-0.1.3.dist-info/METADATA

@@ -1,198 +0,0 @@
-Metadata-Version: 2.4
-Name: paytechuz
-Version: 0.1.3
-Summary: Unified Python package for Uzbekistan payment gateways
-Home-page: https://github.com/Muhammadali-Akbarov/paytechuz
-Author: Muhammadali Akbarov
-Author-email: muhammadali17abc@gmail.com
-License: MIT
-Keywords: paytechuz,payme,click,uzbekistan,payment,gateway,payment-gateway,payment-processing,django,flask,fastapi
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-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: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Requires-Dist: requests<3.0,>=2.0
-Requires-Dist: dataclasses<1.0,>=0.6; python_version < "3.7"
-Provides-Extra: django
-Requires-Dist: django<5.0,>=3.0; extra == "django"
-Requires-Dist: djangorestframework<4.0,>=3.0; extra == "django"
-Provides-Extra: fastapi
-Requires-Dist: fastapi<1.0.0,>=0.68.0; extra == "fastapi"
-Requires-Dist: sqlalchemy<3.0,>=1.4; extra == "fastapi"
-Requires-Dist: httpx<1.0,>=0.20; extra == "fastapi"
-Requires-Dist: python-multipart==0.0.20; extra == "fastapi"
-Requires-Dist: pydantic<2.0,>=1.8; extra == "fastapi"
-Provides-Extra: flask
-Requires-Dist: flask<3.0,>=2.0; extra == "flask"
-Requires-Dist: flask-sqlalchemy<3.0,>=2.5; extra == "flask"
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: provides-extra
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# paytechuz
-
-paytechuz is a unified payment library for integration with popular payment systems in Uzbekistan (Payme and Click).
-
-[![PyPI version](https://badge.fury.io/py/paytechuz.svg)](https://badge.fury.io/py/paytechuz)
-[![Python Versions](https://img.shields.io/pypi/pyversions/paytechuz.svg)](https://pypi.org/project/paytechuz/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-## Installation
-
-To install paytechuz with all dependencies:
-
-```bash
-pip install paytechuz
-```
-
-For specific framework support:
-
-```bash
-# For Django
-pip install paytechuz[django]
-
-# For FastAPI
-pip install paytechuz[fastapi]
-```
-
-## Quick Start
-
-### Django Integration
-
-1. Add the app to your `INSTALLED_APPS`:
-
-```python
-# settings.py
-INSTALLED_APPS = [
-    # ...
-    'paytechuz.integrations.django',
-]
-
-# Payme settings
-PAYME_ID = 'your_payme_merchant_id'
-PAYME_KEY = 'your_payme_merchant_key'
-PAYME_ACCOUNT_MODEL = 'your_app.YourModel'  # For example: 'orders.Order'
-PAYME_ACCOUNT_FIELD = 'id'  # Field for account identifier
-PAYME_AMOUNT_FIELD = 'amount'  # Field for storing payment amount
-PAYME_ONE_TIME_PAYMENT = True  # Allow only one payment per account
-```
-
-2. Set up the webhook URLs:
-
-```python
-# urls.py
-from django.urls import path
-from django.views.decorators.csrf import csrf_exempt
-
-from your_app.views import PaymeWebhookView, ClickWebhookView
-
-
-urlpatterns = [
-    # ...
-    path('payments/payme/', csrf_exempt(PaymeWebhookView.as_view()), name='payme_webhook'),
-    path('payments/click/', csrf_exempt(ClickWebhookView.as_view()), name='click_webhook'),
-]
-```
-
-3. Create custom webhook handlers:
-
-```python
-# views.py
-from paytechuz.integrations.django.views import PaymeWebhookView as BasePaymeWebhookView
-from .models import Order
-
-class PaymeWebhookView(BasePaymeWebhookView):
-    def successfully_payment(self, params, transaction):
-        """Called when payment is successful"""
-        order_id = transaction.account_id
-        order = Order.objects.get(id=order_id)
-        order.status = 'paid'
-        order.save()
-        
-    def cancelled_payment(self, params, transaction):
-        """Called when payment is cancelled"""
-        order_id = transaction.account_id
-        order = Order.objects.get(id=order_id)
-        order.status = 'cancelled'
-        order.save()
-```
-
-### FastAPI Integration
-
-1. Create a custom webhook handler:
-
-```python
-from fastapi import APIRouter, Depends, Request
-from sqlalchemy.orm import Session
-
-from app.database.db import get_db
-from app.models.models import Order
-from paytechuz.integrations.fastapi import PaymeWebhookHandler
-
-# Payme configuration
-PAYME_ID = 'your_payme_id'
-PAYME_KEY = 'your_payme_key'
-
-class CustomPaymeWebhookHandler(PaymeWebhookHandler):
-    def successfully_payment(self, params, transaction) -> None:
-        """Called when payment is successful"""
-        order = self.db.query(Order).filter(Order.id == transaction.account_id).first()
-        if order:
-            order.status = "paid"
-            self.db.commit()
-
-    def cancelled_payment(self, params, transaction) -> None:
-        """Called when payment is cancelled"""
-        order = self.db.query(Order).filter(Order.id == transaction.account_id).first()
-        if order:
-            order.status = "cancelled"
-            self.db.commit()
-```
-
-2. Create a webhook endpoint:
-
-```python
-router = APIRouter()
-
-@router.post("/payments/payme/webhook")
-async def payme_webhook(request: Request, db: Session = Depends(get_db)):
-    """Handle Payme webhook requests"""
-    handler = CustomPaymeWebhookHandler(
-        db=db,
-        payme_id=PAYME_ID,
-        payme_key=PAYME_KEY,
-        account_model=Order,
-        account_field="id",
-        amount_field="amount",
-        one_time_payment=False
-    )
-    result = await handler.handle_webhook(request)
-    return result
-```
-
-## Documentation
-
-For detailed documentation, see:
-
-- [English Documentation](paytechuz/docs/en/index.md)
-- [O'zbek tilidagi hujjatlar](paytechuz/docs/index.md)

paytechuz-0.1.3.dist-info/RECORD

@@ -1,36 +0,0 @@
-paytechuz/__init__.py,sha256=qLjm35Dc7UqnetOcbXgc_vP5FnzAq810h7T1YBhjeiQ,1937
-paytechuz/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-paytechuz/core/base.py,sha256=bHmRMYZ97Kj76a4kL7UMRcecnZF-rKnBYZddQvRtRmQ,2497
-paytechuz/core/constants.py,sha256=P2zeZ_cfZIttdC1vqkpIngkfRFh6loWzJYEgzQb5cKA,1660
-paytechuz/core/exceptions.py,sha256=XMJkqiponTkvhjoh3S2iFNuU3UbBdFW4130kd0hpudg,5489
-paytechuz/core/http.py,sha256=qmLR6ujxmIPjwoTS4vvKRIvDnNcpl84sS1HmVB890b0,7686
-paytechuz/core/utils.py,sha256=ETHMzwu7_dirc-QfBUjpSTQmyS6_vBiNq97Dq9CNZto,4718
-paytechuz/core/payme/errors.py,sha256=CZE62MbYDMsRfNIX23Syt6of_tPMMGLnXhYMii4hw3A,542
-paytechuz/gateways/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-paytechuz/gateways/click/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-paytechuz/gateways/click/client.py,sha256=XTri3iogq4_MgvZehBK2CScVCMubvg1GNXV9whGAS6I,6663
-paytechuz/gateways/click/merchant.py,sha256=vJ_DivA1KfRT5p3sfA5yZGMYXoUmVbAM7QHvaXr6VCU,7254
-paytechuz/gateways/click/webhook.py,sha256=rph-NmjjnBKMW4rcxQTXrHHdK-uMrU39kXnbqK56leo,7936
-paytechuz/gateways/payme/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-paytechuz/gateways/payme/cards.py,sha256=aL6su_ZTCBPU8qmrz2Jcw_Wn7Zf9RwIu8k10o4AWFTs,5420
-paytechuz/gateways/payme/client.py,sha256=C1OQWLo7LIAF3xbFOLyCaJ3xFwQaFVpaxWCYajCltTY,8201
-paytechuz/gateways/payme/receipts.py,sha256=DdrZMPeDvQmGyqAEOTmtUorfcIVVb3t2tg31l7TXqHo,8904
-paytechuz/gateways/payme/webhook.py,sha256=-0O8vzMtiu4U8FWFKDA6EfyoX4NEGqcEq-T0yNtVhM4,12374
-paytechuz/integrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-paytechuz/integrations/django/__init__.py,sha256=YDgD1Ux1E3CJxQMT-9tulhXmuLOEaUSv320LeaVgJ00,116
-paytechuz/integrations/django/admin.py,sha256=6fs6GiKcdc-hGlLxJ0BthY7TFo_2RVVJRhQwhxMroCY,2664
-paytechuz/integrations/django/apps.py,sha256=57svd2aqSuoASWMI3Jnh70ZXrYN1oQ8EnvLl_5LNyl0,473
-paytechuz/integrations/django/models.py,sha256=83PjBnombavEjfPm2EcVFo2R5BO6VRIjp0MlNCp-fbg,5819
-paytechuz/integrations/django/signals.py,sha256=VtNYEAnu13wi9PqadEaCU9LY_k2tY26AS4bnPIAqw7M,1319
-paytechuz/integrations/django/views.py,sha256=nP2HRMx02tMbdv_KfDqIA5vQAwZ6TUuZazrZ2zoNfqQ,3029
-paytechuz/integrations/django/webhooks.py,sha256=cP_Jc3VlyyvyzDbBd2yEVHikw60th1_-L9_vtsRfwgs,31335
-paytechuz/integrations/django/migrations/0001_initial.py,sha256=YLDUp1w0V3Zvuz5TssQDrx3PlccduoHqdLD109Hg8Z4,2326
-paytechuz/integrations/django/migrations/__init__.py,sha256=KLQ5NdjOMLDS21-u3b_g08G1MjPMMhG95XI_N8m4FSo,41
-paytechuz/integrations/fastapi/__init__.py,sha256=DLnhAZQZf2ghu8BuFFfE7FzbNKWQQ2SLG8qxldRuwR4,565
-paytechuz/integrations/fastapi/models.py,sha256=eWGUpiKufj47AK8Hld4A91jRDj0ZKQzAf95CyUozmvo,4638
-paytechuz/integrations/fastapi/routes.py,sha256=D17QeyY4-aX6tCNmk5h3UiavukvVrE5e6JOFCy4t_n8,36629
-paytechuz/integrations/fastapi/schemas.py,sha256=CkNohj22mQQje8Pu_IkTQwUPAoYHNOKXlGjqaRX_SGQ,3784
-paytechuz-0.1.3.dist-info/METADATA,sha256=fLZlC2jeUhspOlm3nmb0HzKy29Qa6N2K2T-u4y06gfU,6058
-paytechuz-0.1.3.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-paytechuz-0.1.3.dist-info/top_level.txt,sha256=oloyKGNVj9Z2h3wpKG5yPyTlpdpWW0-CWr-j-asCWBc,10
-paytechuz-0.1.3.dist-info/RECORD,,

paytechuz-0.1.3.dist-info/top_level.txt

@@ -1 +0,0 @@
-paytechuz