paytechuz 0.2.20__py3-none-any.whl → 0.2.22__py3-none-any.whl

integrations/django/models.py

@@ -1,174 +0,0 @@
-"""
-Django models for PayTechUZ.
-"""
-from django.db import models
-from django.utils import timezone
-
-
-class PaymentTransaction(models.Model):
-    """
-    Payment transaction model for storing payment information.
-    """
-    # Payment gateway choices
-    PAYME = 'payme'
-    CLICK = 'click'
-
-    GATEWAY_CHOICES = [
-        (PAYME, 'Payme'),
-        (CLICK, 'Click'),
-    ]
-
-    # Transaction states
-    CREATED = 0
-    INITIATING = 1
-    SUCCESSFULLY = 2
-    CANCELLED = -2
-    CANCELLED_DURING_INIT = -1
-
-    STATE_CHOICES = [
-        (CREATED, "Created"),
-        (INITIATING, "Initiating"),
-        (SUCCESSFULLY, "Successfully"),
-        (CANCELLED, "Cancelled after successful performed"),
-        (CANCELLED_DURING_INIT, "Cancelled during initiation"),
-    ]
-
-    gateway = models.CharField(max_length=10, choices=GATEWAY_CHOICES)
-    transaction_id = models.CharField(max_length=255)
-    account_id = models.CharField(max_length=255)
-    amount = models.DecimalField(max_digits=15, decimal_places=2)
-    state = models.IntegerField(choices=STATE_CHOICES, default=CREATED)
-    reason = models.IntegerField(null=True, blank=True)  # Reason for cancellation
-    extra_data = models.JSONField(default=dict, blank=True)
-    created_at = models.DateTimeField(auto_now_add=True, db_index=True)
-    updated_at = models.DateTimeField(auto_now=True, db_index=True)
-    performed_at = models.DateTimeField(null=True, blank=True, db_index=True)
-    cancelled_at = models.DateTimeField(null=True, blank=True, db_index=True)
-
-    class Meta:
-        """
-        Model Meta options.
-        """
-        verbose_name = "Payment Transaction"
-        verbose_name_plural = "Payment Transactions"
-        ordering = ["-created_at"]
-        db_table = "payments"
-        unique_together = [['gateway', 'transaction_id']]
-        indexes = [
-            models.Index(fields=['account_id']),
-            models.Index(fields=['state']),
-        ]
-
-    def __str__(self):
-        """
-        String representation of the PaymentTransaction model.
-        """
-        return f"{self.get_gateway_display()} Transaction #{self.transaction_id} - {self.amount}"
-
-    def mark_as_paid(self):
-        """
-        Mark the transaction as paid.
-        """
-        if self.state != self.SUCCESSFULLY:
-            self.state = self.SUCCESSFULLY
-            self.performed_at = timezone.now()
-            self.save()
-        return self
-
-    def mark_as_cancelled(self, reason=None):
-        """
-        Mark the transaction as cancelled.
-
-        Args:
-            reason: Reason for cancellation (integer code)
-
-        Returns:
-            PaymentTransaction instance
-        """
-        if self.state not in [self.CANCELLED, self.CANCELLED_DURING_INIT]:
-            # Always set state to CANCELLED (-2) for Payme API compatibility
-            # regardless of the current state
-            self.state = self.CANCELLED
-            self.cancelled_at = timezone.now()
-
-            # Store reason directly in the reason column if provided
-            if reason is not None:
-                # Convert reason to int if it's a string
-                if isinstance(reason, str) and reason.isdigit():
-                    reason_code = int(reason)
-                else:
-                    reason_code = reason
-                self.reason = reason_code
-
-                # For backward compatibility, also store in extra_data
-                extra_data = self.extra_data or {}
-                extra_data['cancel_reason'] = reason_code
-                self.extra_data = extra_data
-
-            self.save()
-        return self
-
-    @classmethod
-    def create_transaction(cls, gateway, transaction_id, account_id, amount, extra_data=None):
-        """
-        Create a new transaction or get an existing one.
-
-        Args:
-            gateway: Payment gateway (payme or click)
-            transaction_id: Transaction ID from the payment system
-            account_id: Account or order ID
-            amount: Payment amount
-            extra_data: Additional data for the transaction
-
-        Returns:
-            PaymentTransaction instance
-        """
-        transaction, created = cls.objects.get_or_create(
-            gateway=gateway,
-            transaction_id=transaction_id,
-            defaults={
-                'account_id': str(account_id),
-                'amount': amount,
-                'state': cls.CREATED,
-                'extra_data': extra_data or {}
-            }
-        )
-
-        return transaction
-
-    @classmethod
-    def update_transaction(cls, gateway, transaction_id, state=None, extra_data=None):
-        """
-        Update an existing transaction.
-
-        Args:
-            gateway: Payment gateway (payme or click)
-            transaction_id: Transaction ID from the payment system
-            state: New state for the transaction
-            extra_data: Additional data to update
-
-        Returns:
-            PaymentTransaction instance or None if not found
-        """
-        try:
-            transaction = cls.objects.get(gateway=gateway, transaction_id=transaction_id)
-
-            if state is not None:
-                transaction.state = state
-
-                # Update timestamps based on state
-                if state == cls.SUCCESSFULLY:
-                    transaction.performed_at = timezone.now()
-                elif state in [cls.CANCELLED, cls.CANCELLED_DURING_INIT]:
-                    transaction.cancelled_at = timezone.now()
-
-            # Update extra_data if provided
-            if extra_data:
-                current_extra_data = transaction.extra_data or {}
-                current_extra_data.update(extra_data)
-                transaction.extra_data = current_extra_data
-
-            transaction.save()
-            return transaction
-        except cls.DoesNotExist:
-            return None

