Payments System v2.0

# config.py - Simple configuration
from django_cfg.models.payments import PaymentsConfig
 
payments: PaymentsConfig = PaymentsConfig(
    enabled=True,
    nowpayments=NowPaymentsConfig(
        api_key=env.nowpayments.api_key,
        sandbox=True,
        enabled=True
    )
)
 
# Create payments directly with models
from django_cfg.apps.payments.models import Payment, Currency
 
payment = Payment.objects.create(
    user=user,
    amount_usd=Decimal('99.99'),
    currency=Currency.objects.get(code='USDTTRC20'),
    description='Premium subscription'
)

# config.dev.yaml - Environment-specific settings
nowpayments:
  api_key: "your_sandbox_api_key_here"
  ipn_secret: "your_ipn_secret_here"
  sandbox: true

# config.py - Simple Python configuration
payments: PaymentsConfig = PaymentsConfig(
    enabled=True,
    nowpayments=NowPaymentsConfig(
        api_key=env.nowpayments.api_key,
        ipn_secret=env.nowpayments.ipn_secret,
        sandbox=env.nowpayments.sandbox,
        enabled=True
    )
)

from django_cfg.apps.payments.models import (
    Payment,        # Cryptocurrency deposits
    Currency,       # Supported currencies
    UserBalance,    # User balance tracking
    Transaction,    # Immutable transaction records
    WithdrawalRequest  # Manual withdrawals
)
 
# Create a payment
payment = Payment.objects.create(
    user=user,
    amount_usd=Decimal('99.99'),
    currency=Currency.objects.get(code='USDTTRC20'),
    description='Premium subscription'
)
 
# Check user balance
balance = UserBalance.objects.get_or_create_for_user(user)
print(f"Balance: {balance.balance_display}")
 
# View transaction history
transactions = Transaction.objects.filter(user=user).order_by('-created_at')
 
# Request withdrawal
withdrawal = WithdrawalRequest.objects.create(
    user=user,
    amount_usd=Decimal('50.00'),
    currency=Currency.objects.get(code='USDTTRC20'),
    wallet_address='TExampleAddress...'
)

# Admin automatically available when enabled:
payments: PaymentsConfig = PaymentsConfig(enabled=True)
 
# 5 Admin Views Available:
# 1. PaymentAdmin - Manage cryptocurrency deposits
# 2. CurrencyAdmin - Configure supported currencies
# 3. UserBalanceAdmin - Monitor user balances
# 4. TransactionAdmin - Browse transaction history
# 5. WithdrawalRequestAdmin - Approve/reject withdrawals
 
# Features:
# - Create and track payments
# - Monitor user balances
# - Approve withdrawal requests
# - View complete transaction history
# - Configure available currencies

# Pydantic validation for provider configs
from django_cfg.models.payments import PaymentsConfig, NowPaymentsConfig
 
payments = PaymentsConfig(
    enabled=True,
    nowpayments=NowPaymentsConfig(
        api_key=env.nowpayments.api_key,
        ipn_secret=env.nowpayments.ipn_secret,
        sandbox=True,  # Type-checked and validated
        enabled=True
    )
)
 
# Results in:
# - Compile-time type checking
# - Runtime validation
# - Auto-completion in IDEs
# - Configuration errors caught early

# Transactions are immutable - cannot be modified after creation
transaction = Transaction.objects.create(
    user=user,
    transaction_type=Transaction.TransactionType.DEPOSIT,
    amount_usd=Decimal('99.99'),
    balance_after=Decimal('199.99'),
    description='Payment completed'
)
 
# Attempting to modify raises ValidationError
transaction.amount_usd = Decimal('50.00')
transaction.save()  # Raises ValidationError: Transactions are immutable
 
# Balance is calculated from transaction sum
balance = UserBalance.objects.get(user=user)
balance.balance_usd  # Computed from Transaction.objects.filter(user=user).aggregate(Sum('amount_usd'))

from django_cfg.apps.payments.models import Payment, Currency
 
# Create a payment for crypto deposit
payment = Payment.objects.create(
    user=user,
    amount_usd=Decimal('99.99'),
    currency=Currency.objects.get(code='USDTTRC20'),  # USDT on TRC20 network
    description='Premium subscription deposit'
)
 
# Payment is created with:
# - internal_payment_id: Auto-generated unique ID
# - status: 'pending'
# - Provider integration creates payment address
# - User receives QR code and payment address
 
# Admin can poll status from provider:
# payment.status → 'confirming' → 'confirmed' → 'completed'

from django_cfg.apps.payments.models import UserBalance, Transaction
 
# Get or create user balance
balance = UserBalance.objects.get_or_create_for_user(user)
 
# Check current balance
print(f"Current balance: {balance.balance_display}")
print(f"Total deposited: ${balance.total_deposited}")
print(f"Total withdrawn: ${balance.total_withdrawn}")
 
# View transaction history
transactions = Transaction.objects.filter(user=user).order_by('-created_at')
for tx in transactions:
    print(f"{tx.transaction_type}: {tx.amount_display} (Balance: ${tx.balance_after})")
 
# Balance is calculated from transactions:
# balance_usd = SUM(all transactions for user)

from django_cfg.apps.payments.models import WithdrawalRequest, Currency
 
# User requests withdrawal
withdrawal = WithdrawalRequest.objects.create(
    user=user,
    amount_usd=Decimal('50.00'),
    currency=Currency.objects.get(code='USDTTRC20'),
    wallet_address='TExampleWalletAddress123...',
    network_fee_usd=Decimal('1.00'),
    service_fee_usd=Decimal('0.50')
)
# Status: 'pending' - awaits admin approval
 
# Admin reviews in admin interface
# Admin can:
# - Approve: withdrawal.status = 'approved'
# - Reject: withdrawal.status = 'rejected' (with admin_notes)
# - Process: withdrawal.status = 'processing'
 
# After admin sends funds off-platform:
withdrawal.status = 'completed'
withdrawal.transaction_hash = 'blockchain_tx_hash_here'
withdrawal.save()
 
# Transaction automatically created to debit user balance

from django_cfg.apps.payments.models import Currency
 
# List active currencies
currencies = Currency.objects.filter(is_active=True)
 
# Get specific currency
usdt_trc20 = Currency.objects.get(code='USDTTRC20')
print(usdt_trc20.display_name)  # "USDT (TRC20)"
print(usdt_trc20.token)         # "USDT"
print(usdt_trc20.network)       # "TRC20"
 
# Add new currency (typically done via admin)
currency = Currency.objects.create(
    code='USDTERC20',
    name='USDT (ERC20)',
    token='USDT',
    network='ERC20',
    decimal_places=6,
    is_active=True,
    provider='nowpayments',
    min_amount_usd=Decimal('1.00'),
    sort_order=10
)