ob-dj-store 0.0.19__py3-none-any.whl → 0.0.23.2__py3-none-any.whl

ob_dj_store/core/stores/gateway/stripe/admin.py

@@ -0,0 +1,77 @@
+"""
+Stripe Payment Gateway Admin
+
+This module contains the admin configuration for Stripe payment models.
+"""
+
+from django.contrib import admin
+from import_export.admin import ImportExportModelAdmin
+
+from ob_dj_store.core.stores.gateway.stripe.models import StripeCustomer, StripePayment
+
+
+@admin.register(StripePayment)
+class StripePaymentAdmin(ImportExportModelAdmin):
+    list_display = (
+        "payment_intent_id",
+        "payment",
+        "user",
+        "status",
+        "amount",
+        "currency",
+        "source",
+        "created_at",
+    )
+    list_filter = ("status", "source", "created_at")
+    search_fields = ("payment_intent_id", "user__email", "payment__id")
+    readonly_fields = (
+        "payment_intent_id",
+        "client_secret",
+        "init_response",
+        "webhook_response",
+        "created_at",
+        "updated_at",
+    )
+    raw_id_fields = ("payment", "user")
+    date_hierarchy = "created_at"
+
+    def get_queryset(self, request):
+        return (
+            super()
+            .get_queryset(request)
+            .select_related("payment__payment_tax", "user")
+            .prefetch_related(
+                "payment__orders__items", "payment__orders__shipping_method"
+            )
+        )
+
+    def amount(self, obj):
+        """Display payment amount"""
+        return f"${obj.amount:.2f}"
+
+    amount.short_description = "Amount"
+
+    def currency(self, obj):
+        """Display payment currency"""
+        return obj.currency.upper()
+
+    currency.short_description = "Currency"
+
+
+@admin.register(StripeCustomer)
+class StripeCustomerAdmin(ImportExportModelAdmin):
+    list_display = (
+        "stripe_customer_id",
+        "email",
+        "first_name",
+        "last_name",
+        "customer",
+        "created_at",
+    )
+    search_fields = ("stripe_customer_id", "email", "first_name", "last_name")
+    readonly_fields = ("stripe_customer_id", "init_data", "created_at", "updated_at")
+    raw_id_fields = ("customer",)
+    date_hierarchy = "created_at"
+
+    def get_queryset(self, request):
+        return super().get_queryset(request).select_related("customer")

ob_dj_store/core/stores/gateway/stripe/apps.py

@@ -0,0 +1,9 @@
+from django.apps import AppConfig
+from django.utils.translation import gettext_lazy as _
+
+
+class StripeConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "ob_dj_store.core.stores.gateway.stripe"
+    verbose_name = _("Gateway: Stripe")
+    label = "stripe"

ob_dj_store/core/stores/gateway/stripe/managers.py

@@ -0,0 +1,35 @@
+"""
+Stripe Payment Gateway Managers
+
+This module contains the managers for Stripe payment models.
+"""
+
+import logging
+
+from django.db import models
+
+from ob_dj_store.core.stores.gateway.stripe import utils
+
+logger = logging.getLogger(__name__)
+
+
+class StripePaymentManager(models.Manager):
+    """Manager for Stripe payments"""
+
+    def create(self, **kwargs):
+        """Create Stripe payment and initiate PaymentIntent"""
+        user = kwargs.get("user")
+        payment = kwargs.get("payment")
+
+        if not user or not payment:
+            raise ValueError("User and payment are required")
+
+        # Initiate Stripe payment
+        stripe_response = utils.initiate_stripe_payment(
+            user=user, payment=payment, currency_code=payment.currency
+        )
+
+        # Merge Stripe response with kwargs
+        kwargs.update(stripe_response)
+
+        return super().create(**kwargs)

ob_dj_store/core/stores/gateway/stripe/migrations/0001_initial.py

