paytechuz 0.1.0__py3-none-any.whl

integrations/fastapi/schemas.py

@@ -0,0 +1,99 @@
+"""
+FastAPI schemas for PayTechUZ.
+"""
+from datetime import datetime
+from typing import Dict, Any, Optional, List
+
+from pydantic import BaseModel, Field
+
+class PaymentTransactionBase(BaseModel):
+    """
+    Base schema for payment transaction.
+    """
+    gateway: str = Field(..., description="Payment gateway (payme or click)")
+    transaction_id: str = Field(..., description="Transaction ID from the payment system")
+    account_id: str = Field(..., description="Account or order ID")
+    amount: float = Field(..., description="Payment amount")
+    state: int = Field(0, description="Transaction state")
+
+
+class PaymentTransactionCreate(PaymentTransactionBase):
+    """
+    Schema for creating a payment transaction.
+    """
+    extra_data: Optional[Dict[str, Any]] = Field(None, description="Additional data for the transaction")
+
+class PaymentTransaction(PaymentTransactionBase):
+    """
+    Schema for payment transaction.
+    """
+    id: int = Field(..., description="Transaction ID")
+    extra_data: Dict[str, Any] = Field({}, description="Additional data for the transaction")
+    created_at: datetime = Field(..., description="Creation timestamp")
+    updated_at: datetime = Field(..., description="Last update timestamp")
+    performed_at: Optional[datetime] = Field(None, description="Payment timestamp")
+    cancelled_at: Optional[datetime] = Field(None, description="Cancellation timestamp")
+
+    class Config:
+        """
+        Pydantic configuration.
+        """
+        orm_mode = True
+
+
+class PaymentTransactionList(BaseModel):
+    """
+    Schema for a list of payment transactions.
+    """
+    transactions: List[PaymentTransaction] = Field(..., description="List of transactions")
+    total: int = Field(..., description="Total number of transactions")
+
+class PaymeWebhookRequest(BaseModel):
+    """
+    Schema for Payme webhook request.
+    """
+    method: str = Field(..., description="Method name")
+    params: Dict[str, Any] = Field(..., description="Method parameters")
+    id: int = Field(..., description="Request ID")
+
+
+class PaymeWebhookResponse(BaseModel):
+    """
+    Schema for Payme webhook response.
+    """
+    jsonrpc: str = Field("2.0", description="JSON-RPC version")
+    id: int = Field(..., description="Request ID")
+    result: Dict[str, Any] = Field(..., description="Response result")
+
+class PaymeWebhookErrorResponse(BaseModel):
+    """
+    Schema for Payme webhook error response.
+    """
+    jsonrpc: str = Field("2.0", description="JSON-RPC version")
+    id: int = Field(..., description="Request ID")
+    error: Dict[str, Any] = Field(..., description="Error details")
+
+
+class ClickWebhookRequest(BaseModel):
+    """
+    Schema for Click webhook request.
+    """
+    click_trans_id: str = Field(..., description="Click transaction ID")
+    service_id: str = Field(..., description="Service ID")
+    merchant_trans_id: str = Field(..., description="Merchant transaction ID")
+    amount: str = Field(..., description="Payment amount")
+    action: str = Field(..., description="Action (0 - prepare, 1 - complete)")
+    sign_time: str = Field(..., description="Signature timestamp")
+    sign_string: str = Field(..., description="Signature string")
+    error: Optional[str] = Field(None, description="Error code")
+    error_note: Optional[str] = Field(None, description="Error note")
+
+class ClickWebhookResponse(BaseModel):
+    """
+    Schema for Click webhook response.
+    """
+    click_trans_id: str = Field(..., description="Click transaction ID")
+    merchant_trans_id: str = Field(..., description="Merchant transaction ID")
+    merchant_prepare_id: Optional[int] = Field(None, description="Merchant prepare ID")
+    error: int = Field(0, description="Error code")
+    error_note: str = Field("Success", description="Error note")

paytechuz-0.1.0.dist-info/METADATA

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: paytechuz
+Version: 0.1.0
+Summary: Unified Python package for Uzbekistan payment gateways (Payme, Click)
+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.0.dist-info/RECORD

@@ -0,0 +1,36 @@
+core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+core/base.py,sha256=bHmRMYZ97Kj76a4kL7UMRcecnZF-rKnBYZddQvRtRmQ,2497
+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
+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=C1OQWLo7LIAF3xbFOLyCaJ3xFwQaFVpaxWCYajCltTY,8201
+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
+tests/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+tests/test_gateway.py,sha256=BlFu1rpUkwvyvz0FnMW0Ql2h1_oolKsiu1O29i4_5tY,2028
+paytechuz-0.1.0.dist-info/METADATA,sha256=pAGMLutaf31x74N9PXdcu-QzUVZ-lO27M6tpPwKshNY,6073
+paytechuz-0.1.0.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+paytechuz-0.1.0.dist-info/top_level.txt,sha256=R3fFUS1l6Qekw12fn3uEDdEXoU3hM1KY6QsBFpGWEh0,33
+paytechuz-0.1.0.dist-info/RECORD,,

paytechuz-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (78.1.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

paytechuz-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,4 @@
+core
+gateways
+integrations
+tests

tests/__init__.py

@@ -0,0 +1 @@
+

tests/test_gateway.py

@@ -0,0 +1,70 @@
+"""
+Tests for the gateway module.
+"""
+import unittest
+from unittest.mock import patch, MagicMock
+
+from paytechuz import create_gateway
+
+
+class TestCreateGateway(unittest.TestCase):
+    """
+    Test the create_gateway function.
+    """
+    
+    def test_create_payme_gateway(self):
+        """
+        Test creating a Payme gateway.
+        """
+        with patch('paytechuz.gateway.PaymeGateway') as mock_payme:
+            mock_instance = MagicMock()
+            mock_payme.return_value = mock_instance
+            
+            gateway = create_gateway(
+                'payme',
+                payme_id='test-id',
+                payme_key='test-key',
+                is_test_mode=True
+            )
+            
+            self.assertEqual(gateway, mock_instance)
+            mock_payme.assert_called_once_with(
+                payme_id='test-id',
+                payme_key='test-key',
+                is_test_mode=True
+            )
+    
+    def test_create_click_gateway(self):
+        """
+        Test creating a Click gateway.
+        """
+        with patch('paytechuz.gateway.ClickGateway') as mock_click:
+            mock_instance = MagicMock()
+            mock_click.return_value = mock_instance
+            
+            gateway = create_gateway(
+                'click',
+                service_id='test-service-id',
+                merchant_id='test-merchant-id',
+                secret_key='test-secret-key',
+                is_test_mode=True
+            )
+            
+            self.assertEqual(gateway, mock_instance)
+            mock_click.assert_called_once_with(
+                service_id='test-service-id',
+                merchant_id='test-merchant-id',
+                secret_key='test-secret-key',
+                is_test_mode=True
+            )
+    
+    def test_invalid_gateway_type(self):
+        """
+        Test creating a gateway with an invalid type.
+        """
+        with self.assertRaises(ValueError):
+            create_gateway('invalid')
+
+
+if __name__ == '__main__':
+    unittest.main()