Zareian
8077ab4350
- Purchase with paymentMethod=bazaar now works for subscription plans with a bazaar_sku (not only packs);
response carries bazaarProductType. Migration subscription.0014 puts 10343/10344 on the 90/180-day plans.
- Verify asks Bazaar for the right product type (from the order) and stores validUntil (payment.0012).
- POST /api/payment/bazaar/orders/{id}/start: SKU, type, and an HS256 dynamic-price JWT when a discount
code lowered the price (BAZAAR_DYNAMIC_PRICE_KEY); discount on Bazaar orders allowed only with that key
and only before start.
- Auto-renewal: sync_bazaar_renewals re-asks Bazaar when the paid period is near its end (status page and
the paywall via has_subscription_access); each new period becomes a paid order.
- Default BAZAAR_PACKAGE_NAME = com.tadrisino.math.app; health shows bazaarDynamicPrice.
979 tests green. No real Bazaar purchase or renewal tested.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
121 lines
8.2 KiB
Python
121 lines
8.2 KiB
Python
from django.db import models
|
||
|
||
|
||
class Order(models.Model):
|
||
"""
|
||
تنها اپی که واقعاً پول جابه‌جا می‌کنه. عمداً از Subscription جدا شده
|
||
چون منطق و ریسکش فرق داره (درگاه، retry، idempotency).
|
||
"""
|
||
# «لغوشده» و «بازپرداخت‌شده» فقط از پنلِ ادمین (actionهای OrderAdmin) گذاشته می‌شوند، از ۲۰۲۶-۱۰-۰۲.
|
||
STATUS_CHOICES = [
|
||
('pending', 'در انتظار'), ('paid', 'پرداخت‌شده'), ('failed', 'ناموفق'),
|
||
('canceled', 'لغوشده'), ('refunded', 'بازپرداخت‌شده'),
|
||
]
|
||
|
||
# 'gateway' و 'bazaar' منطق و صحت‌سنجیِ کاملاً متفاوتی دارن (webhook در
|
||
# برابرِ verifyِ سرور-به-سرور با access_token)؛ برای همین provider جداست
|
||
# از Transaction.gateway (که فقط برای گزارش‌گیریِ درگاهِ واقعیه).
|
||
PROVIDER_CHOICES = [('gateway', 'درگاه پرداخت'), ('bazaar', 'پرداخت درون‌برنامه‌ای بازار')]
|
||
|
||
user_id = models.IntegerField(db_index=True) # ارجاع سبک به accounts.User
|
||
subscription_id = models.IntegerField(null=True, blank=True) # ارجاع سبک به subscription.Subscription
|
||
# پلنی که *این* سفارش برایش پرداخت می‌شود. پیش‌تر پلن فقط روی Subscription
|
||
# بود و با شروعِ یک خریدِ دیگر عوض می‌شد: پرداختِ سفارشِ ماهانه بعد از
|
||
# شروعِ خریدِ سالانه، اشتراکِ سالانه می‌داد (بازتولید شد، ۲۰۲۶-۰۹-۲۵).
|
||
plan_id = models.IntegerField(null=True, blank=True) # ارجاع سبک به subscription.Plan
|
||
# مبلغی که باید پرداخت شود؛ کدِ تخفیف همین را کم می‌کند (discount/views.py).
|
||
amount = models.PositiveIntegerField()
|
||
# عکسِ لحظه‌ی خرید برای فاکتور: قیمتِ پایه پیش از تخفیف و نامِ پلن. بدونِ این،
|
||
# فاکتورِ ماهِ پیش با عوض شدنِ قیمت یا نامِ پلن در ادمین عوض می‌شد. سفارش‌های
|
||
# پیش از ۲۰۲۶-۱۰-۰۱ این دو را ندارند (null / خالی).
|
||
list_price = models.PositiveIntegerField(null=True, blank=True)
|
||
plan_title = models.CharField(max_length=50, blank=True)
|
||
# آنچه این سفارش فروخته، در لحظه‌ی ساخت (create_order). پرداخت و بازپرداخت همین‌ها را می‌دهند و
|
||
# پس می‌گیرند، نه عددهای فعلیِ پلن: پیش‌تر اگر ادمین پلن را بینِ ساختِ سفارش و پرداخت عوض می‌کرد،
|
||
# خریدارِ بسته‌ی ۴۵ هزار تومانی ۱۵۰ سوال می‌گرفت. null یعنی سفارشِ بی‌پلن یا ساخته‌شده پیش از این ستون.
|
||
question_credits = models.PositiveIntegerField(null=True, blank=True)
|
||
hearts_days = models.PositiveIntegerField(null=True, blank=True)
|
||
duration_days = models.PositiveIntegerField(null=True, blank=True)
|
||
currency = models.CharField(max_length=10, default='IRT')
|
||
status = models.CharField(max_length=10, choices=STATUS_CHOICES, default='pending')
|
||
provider = models.CharField(max_length=10, choices=PROVIDER_CHOICES, default='gateway')
|
||
# فقط وقتی provider == 'bazaar' پر می‌شن: SKU محصول درون‌برنامه‌ای تعریف‌شده
|
||
# در پنل بازار، و purchase tokenای که کلاینت اندروید بعد از خرید از SDK
|
||
# بازار می‌گیره و برای verify به بک‌اند می‌فرسته.
|
||
bazaar_product_sku = models.CharField(max_length=100, blank=True)
|
||
bazaar_purchase_token = models.CharField(max_length=300, blank=True)
|
||
# مبلغی (ریال) که در JWTِ «تخفیف پویا» برای همین سفارش امضا شد؛ بعد از آن کدِ تخفیف روی سفارش
|
||
# نمی‌نشیند (همان قاعده‌ی gateway_authority). null یعنی بازار قیمتِ پیشخان را گرفته/می‌گیرد.
|
||
bazaar_price_rial = models.PositiveIntegerField(null=True, blank=True)
|
||
# فقط اشتراکِ بازار: پایانِ دوره‌ای که همین سفارش پولش را داده، از پاسخِ بازار. تمدیدِ خودکار با
|
||
# جلو رفتنِ این عدد در بازار دیده می‌شود (payment.services.sync_bazaar_renewals).
|
||
bazaar_valid_until = models.DateTimeField(null=True, blank=True)
|
||
# فقط وقتی provider == 'gateway' (زرین‌پال) پر می‌شه: Authorityِ برگشتی از
|
||
# PaymentRequest، وقتی کاربر واقعاً لینکِ پرداخت رو باز کنه (نه موقعِ
|
||
# ساختِ سفارش؛ نگاه کنید به PaymentRedirectView). همون چیزیه که زرین‌پال
|
||
# موقعِ callback در query string (Authority=...) برمی‌گردونه، پس برای
|
||
# پیداکردنِ Order از روی callback لازمه.
|
||
gateway_authority = models.CharField(max_length=64, blank=True, db_index=True)
|
||
idempotency_key = models.CharField(max_length=100, unique=True)
|
||
created_at = models.DateTimeField(auto_now_add=True)
|
||
|
||
class Meta:
|
||
ordering = ['-created_at']
|
||
|
||
def __str__(self):
|
||
return f"order-{self.pk}-user{self.user_id}"
|
||
|
||
|
||
class Transaction(models.Model):
|
||
order = models.ForeignKey(Order, on_delete=models.CASCADE, related_name='transactions')
|
||
gateway = models.CharField(max_length=30, default='zarinpal')
|
||
# ۳۰۰ مثلِ Order.bazaar_purchase_token: توکنِ خریدِ بازار همین‌جا می‌نشیند.
|
||
gateway_ref_id = models.CharField(max_length=300, blank=True)
|
||
status = models.CharField(max_length=30)
|
||
paid_at = models.DateTimeField(null=True, blank=True)
|
||
created_at = models.DateTimeField(auto_now_add=True)
|
||
|
||
class Meta:
|
||
ordering = ['created_at']
|
||
constraints = [
|
||
# یکتاییِ سراسریِ (gateway, gateway_ref_id) برای refهای غیرخالی:
|
||
# یک ref مشخص (مثلاً Authorityِ زرین‌پال) فقط می‌تونه متعلقِ یک
|
||
# Order باشه — هم جلوی duplicate رو می‌گیره هم جلوی reuse/replay
|
||
# برای Orderِ دیگه (نگاه کنید به apply_order_payment_result).
|
||
# gateway_ref_id__gt='' یعنی refِ خالی مشمول نیست.
|
||
models.UniqueConstraint(
|
||
fields=['gateway', 'gateway_ref_id'],
|
||
condition=models.Q(gateway_ref_id__gt=''),
|
||
name='uniq_transaction_gateway_ref_global',
|
||
),
|
||
]
|
||
|
||
def __str__(self):
|
||
return f"txn-{self.pk}-order{self.order_id}"
|
||
|
||
|
||
class BazaarCredential(models.Model):
|
||
"""
|
||
refresh tokenِ API بازار، که با اولین «اجازه دادن» در پنل بازار ساخته
|
||
می‌شود. در دیتابیس است نه `.env` تا گرفتنش کسی را مجبور به SSH نکند:
|
||
بازار کاربر را با `?code=` به همان `/api/payment/bazaar/verify`
|
||
برمی‌گرداند (Redirect URIای که در پنل ثبت شده) و ویو خودش code را عوض
|
||
می‌کند. یک ردیف بیشتر ندارد (pk=1).
|
||
|
||
`pending_state`/`pending_since` پنجره‌ی اتصال است: GETِ بی‌پنجره هیچ
|
||
کاری نمی‌کند، تا کسی نتواند با codeِ حسابِ بازارِ خودش توکنِ ما را
|
||
عوض کند. `BAZAAR_REFRESH_TOKEN` در `.env`، اگر باشد، بر این ردیف مقدم است.
|
||
"""
|
||
|
||
refresh_token = models.TextField(blank=True)
|
||
authorized_at = models.DateTimeField(null=True, blank=True)
|
||
pending_state = models.CharField(max_length=64, blank=True)
|
||
pending_since = models.DateTimeField(null=True, blank=True)
|
||
|
||
class Meta:
|
||
verbose_name = 'اتصال به API بازار'
|
||
verbose_name_plural = 'اتصال به API بازار'
|
||
|
||
def __str__(self):
|
||
return 'متصل' if self.refresh_token else 'متصل نیست'
|