@@ -0,0 +1,168 @@
+# Generated by Django 3.2.8 on 2025-08-06 09:07
+
+import django.db.models.deletion
+import phonenumber_field.modelfields
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+        ("stores", "0109_wallettransaction_cashback_type"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="StripePayment",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                (
+                    "payment_intent_id",
+                    models.CharField(
+                        db_index=True,
+                        help_text="Stripe PaymentIntent ID",
+                        max_length=250,
+                        unique=True,
+                    ),
+                ),
+                (
+                    "client_secret",
+                    models.CharField(
+                        help_text="Client secret for frontend confirmation",
+                        max_length=250,
+                    ),
+                ),
+                (
+                    "status",
+                    models.CharField(
+                        choices=[
+                            ("requires_payment_method", "Requires Payment Method"),
+                            ("requires_confirmation", "Requires Confirmation"),
+                            ("requires_action", "Requires Action"),
+                            ("processing", "Processing"),
+                            ("requires_capture", "Requires Capture"),
+                            ("canceled", "Canceled"),
+                            ("succeeded", "Succeeded"),
+                        ],
+                        default="requires_payment_method",
+                        max_length=50,
+                    ),
+                ),
+                (
+                    "source",
+                    models.CharField(
+                        choices=[
+                            ("card", "Credit/Debit Card"),
+                            ("apple_pay", "Apple Pay"),
+                            ("google_pay", "Google Pay"),
+                            ("ach_debit", "ACH Bank Transfer"),
+                            ("klarna", "Klarna"),
+                            ("afterpay_clearpay", "Afterpay"),
+                        ],
+                        default="card",
+                        max_length=50,
+                    ),
+                ),
+                (
+                    "init_response",
+                    models.JSONField(
+                        blank=True,
+                        help_text="Initial PaymentIntent response from Stripe",
+                        null=True,
+                    ),
+                ),
+                (
+                    "webhook_response",
+                    models.JSONField(
+                        blank=True,
+                        help_text="Final webhook response from Stripe",
+                        null=True,
+                    ),
+                ),
+                (
+                    "langid",
+                    models.CharField(
+                        default="EN", help_text="Language preference", max_length=10
+                    ),
+                ),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                (
+                    "payment",
+                    models.OneToOneField(
+                        help_text="Reference to local payment transaction",
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="stripe_payment",
+                        to="stores.payment",
+                    ),
+                ),
+                (
+                    "user",
+                    models.ForeignKey(
+                        help_text="User who initiated the payment",
+                        on_delete=django.db.models.deletion.CASCADE,
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "Stripe Payment",
+                "verbose_name_plural": "Stripe Payments",
+                "ordering": ["-created_at"],
+            },
+        ),
+        migrations.CreateModel(
+            name="StripeCustomer",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                (
+                    "stripe_customer_id",
+                    models.CharField(db_index=True, max_length=200, unique=True),
+                ),
+                ("first_name", models.CharField(max_length=200)),
+                ("last_name", models.CharField(max_length=200)),
+                ("email", models.EmailField(max_length=254, null=True, unique=True)),
+                (
+                    "phone_number",
+                    phonenumber_field.modelfields.PhoneNumberField(
+                        max_length=128, null=True, region=None, unique=True
+                    ),
+                ),
+                ("init_data", models.JSONField()),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                (
+                    "customer",
+                    models.OneToOneField(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="stripe_customer",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "Stripe Customer",
+                "verbose_name_plural": "Stripe Customers",
+            },
+        ),
+    ]

ob_dj_store/core/stores/gateway/stripe/migrations/__init__.py

@@ -0,0 +1 @@
+# Migrations for Stripe payment gateway

ob_dj_store/core/stores/gateway/stripe/models.py

@@ -0,0 +1,174 @@
+"""
+Stripe Payment Gateway Models
+
+This module contains the models for Stripe payment integration,
+mirroring the structure of the TAP payment gateway.
+"""
+
+import logging
+
+from django.conf import settings
+from django.db import models
+from django.utils.translation import gettext_lazy as _
+from phonenumber_field.modelfields import PhoneNumberField
+
+from ob_dj_store.core.stores.gateway.stripe.managers import StripePaymentManager
+
+logger = logging.getLogger(__name__)
+
+
+class StripePayment(models.Model):
+    """StripePayment captures the payment from Stripe"""
+
+    class Status(models.TextChoices):
+        REQUIRES_PAYMENT_METHOD = (
+            "requires_payment_method",
+            _("Requires Payment Method"),
+        )
+        REQUIRES_CONFIRMATION = "requires_confirmation", _("Requires Confirmation")
+        REQUIRES_ACTION = "requires_action", _("Requires Action")
+        PROCESSING = "processing", _("Processing")
+        REQUIRES_CAPTURE = "requires_capture", _("Requires Capture")
+        CANCELED = "canceled", _("Canceled")
+        SUCCEEDED = "succeeded", _("Succeeded")
+
+    class Sources(models.TextChoices):
+        CARD = "card", _("Credit/Debit Card")
+        APPLE_PAY = "apple_pay", _("Apple Pay")
+        GOOGLE_PAY = "google_pay", _("Google Pay")
+        ACH_DEBIT = "ach_debit", _("ACH Bank Transfer")
+        KLARNA = "klarna", _("Klarna")
+        AFTERPAY = "afterpay_clearpay", _("Afterpay")
+
+    # Core fields
+    payment = models.OneToOneField(
+        "stores.Payment",
+        on_delete=models.CASCADE,
+        related_name="stripe_payment",
+        help_text=_("Reference to local payment transaction"),
+    )
+    user = models.ForeignKey(
+        settings.AUTH_USER_MODEL,
+        on_delete=models.CASCADE,
+        help_text=_("User who initiated the payment"),
+    )
+
+    # Stripe specific fields
+    payment_intent_id = models.CharField(
+        max_length=250,
+        unique=True,
+        db_index=True,
+        help_text=_("Stripe PaymentIntent ID"),
+    )
+    client_secret = models.CharField(
+        max_length=250, help_text=_("Client secret for frontend confirmation")
+    )
+    status = models.CharField(
+        max_length=50, choices=Status.choices, default=Status.REQUIRES_PAYMENT_METHOD
+    )
+    source = models.CharField(
+        max_length=50, choices=Sources.choices, default=Sources.CARD
+    )
+
+    # Response data
+    init_response = models.JSONField(
+        help_text=_("Initial PaymentIntent response from Stripe"), null=True, blank=True
+    )
+    webhook_response = models.JSONField(
+        help_text=_("Final webhook response from Stripe"), null=True, blank=True
+    )
+
+    # Metadata
+    langid = models.CharField(
+        max_length=10, default="EN", help_text=_("Language preference")
+    )
+
+    # Audit fields
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    objects = StripePaymentManager()
+
+    class Meta:
+        verbose_name = _("Stripe Payment")
+        verbose_name_plural = _("Stripe Payments")
+        ordering = ["-created_at"]
+
+    def __str__(self):
+        return f"StripePayment {self.payment_intent_id}"
+
+    @property
+    def amount(self):
+        """Return payment amount in dollars"""
+        return self.payment.total_payment
+
+    @property
+    def amount_cents(self):
+        """Return payment amount in cents for Stripe"""
+        return int(self.amount * 100)
+
+    @property
+    def currency(self):
+        """Get currency from payment"""
+        return self.payment.currency.lower()
+
+    @property
+    def payment_url(self):
+        """Return client secret for frontend processing"""
+        return self.client_secret
+
+    def webhook_update(self, stripe_event):
+        """Update payment based on Stripe webhook"""
+        payment_intent = stripe_event["data"]["object"]
+
+        # Update status and webhook response
+        old_status = self.status
+        self.status = payment_intent["status"]
+        self.webhook_response = payment_intent
+        self.save()
+
+        # Mark transaction based on new status
+        self.mark_transaction()
+
+        logger.info(
+            f"Stripe webhook updated PaymentIntent {self.payment_intent_id}: {old_status} -> {self.status}"
+        )
+
+    def mark_transaction(self):
+        """Mark the associated payment based on Stripe status"""
+        if self.status == self.Status.SUCCEEDED:
+            self.payment.mark_paid()
+        elif self.status in [self.Status.CANCELED]:
+            error_message = self.webhook_response.get("last_payment_error", {}).get(
+                "message", "Payment failed"
+            )
+            self.payment.mark_failed(error_message)
+
+
+class StripeCustomer(models.Model):
+    """Stripe customer mapping"""
+
+    customer = models.OneToOneField(
+        settings.AUTH_USER_MODEL,
+        on_delete=models.CASCADE,
+        related_name="stripe_customer",
+    )
+    stripe_customer_id = models.CharField(max_length=200, unique=True, db_index=True)
+    first_name = models.CharField(max_length=200)
+    last_name = models.CharField(max_length=200)
+    email = models.EmailField(unique=True, null=True)
+    phone_number = PhoneNumberField(unique=True, null=True)
+
+    # Store original Stripe response
+    init_data = models.JSONField()
+
+    # Audit fields
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        verbose_name = _("Stripe Customer")
+        verbose_name_plural = _("Stripe Customers")
+
+    def __str__(self):
+        return f"{self.email} | {self.stripe_customer_id}"

ob_dj_store/core/stores/gateway/stripe/utils.py

@@ -0,0 +1,170 @@
+"""
+Stripe Payment Gateway Utilities
+
+This module contains utility functions for Stripe payment integration.
+"""
+
+import logging
+
+import stripe
+from django.conf import settings
+from django.contrib.auth import get_user_model
+from django.core.exceptions import ObjectDoesNotExist, ValidationError
+
+User = get_user_model()
+logger = logging.getLogger(__name__)
+
+# Configure Stripe
+stripe.api_key = settings.STRIPE_SECRET_KEY
+stripe.api_version = settings.STRIPE_API_VERSION
+
+
+class StripeException(Exception):
+    """Custom exception for Stripe-related errors"""
+
+
+def get_or_create_stripe_customer(user):
+    """Get or create a Stripe customer for the user"""
+    from ob_dj_store.core.stores.gateway.stripe.models import StripeCustomer
+
+    try:
+        return StripeCustomer.objects.get(customer=user)
+    except ObjectDoesNotExist:
+        pass
+
+    # Create customer in Stripe
+    try:
+        customer_data = {
+            "name": f"{user.first_name} {user.last_name}".strip(),
+            "email": user.email,
+            "metadata": {"user_id": str(user.id), "platform": "ob-dj-store"},
+        }
+
+        # Add phone if available
+        phone_number = getattr(user, "phone_number", None)
+        if phone_number:
+            customer_data["phone"] = str(phone_number)
+
+        stripe_customer = stripe.Customer.create(**customer_data)
+
+        # Save to database
+        customer_record = StripeCustomer.objects.create(
+            customer=user,
+            stripe_customer_id=stripe_customer.id,
+            first_name=user.first_name,
+            last_name=user.last_name,
+            email=user.email,
+            phone_number=phone_number,
+            init_data=stripe_customer,
+        )
+
+        logger.info(f"Created Stripe customer {stripe_customer.id} for user {user.id}")
+        return customer_record
+
+    except stripe.error.StripeError as e:
+        logger.error(f"Failed to create Stripe customer: {str(e)}")
+        raise StripeException(f"Failed to create customer: {str(e)}")
+
+
+def initiate_stripe_payment(user, payment, currency_code):
+    """Initiate a Stripe PaymentIntent"""
+
+    try:
+        # Get or create Stripe customer
+        stripe_customer = get_or_create_stripe_customer(user)
+
+        # Get the first order for metadata
+        order = payment.orders.first()
+
+        # Prepare PaymentIntent data
+        intent_data = {
+            "amount": int(payment.total_payment * 100),  # Convert to cents
+            "currency": currency_code.lower(),
+            "customer": stripe_customer.stripe_customer_id,
+            "metadata": {
+                "payment_id": str(payment.id),
+                "user_id": str(user.id),
+                "order_id": str(order.id) if order else None,
+                "platform": "ob-dj-store",
+            },
+            "automatic_payment_methods": {"enabled": True,},
+        }
+
+        # Add description
+        if order:
+            intent_data[
+                "description"
+            ] = f"Order #{order.id} from {order.store.name if order.store else 'Store'}"
+
+        # Create PaymentIntent
+        payment_intent = stripe.PaymentIntent.create(**intent_data)
+
+        logger.info(
+            f"Created Stripe PaymentIntent {payment_intent.id} for payment {payment.id}"
+        )
+
+        return {
+            "payment_intent_id": payment_intent.id,
+            "client_secret": payment_intent.client_secret,
+            "status": payment_intent.status,
+            "init_response": payment_intent,
+        }
+
+    except stripe.error.StripeError as e:
+        logger.error(f"Failed to create PaymentIntent: {str(e)}")
+        raise StripeException(f"Failed to initiate payment: {str(e)}")
+
+
+def handle_stripe_webhook(event_data):
+    """Handle Stripe webhook events"""
+    from ob_dj_store.core.stores.gateway.stripe.models import StripePayment
+
+    event_type = event_data.get("type")
+
+    # List of payment_intent events we handle
+    payment_intent_events = [
+        "payment_intent.succeeded",
+        "payment_intent.payment_failed",
+        "payment_intent.canceled",
+        "payment_intent.requires_action",
+        "payment_intent.processing",
+    ]
+
+    if event_type in payment_intent_events:
+        payment_intent = event_data["data"]["object"]
+        payment_intent_id = payment_intent["id"]
+
+        try:
+            stripe_payment = StripePayment.objects.get(
+                payment_intent_id=payment_intent_id
+            )
+            stripe_payment.webhook_update(event_data)
+            logger.info(
+                f"Successfully processed {event_type} for PaymentIntent {payment_intent_id}"
+            )
+            return True
+        except ObjectDoesNotExist:
+            logger.warning(
+                f"Received webhook for unknown PaymentIntent: {payment_intent_id}"
+            )
+            # Return True for unknown payments to acknowledge webhook (don't retry)
+            return True
+
+    # Log unhandled events but return True (acknowledged)
+    logger.info(f"Unhandled Stripe webhook event: {event_type}")
+    return True
+
+
+def verify_webhook_signature(payload, signature):
+    """Verify Stripe webhook signature and return event data"""
+    try:
+        event = stripe.Webhook.construct_event(
+            payload, signature, settings.STRIPE_WEBHOOK_SECRET
+        )
+        return event
+    except ValueError:
+        logger.error("Invalid webhook payload")
+        raise ValidationError("Invalid payload")
+    except stripe.error.SignatureVerificationError:
+        logger.error("Invalid webhook signature")
+        raise ValidationError("Invalid signature")

ob_dj_store/core/stores/gateway/tap/admin.py

@@ -25,9 +25,7 @@ class TapPaymentAdmin(ImportExportModelAdmin, admin.ModelAdmin):
         return (
             super()
             .get_queryset(request)
-            .select_related(
-                "payment__payment_tax",
-            )
+            .select_related("payment__payment_tax",)
             .prefetch_related(
                 "payment__orders__items", "payment__orders__shipping_method"
             )

ob_dj_store/core/stores/gateway/tap/managers.py

@@ -18,11 +18,6 @@ class TapPaymentManager(models.Manager):
         source = kwargs.pop("source")
         payment = kwargs.get("payment")
         user = kwargs.get("user")
-        tap_response = utils.initiate_payment(
-            source,
-            user,
-            payment,
-            payment.currency,
-        )
+        tap_response = utils.initiate_payment(source, user, payment, payment.currency,)
         kwargs = {**tap_response, **kwargs}
         return super(TapPaymentManager, self).create(**kwargs)

ob_dj_store/core/stores/gateway/tap/migrations/0001_initial.py

@@ -127,8 +127,6 @@ class Migration(migrations.Migration):
                     ),
                 ),
             ],
-            options={
-                "verbose_name": "TAP Payment",
-            },
+            options={"verbose_name": "TAP Payment",},
         ),
     ]