paytechuz 0.1.4__tar.gz → 0.2.0b0__tar.gz

{paytechuz-0.1.4/src/paytechuz.egg-info → paytechuz-0.2.0b0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paytechuz
-Version: 0.1.4
+Version: 0.2.0b0
 Summary: Unified Python package for Uzbekistan payment gateways
 Home-page: https://github.com/Muhammadali-Akbarov/paytechuz
 Author: Muhammadali Akbarov
@@ -41,23 +41,34 @@ pip install paytechuz[fastapi]
 ### Generate Payment Links
 
 ```python
-from paytechuz.gateways.payme import PaymeGateway
-from paytechuz.gateways.click import ClickGateway
+from paytechuz import create_gateway, PaymentGateway
 
 # Initialize gateways
-payme = PaymeGateway()
-click = ClickGateway()
+payme = create_gateway(PaymentGateway.PAYME.value,
+    payme_id="your_payme_id",
+    payme_key="your_payme_key",
+    is_test_mode=True
+)
+
+click = create_gateway(PaymentGateway.CLICK.value,
+    service_id="your_service_id",
+    merchant_id="your_merchant_id",
+    merchant_user_id="your_merchant_user_id",
+    secret_key="your_secret_key",
+    is_test_mode=True
+)
 
 # Generate payment links
-payme_link = payme.generate_payment_link(
+payme_link = payme.create_payment(
     id="order_123",
     amount=150000,  # amount in UZS
     return_url="https://example.com/return"
 )
 
-click_link = click.generate_payment_link(
-    id="order_123",
+click_link = click.create_payment(
     amount=150000,  # amount in UZS
+    account_id="order_123",
+    description="Test payment",
     return_url="https://example.com/return"
 )
 ```
@@ -99,7 +110,7 @@ class PaymeWebhookView(PaymeWebhookView):
         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'

{paytechuz-0.1.4 → paytechuz-0.2.0b0}/README.md

@@ -26,23 +26,34 @@ pip install paytechuz[fastapi]
 ### Generate Payment Links
 
 ```python
-from paytechuz.gateways.payme import PaymeGateway
-from paytechuz.gateways.click import ClickGateway
+from paytechuz import create_gateway, PaymentGateway
 
 # Initialize gateways
-payme = PaymeGateway()
-click = ClickGateway()
+payme = create_gateway(PaymentGateway.PAYME.value,
+    payme_id="your_payme_id",
+    payme_key="your_payme_key",
+    is_test_mode=True
+)
+
+click = create_gateway(PaymentGateway.CLICK.value,
+    service_id="your_service_id",
+    merchant_id="your_merchant_id",
+    merchant_user_id="your_merchant_user_id",
+    secret_key="your_secret_key",
+    is_test_mode=True
+)
 
 # Generate payment links
-payme_link = payme.generate_payment_link(
+payme_link = payme.create_payment(
     id="order_123",
     amount=150000,  # amount in UZS
     return_url="https://example.com/return"
 )
 
-click_link = click.generate_payment_link(
-    id="order_123",
+click_link = click.create_payment(
     amount=150000,  # amount in UZS
+    account_id="order_123",
+    description="Test payment",
     return_url="https://example.com/return"
 )
 ```
@@ -84,7 +95,7 @@ class PaymeWebhookView(PaymeWebhookView):
         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'

{paytechuz-0.1.4 → paytechuz-0.2.0b0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "paytechuz"
-version = "0.1.4"
+version = "0.2.0-beta"
 description = "Unified Python package for Uzbekistan payment gateways"
 readme = "README.md"
 requires-python = ">=3.7"
@@ -13,6 +13,5 @@ license = {text = "MIT"}
 [tool.setuptools]
 package-dir = {"" = "src"}
 
-[tool.setuptools.packages.find]
-where = ["src"]
-include = ["paytechuz*", "core*", "gateways*", "integrations*"]
+[tool.setuptools.packages]
+find = {where = ["src"], include = ["paytechuz*"]}

{paytechuz-0.1.4 → paytechuz-0.2.0b0}/setup.py

@@ -1,14 +1,14 @@
 """Setup script for PayTechUZ package."""
 
 import pathlib
-from setuptools import setup, find_namespace_packages
+from setuptools import setup, find_packages
 
 here = pathlib.Path(__file__).parent.resolve()
 long_description = (here / "README.md").read_text(encoding="utf-8")
 
 setup(
     name='paytechuz',
-    version='0.1.4',
+    version='0.1.6',
     license='MIT',
     author="Muhammadali Akbarov",
     author_email='muhammadali17abc@gmail.com',
@@ -17,10 +17,8 @@ setup(
     long_description_content_type="text/markdown",
     url='https://github.com/Muhammadali-Akbarov/paytechuz',
 
-    packages=find_namespace_packages(include=['paytechuz*']),
-    package_dir={
-        'paytechuz': 'src',
-    },
+    packages=find_packages(where='src'),
+    package_dir={'': 'src'},
     include_package_data=True,
     package_data={
         '': ['*.py'],

paytechuz-0.2.0b0/src/paytechuz/__init__.py

@@ -0,0 +1,90 @@
+"""
+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.2.0-beta'
+
+# 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
+
+
+# Import the main classes for easier access
+try:
+    from paytechuz.gateways.payme.client import PaymeGateway  # noqa: E402
+    from paytechuz.gateways.click.client import ClickGateway  # noqa: E402
+    from paytechuz.core.constants import PaymentGateway  # noqa: E402
+except ImportError:
+    # Fallback for development mode
+    try:
+        from .gateways.payme.client import PaymeGateway  # noqa: E402
+        from .gateways.click.client import ClickGateway  # noqa: E402
+        from .core.constants import PaymentGateway  # noqa: E402
+    except ImportError:
+        # Dummy classes to avoid import errors
+        class PaymeGateway:
+            """Dummy PaymeGateway class to avoid import errors."""
+            def __init__(self, **kwargs):
+                pass
+
+            def create_payment(self, **kwargs):
+                return "https://test.paycom.uz/dummy-payment-url"
+
+        class ClickGateway:
+            """Dummy ClickGateway class to avoid import errors."""
+            def __init__(self, **kwargs):
+                pass
+
+            def create_payment(self, **kwargs):
+                return {"payment_url": "https://my.click.uz/dummy-payment-url"}
+
+        class PaymentGateway:
+            """Dummy PaymentGateway enum to avoid import errors."""
+            class PAYME:
+                value = 'payme'
+
+            class CLICK:
+                value = 'click'
+
+
+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
+    """
+    if gateway_type.lower() == PaymentGateway.PAYME.value:
+        return PaymeGateway(**kwargs)
+    if gateway_type.lower() == PaymentGateway.CLICK.value:
+        return ClickGateway(**kwargs)
+
+    raise ValueError(f"Unsupported gateway type: {gateway_type}")

paytechuz-0.2.0b0/src/paytechuz/core/base.py

@@ -0,0 +1,97 @@
+"""
+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.
+
+    This abstract class defines the common interface that all payment gateways
+    must implement. It provides a consistent API for creating, checking, and
+    canceling payments regardless of the underlying payment provider.
+    """
+
+    def __init__(self, is_test_mode: bool = False):
+        """
+        Initialize the payment gateway.
+
+        Args:
+            is_test_mode (bool): Whether to use the test environment
+        """
+        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]:
+        """
+        Create a payment.
+
+        Args:
+            amount: The payment amount
+            account_id: The account ID or order ID
+            **kwargs: Additional parameters specific to the payment gateway
+
+        Returns:
+            Dict containing payment details including transaction ID
+        """
+        raise NotImplementedError
+
+    @abstractmethod
+    def check_payment(self, transaction_id: str) -> Dict[str, Any]:
+        """
+        Check payment status.
+
+        Args:
+            transaction_id: The transaction ID to check
+
+        Returns:
+            Dict containing payment status and details
+        """
+        raise NotImplementedError
+
+    @abstractmethod
+    def cancel_payment(
+        self,
+        transaction_id: str,
+        reason: Optional[str] = None
+    ) -> Dict[str, Any]:
+        """
+        Cancel payment.
+
+        Args:
+            transaction_id: The transaction ID to cancel
+            reason: Optional reason for cancellation
+
+        Returns:
+            Dict containing cancellation status and details
+        """
+        raise NotImplementedError
+
+
+class BaseWebhookHandler(ABC):
+    """
+    Base class for payment gateway webhook handlers.
+
+    This abstract class defines the common interface for handling webhook
+    callbacks from payment gateways.
+    """
+
+    @abstractmethod
+    def handle_webhook(self, data: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Handle webhook data from payment gateway.
+
+        Args:
+            data: The webhook data received from the payment gateway
+
+        Returns:
+            Dict containing the response to be sent back to the payment gateway
+        """
+        raise NotImplementedError

paytechuz-0.2.0b0/src/paytechuz/core/constants.py

@@ -0,0 +1,68 @@
+"""
+Constants for payment gateways.
+"""
+from enum import Enum
+
+class TransactionState(Enum):
+    """Transaction states."""
+    CREATED = 0
+    INITIATING = 1
+    SUCCESSFULLY = 2
+    CANCELED = -2
+    CANCELED_DURING_INIT = -1
+
+
+class PaymentGateway(Enum):
+    """Payment gateway types."""
+    PAYME = "payme"
+    CLICK = "click"
+
+class PaymeEndpoints:
+    """Payme API endpoints."""
+    RECEIPTS_CREATE = "receipts/create"
+    RECEIPTS_PAY = "receipts/pay"
+    RECEIPTS_SEND = "receipts/send"
+    RECEIPTS_CHECK = "receipts/check"
+    RECEIPTS_CANCEL = "receipts/cancel"
+    RECEIPTS_GET = "receipts/get"
+    CARDS_CREATE = "cards/create"
+    CARDS_VERIFY = "cards/verify"
+    CARDS_CHECK = "cards/check"
+    CARDS_REMOVE = "cards/remove"
+    CARDS_GET_VERIFY_CODE = "cards/get_verify_code"
+
+
+class PaymeNetworks:
+    """Payme API networks."""
+    TEST_NET = "https://checkout.test.paycom.uz/api"
+    PROD_NET = "https://checkout.paycom.uz/api"
+
+class ClickEndpoints:
+    """Click API endpoints."""
+    PREPARE = "prepare"
+    COMPLETE = "complete"
+    MERCHANT_API = "merchant/api"
+
+
+class ClickNetworks:
+    """Click API networks."""
+    TEST_NET = "https://api.click.uz/v2/merchant"
+    PROD_NET = "https://api.click.uz/v2/merchant"
+
+class ClickActions:
+    """Click API actions."""
+    PREPARE = 0
+    COMPLETE = 1
+
+
+class PaymeCancelReason:
+    """Payme cancel reason codes."""
+    REASON_USER_NOT_FOUND = 1
+    REASON_DEBIT_OPERATION_FAILED = 2
+    REASON_EXECUTION_ERROR = 3
+    REASON_TIMEOUT = 4
+    REASON_FUND_RETURNED = 5
+    REASON_UNKNOWN = 6
+    REASON_CANCELLED_BY_USER = 7
+    REASON_SUSPICIOUS_OPERATION = 8
+    REASON_MERCHANT_DECISION = 9

paytechuz-0.2.0b0/src/paytechuz/core/exceptions.py

@@ -0,0 +1,190 @@
+"""
+Exceptions for payment gateways.
+"""
+from typing import Optional, Dict, Any
+
+class PaymentException(Exception):
+    """Base exception for all payment exceptions."""
+    code = "payment_error"
+    message = "Payment error occurred"
+    data: Dict[str, Any] = {}
+
+    def __init__(self, message: Optional[str] = None, code: Optional[str] = None, data: Optional[Dict[str, Any]] = None):
+        """
+        Initialize the exception.
+
+        Args:
+            message: Custom error message
+            code: Custom error code
+            data: Additional error data
+        """
+        self.message = message or self.message
+        self.code = code or self.code
+        self.data = data or self.data
+        super().__init__(self.message)
+
+    def as_dict(self) -> Dict[str, Any]:
+        """
+        Convert the exception to a dictionary.
+
+        Returns:
+            Dict containing error details
+        """
+        return {
+            "code": self.code,
+            "message": self.message,
+            "data": self.data
+        }
+
+# Authentication and Authorization Exceptions
+class AuthenticationError(PaymentException):
+    """Exception raised when authentication fails."""
+    code = "authentication_error"
+    message = "Authentication failed"
+
+
+
+class InvalidCredentials(AuthenticationError):
+    """Exception raised when credentials are invalid."""
+    code = "invalid_credentials"
+    message = "Invalid credentials provided"
+
+class PermissionDenied(AuthenticationError):
+    """Exception raised when permission is denied."""
+    code = "permission_denied"
+    message = "Permission denied"
+
+# Transaction Exceptions
+class TransactionError(PaymentException):
+    """Base exception for transaction errors."""
+    code = "transaction_error"
+    message = "Transaction error occurred"
+
+
+class TransactionNotFound(TransactionError):
+    """Exception raised when a transaction is not found."""
+    code = "transaction_not_found"
+    message = "Transaction not found"
+
+class TransactionAlreadyExists(TransactionError):
+    """Exception raised when a transaction already exists."""
+    code = "transaction_already_exists"
+    message = "Transaction already exists"
+
+
+class TransactionCancelled(TransactionError):
+    """Exception raised when a transaction is cancelled."""
+    code = "transaction_cancelled"
+    message = "Transaction has been cancelled"
+
+class TransactionInProgress(TransactionError):
+    """Exception raised when a transaction is in progress."""
+    code = "transaction_in_progress"
+    message = "Transaction is in progress"
+
+
+class TransactionCompleted(TransactionError):
+    """Exception raised when a transaction is already completed."""
+    code = "transaction_completed"
+    message = "Transaction is already completed"
+
+# Account Exceptions
+class AccountError(PaymentException):
+    """Base exception for account errors."""
+    code = "account_error"
+    message = "Account error occurred"
+
+
+class AccountNotFound(AccountError):
+    """Exception raised when an account is not found."""
+    code = "account_not_found"
+    message = "Account not found"
+
+class InvalidAccount(AccountError):
+    """Exception raised when an account is invalid."""
+    code = "invalid_account"
+    message = "Invalid account"
+
+# Amount Exceptions
+class AmountError(PaymentException):
+    """Base exception for amount errors."""
+    code = "amount_error"
+    message = "Amount error occurred"
+
+
+class InvalidAmount(AmountError):
+    """Exception raised when an amount is invalid."""
+    code = "invalid_amount"
+    message = "Invalid amount"
+
+class InsufficientFunds(AmountError):
+    """Exception raised when there are insufficient funds."""
+    code = "insufficient_funds"
+    message = "Insufficient funds"
+
+# Method Exceptions
+class MethodError(PaymentException):
+    """Base exception for method errors."""
+    code = "method_error"
+    message = "Method error occurred"
+
+
+class MethodNotFound(MethodError):
+    """Exception raised when a method is not found."""
+    code = "method_not_found"
+    message = "Method not found"
+
+class UnsupportedMethod(MethodError):
+    """Exception raised when a method is not supported."""
+    code = "unsupported_method"
+    message = "Method not supported"
+
+# System Exceptions
+class SystemError(PaymentException):
+    """Base exception for system errors."""
+    code = "system_error"
+    message = "System error occurred"
+
+
+class InternalServiceError(SystemError):
+    """Exception raised when an internal service error occurs."""
+    code = "internal_service_error"
+    message = "Internal service error"
+
+class ExternalServiceError(SystemError):
+    """Exception raised when an external service error occurs."""
+    code = "external_service_error"
+    message = "External service error"
+
+
+class TimeoutError(SystemError):
+    """Exception raised when a timeout occurs."""
+    code = "timeout_error"
+    message = "Operation timed out"
+
+# Create a list of exceptions that should not be wrapped
+exception_whitelist = (
+    PaymentException,
+    AuthenticationError,
+    InvalidCredentials,
+    PermissionDenied,
+    TransactionError,
+    TransactionNotFound,
+    TransactionAlreadyExists,
+    TransactionCancelled,
+    TransactionInProgress,
+    TransactionCompleted,
+    AccountError,
+    AccountNotFound,
+    InvalidAccount,
+    AmountError,
+    InvalidAmount,
+    InsufficientFunds,
+    MethodError,
+    MethodNotFound,
+    UnsupportedMethod,
+    SystemError,
+    InternalServiceError,
+    ExternalServiceError,
+    TimeoutError,
+)