paytechuz 0.1.3__tar.gz → 0.1.4__tar.gz

paytechuz-0.1.4/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,131 @@
+# 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/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "paytechuz"
+version = "0.1.4"
+description = "Unified Python package for Uzbekistan payment gateways"
+readme = "README.md"
+requires-python = ">=3.7"
+license = {text = "MIT"}
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["paytechuz*", "core*", "gateways*", "integrations*"]

{paytechuz-0.1.3 → paytechuz-0.1.4}/setup.py

@@ -1,14 +1,14 @@
 """Setup script for PayTechUZ package."""
 
 import pathlib
-from setuptools import setup
+from setuptools import setup, find_namespace_packages
 
 here = pathlib.Path(__file__).parent.resolve()
 long_description = (here / "README.md").read_text(encoding="utf-8")
 
 setup(
     name='paytechuz',
-    version='0.1.3',
+    version='0.1.4',
     license='MIT',
     author="Muhammadali Akbarov",
     author_email='muhammadali17abc@gmail.com',
@@ -17,19 +17,7 @@ setup(
     long_description_content_type="text/markdown",
     url='https://github.com/Muhammadali-Akbarov/paytechuz',
 
-    packages=[
-        'paytechuz',
-        'paytechuz.core',
-        'paytechuz.core.payme',
-        'paytechuz.gateways',
-        'paytechuz.gateways.payme',
-        'paytechuz.gateways.click',
-        'paytechuz.integrations',
-        'paytechuz.integrations.django',
-        'paytechuz.integrations.django.migrations',
-        'paytechuz.integrations.fastapi',
-        'paytechuz.integrations.flask',
-    ],
+    packages=find_namespace_packages(include=['paytechuz*']),
     package_dir={
         'paytechuz': 'src',
     },

{paytechuz-0.1.3 → paytechuz-0.1.4}/src/__init__.py

@@ -5,8 +5,7 @@ payment systems in Uzbekistan. It supports Django, Flask, and FastAPI.
 """
 from typing import Any
 
-__version__ = '0.1.1'
-
+__version__ = '0.1.4'
 
 
 # Define dummy classes to avoid import errors

{paytechuz-0.1.3 → paytechuz-0.1.4}/src/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.

paytechuz-0.1.4/src/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
+        }