integrations/django/signals.py

@@ -1,46 +0,0 @@
-"""
-Django signals for PayTechUZ.
-"""
-from django.db.models.signals import post_save
-from django.dispatch import Signal, receiver
-
-from .models import PaymentTransaction
-
-# Custom signals
-payment_successful = Signal()
-payment_cancelled = Signal()
-payment_created = Signal()
-
-# Signal handlers
-@receiver(post_save, sender=PaymentTransaction)
-def handle_transaction_state_change(sender, instance, created, **kwargs):
-    """
-    Handle transaction state changes.
-
-    Args:
-        sender: The model class
-        instance: The actual instance being saved
-        created: A boolean; True if a new record was created
-        **kwargs: Additional keyword arguments
-    """
-    # Skip if the transaction was just created
-    if created:
-        payment_created.send(
-            sender=sender,
-            transaction=instance
-        )
-        return
-
-    # Check if the transaction was marked as paid
-    if instance.state == PaymentTransaction.SUCCESSFULLY:
-        payment_successful.send(
-            sender=sender,
-            transaction=instance
-        )
-
-    # Check if the transaction was marked as cancelled
-    elif instance.state in [PaymentTransaction.CANCELLED, PaymentTransaction.CANCELLED_DURING_INIT]:
-        payment_cancelled.send(
-            sender=sender,
-            transaction=instance
-        )

integrations/django/views.py

@@ -1,102 +0,0 @@
-"""
-Django views for PayTechUZ.
-"""
-import logging
-from django.views.decorators.csrf import csrf_exempt
-from django.utils.decorators import method_decorator
-
-from .webhooks import PaymeWebhook, ClickWebhook
-
-logger = logging.getLogger(__name__)
-
-
-@method_decorator(csrf_exempt, name='dispatch')
-class PaymeWebhookView(PaymeWebhook):
-    """
-    Default Payme webhook view.
-
-    This view handles webhook requests from the Payme payment system.
-    You can extend this class and override the event methods to customize
-    the behavior.
-
-    Example:
-    ```python
-    from paytechuz.integrations.django.views import PaymeWebhookView
-
-    class CustomPaymeWebhookView(PaymeWebhookView):
-        def successfully_payment(self, params, transaction):
-            # Your custom logic here
-            print(f"Payment successful: {transaction.transaction_id}")
-
-            # Update your order status
-            order = Order.objects.get(id=transaction.account_id)
-            order.status = 'paid'
-            order.save()
-    ```
-    """
-
-    def successfully_payment(self, params, transaction):
-        """
-        Called when a payment is successful.
-
-        Args:
-            params: Request parameters
-            transaction: Transaction object
-        """
-        logger.info(f"Payme payment successful: {transaction.transaction_id}")
-
-    def cancelled_payment(self, params, transaction):
-        """
-        Called when a payment is cancelled.
-
-        Args:
-            params: Request parameters
-            transaction: Transaction object
-        """
-        logger.info(f"Payme payment cancelled: {transaction.transaction_id}")
-
-
-@method_decorator(csrf_exempt, name='dispatch')
-class ClickWebhookView(ClickWebhook):
-    """
-    Default Click webhook view.
-
-    This view handles webhook requests from the Click payment system.
-    You can extend this class and override the event methods to customize
-    the behavior.
-
-    Example:
-    ```python
-    from paytechuz.integrations.django.views import ClickWebhookView
-
-    class CustomClickWebhookView(ClickWebhookView):
-        def successfully_payment(self, params, transaction):
-            # Your custom logic here
-            print(f"Payment successful: {transaction.transaction_id}")
-
-            # Update your order status
-            order = Order.objects.get(id=transaction.account_id)
-            order.status = 'paid'
-            order.save()
-    ```
-    """
-
-    def successfully_payment(self, params, transaction):
-        """
-        Called when a payment is successful.
-
-        Args:
-            params: Request parameters
-            transaction: Transaction object
-        """
-        logger.info(f"Click payment successful: {transaction.transaction_id}")
-
-    def cancelled_payment(self, params, transaction):
-        """
-        Called when a payment is cancelled.
-
-        Args:
-            params: Request parameters
-            transaction: Transaction object
-        """
-        logger.info(f"Click payment cancelled: {transaction.transaction_id}")