django-cfg 1.3.7__py3-none-any.whl → 1.3.9__py3-none-any.whl

django_cfg/apps/payments/services/providers/base.py

@@ -5,48 +5,11 @@ Abstract base class for all payment providers with unified interface.
 """
 
 from abc import ABC, abstractmethod
-from typing import Dict, Any, Optional, List
+from typing import Dict, Any, Optional
 from decimal import Decimal
-from pydantic import BaseModel, Field
 from django_cfg.modules.django_logger import get_logger
 from ..types import ProviderResponse, ServiceOperationResult
-
-
-class ProviderConfig(BaseModel):
-    """
-    Base provider configuration.
-    
-    Common configuration fields for all payment providers.
-    """
-    
-    provider_name: str = Field(description="Provider name")
-    api_key: str = Field(description="Provider API key")
-    api_url: str = Field(description="Provider API URL")
-    sandbox: bool = Field(default=False, description="Sandbox mode")
-    timeout: int = Field(default=30, description="Request timeout in seconds")
-    retry_attempts: int = Field(default=3, description="Number of retry attempts")
-    retry_delay: int = Field(default=5, description="Delay between retries in seconds")
-    min_amount_usd: float = Field(default=1.0, description="Minimum amount in USD")
-    max_amount_usd: float = Field(default=50000.0, description="Maximum amount in USD")
-    supported_currencies: List[str] = Field(default_factory=list, description="Supported currencies")
-    webhook_secret: Optional[str] = Field(None, description="Webhook secret for validation")
-
-
-class PaymentRequest(BaseModel):
-    """
-    Universal payment request for providers.
-    
-    Standardized payment creation request across all providers.
-    """
-    
-    amount_usd: float = Field(gt=0, description="Amount in USD")
-    currency_code: str = Field(description="Cryptocurrency code")
-    order_id: str = Field(description="Internal order/payment ID")
-    callback_url: Optional[str] = Field(None, description="Success callback URL")
-    cancel_url: Optional[str] = Field(None, description="Cancel URL")
-    description: Optional[str] = Field(None, description="Payment description")
-    customer_email: Optional[str] = Field(None, description="Customer email")
-    metadata: Dict[str, Any] = Field(default_factory=dict, description="Additional metadata")
+from .models import ProviderConfig, PaymentRequest
 
 
 class BaseProvider(ABC):
@@ -77,6 +40,89 @@ class BaseProvider(ABC):
         """Check if provider is in sandbox mode."""
         return self.config.sandbox
     
+    # Provider configuration methods (to be overridden by specific providers)
+    def get_fee_percentage(self, currency_code: str = None, currency_type: str = None) -> Decimal:
+        """
+        Get fee percentage for currency.
+        
+        Args:
+            currency_code: Currency code (e.g., 'BTC', 'ETH')
+            currency_type: Currency type ('fiat', 'crypto')
+            
+        Returns:
+            Fee percentage as decimal (0.005 = 0.5%)
+        """
+        return Decimal('0.005')  # Default 0.5%
+    
+    def get_fixed_fee_usd(self, currency_code: str = None, currency_type: str = None) -> Decimal:
+        """
+        Get fixed fee in USD for currency.
+        
+        Args:
+            currency_code: Currency code (e.g., 'BTC', 'ETH')
+            currency_type: Currency type ('fiat', 'crypto')
+            
+        Returns:
+            Fixed fee in USD
+        """
+        return Decimal('0.0')  # Default no fixed fee
+    
+    def get_min_amount_usd(self, currency_code: str = None, currency_type: str = None, is_stable: bool = False) -> Decimal:
+        """
+        Get minimum amount in USD for currency.
+        
+        Args:
+            currency_code: Currency code (e.g., 'BTC', 'ETH')
+            currency_type: Currency type ('fiat', 'crypto')
+            is_stable: Whether currency is a stablecoin
+            
+        Returns:
+            Minimum amount in USD
+        """
+        if currency_type == 'fiat':
+            return Decimal('1.0')
+        elif is_stable:
+            return Decimal('0.01')
+        else:
+            return Decimal('0.000001')
+    
+    def get_max_amount_usd(self, currency_code: str = None, currency_type: str = None) -> Decimal:
+        """
+        Get maximum amount in USD for currency.
+        
+        Args:
+            currency_code: Currency code (e.g., 'BTC', 'ETH')
+            currency_type: Currency type ('fiat', 'crypto')
+            
+        Returns:
+            Maximum amount in USD
+        """
+        return Decimal('1000000.0')  # Default 1M USD
+    
+    def get_confirmation_blocks(self, network_code: str) -> int:
+        """
+        Get confirmation blocks for network.
+        
+        Args:
+            network_code: Network code (e.g., 'btc', 'eth')
+            
+        Returns:
+            Number of confirmation blocks
+        """
+        return 1  # Default 1 confirmation
+    
+    def get_network_name(self, network_code: str) -> str:
+        """
+        Get human-readable network name.
+        
+        Args:
+            network_code: Network code (e.g., 'btc', 'eth')
+            
+        Returns:
+            Human-readable network name
+        """
+        return network_code.upper() if network_code else 'Unknown'
+    
     @abstractmethod
     def create_payment(self, request: PaymentRequest) -> ProviderResponse:
         """
@@ -113,6 +159,16 @@ class BaseProvider(ABC):
         """
         pass
     
+    @abstractmethod
+    def sync_currencies_to_db(self):
+        """
+        Sync currencies from provider API to database.
+        
+        Returns:
+            CurrencySyncResult: Synchronization result
+        """
+        pass
+    
     @abstractmethod
     def validate_webhook(self, payload: Dict[str, Any], signature: str = None) -> ServiceOperationResult:
         """

django_cfg/apps/payments/services/providers/models/__init__.py

@@ -0,0 +1,40 @@
+"""
+Universal provider models for Universal Payment System v2.0.
+
+Common models used across all payment providers.
+"""
+
+from .base import (
+    ProviderConfig,
+    PaymentRequest,
+    ProviderMetadata,
+    ProviderType,
+    ProviderStatus
+)
+from .universal import (
+    UniversalCurrency,
+    UniversalCurrenciesResponse,
+    CurrencySyncResult
+)
+from .providers import (
+    ProviderEnum,
+    PROVIDER_METADATA
+)
+
+__all__ = [
+    # Base models
+    'ProviderConfig',
+    'PaymentRequest',
+    'ProviderMetadata',
+    'ProviderType',
+    'ProviderStatus',
+    
+    # Universal models
+    'UniversalCurrency',
+    'UniversalCurrenciesResponse',
+    'CurrencySyncResult',
+    
+    # Provider definitions
+    'ProviderEnum',
+    'PROVIDER_METADATA'
+]

django_cfg/apps/payments/services/providers/models/base.py

@@ -0,0 +1,122 @@
+"""
+Base provider models for Universal Payment System v2.0.
+
+Core Pydantic models for provider configuration and requests.
+"""
+
+from typing import Dict, Any, Optional, List
+from decimal import Decimal
+from pydantic import BaseModel, Field, ConfigDict
+from enum import Enum
+
+
+class ProviderType(str, Enum):
+    """Provider type classification."""
+    
+    CRYPTO = "crypto"
+    FIAT = "fiat"
+    HYBRID = "hybrid"  # Supports both fiat and crypto
+
+
+class ProviderStatus(str, Enum):
+    """Provider operational status."""
+    
+    ACTIVE = "active"
+    MAINTENANCE = "maintenance"
+    DEPRECATED = "deprecated"
+    DISABLED = "disabled"
+
+
+class ProviderConfig(BaseModel):
+    """
+    Base provider configuration with Pydantic v2.
+    
+    Common configuration fields for all payment providers.
+    """
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="forbid",
+        str_strip_whitespace=True,
+        frozen=False
+    )
+    
+    provider_name: str = Field(..., description="Provider name")
+    api_key: str = Field(..., description="Provider API key")
+    api_url: str = Field(..., description="Provider API URL")
+    enabled: bool = Field(default=True, description="Whether provider is enabled")
+    sandbox: bool = Field(default=False, description="Sandbox mode")
+    sandbox_mode: bool = Field(default=False, description="Sandbox mode (alias for sandbox)")
+    timeout: int = Field(default=30, ge=5, le=300, description="Request timeout in seconds")
+    retry_attempts: int = Field(default=3, ge=0, le=10, description="Number of retry attempts")
+    retry_delay: int = Field(default=5, ge=1, le=60, description="Delay between retries in seconds")
+    min_amount_usd: float = Field(default=1.0, ge=0.01, description="Minimum amount in USD")
+    max_amount_usd: float = Field(default=50000.0, ge=1.0, description="Maximum amount in USD")
+    supported_currencies: List[str] = Field(default_factory=list, description="Supported currencies")
+    webhook_secret: Optional[str] = Field(None, description="Webhook secret for validation")
+
+
+class PaymentRequest(BaseModel):
+    """
+    Universal payment request for providers with Pydantic v2.
+    
+    Standardized payment creation request across all providers.
+    """
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="forbid",
+        str_strip_whitespace=True
+    )
+    
+    amount_usd: float = Field(..., gt=0, description="Amount in USD")
+    currency_code: str = Field(..., min_length=3, max_length=10, description="Currency code")
+    order_id: str = Field(..., min_length=1, max_length=100, description="Internal order/payment ID")
+    callback_url: Optional[str] = Field(None, description="Success callback URL")
+    cancel_url: Optional[str] = Field(None, description="Cancel URL")
+    description: Optional[str] = Field(None, max_length=500, description="Payment description")
+    customer_email: Optional[str] = Field(None, description="Customer email")
+    metadata: Dict[str, Any] = Field(default_factory=dict, description="Additional metadata")
+
+
+class ProviderMetadata(BaseModel):
+    """
+    Provider metadata with classification and features.
+    
+    Contains provider-specific information for routing and display.
+    """
+    model_config = ConfigDict(
+        validate_assignment=True,
+        extra="forbid",
+        frozen=True  # Metadata should be immutable
+    )
+    
+    name: str = Field(..., description="Human-readable provider name")
+    provider_type: ProviderType = Field(..., description="Provider type (crypto/fiat/hybrid)")
+    status: ProviderStatus = Field(default=ProviderStatus.ACTIVE, description="Provider status")
+    priority: int = Field(default=100, ge=0, le=1000, description="Provider priority (lower = higher priority)")
+    
+    # Feature flags
+    supports_fiat: bool = Field(default=False, description="Supports fiat currencies")
+    supports_crypto: bool = Field(default=True, description="Supports cryptocurrencies")
+    supports_webhooks: bool = Field(default=True, description="Supports webhook notifications")
+    supports_refunds: bool = Field(default=False, description="Supports payment refunds")
+    supports_partial_payments: bool = Field(default=False, description="Supports partial payments")
+    
+    # Limits and fees
+    min_amount_usd: float = Field(default=1.0, ge=0.01, description="Minimum payment amount in USD")
+    max_amount_usd: float = Field(default=50000.0, ge=1.0, description="Maximum payment amount in USD")
+    fee_percentage: float = Field(default=0.0, ge=0.0, le=100.0, description="Fee percentage")
+    fixed_fee_usd: float = Field(default=0.0, ge=0.0, description="Fixed fee in USD")
+    
+    # Geographic and regulatory
+    supported_countries: List[str] = Field(default_factory=list, description="Supported country codes")
+    restricted_countries: List[str] = Field(default_factory=list, description="Restricted country codes")
+    requires_kyc: bool = Field(default=False, description="Requires KYC verification")
+    
+    # Technical details
+    api_version: str = Field(default="v1", description="API version")
+    documentation_url: Optional[str] = Field(None, description="API documentation URL")
+    status_page_url: Optional[str] = Field(None, description="Provider status page URL")
+    
+    # Additional metadata
+    tags: List[str] = Field(default_factory=list, description="Provider tags for categorization")
+    description: Optional[str] = Field(None, max_length=500, description="Provider description")

django_cfg/apps/payments/services/providers/models/providers.py

@@ -0,0 +1,87 @@
+"""
+Provider enums and metadata for Universal Payment System v2.0.
+
+Provider definitions with comprehensive metadata.
+"""
+
+from enum import Enum
+from typing import List, Dict
+from .base import ProviderMetadata, ProviderType, ProviderStatus
+
+
+class ProviderEnum(Enum):
+    """Enumeration of supported payment providers."""
+    
+    NOWPAYMENTS = "nowpayments"
+
+    @classmethod
+    def get_all_providers(cls) -> List[str]:
+        """Get list of all provider values."""
+        return [provider.value for provider in cls]
+    
+    @classmethod
+    def is_valid_provider(cls, provider_name: str) -> bool:
+        """Check if provider name is valid."""
+        return provider_name in cls.get_all_providers()
+    
+    @classmethod
+    def get_crypto_providers(cls) -> List[str]:
+        """Get list of crypto-supporting providers."""
+        return [
+            provider.value for provider in cls
+            if PROVIDER_METADATA[provider.value].supports_crypto
+        ]
+    
+    @classmethod
+    def get_fiat_providers(cls) -> List[str]:
+        """Get list of fiat-supporting providers."""
+        return [
+            provider.value for provider in cls
+            if PROVIDER_METADATA[provider.value].supports_fiat
+        ]
+    
+    @classmethod
+    def get_active_providers(cls) -> List[str]:
+        """Get list of active providers."""
+        return [
+            provider.value for provider in cls
+            if PROVIDER_METADATA[provider.value].status == ProviderStatus.ACTIVE
+        ]
+
+
+# Provider metadata registry
+PROVIDER_METADATA: Dict[str, ProviderMetadata] = {
+    ProviderEnum.NOWPAYMENTS.value: ProviderMetadata(
+        name="NowPayments",
+        provider_type=ProviderType.CRYPTO,
+        status=ProviderStatus.ACTIVE,
+        priority=10,  # High priority
+        
+        # Features
+        supports_fiat=False,
+        supports_crypto=True,
+        supports_webhooks=True,
+        supports_refunds=False,
+        supports_partial_payments=False,
+        
+        # Limits and fees
+        min_amount_usd=1.0,
+        max_amount_usd=50000.0,
+        fee_percentage=0.5,  # 0.5% fee
+        fixed_fee_usd=0.0,
+        
+        # Geographic
+        supported_countries=[],  # Global support
+        restricted_countries=["US"],  # Example restriction
+        requires_kyc=False,
+        
+        # Technical
+        api_version="v1",
+        documentation_url="https://documenter.getpostman.com/view/7907941/S1a32n38",
+        status_page_url="https://status.nowpayments.io/",
+        
+        # Additional
+        tags=["crypto", "bitcoin", "ethereum", "altcoins", "instant"],
+        description="Cryptocurrency payment processor supporting 300+ cryptocurrencies with instant settlements"
+    )
+}

django_cfg/apps/payments/services/providers/models/universal.py

@@ -0,0 +1,48 @@
+"""
+Universal models for cross-provider compatibility.
+
+These models provide a standardized interface across different payment providers.
+"""
+
+from pydantic import BaseModel, Field, ConfigDict
+from typing import Optional, List
+
+
+class UniversalCurrency(BaseModel):
+    """Universal currency representation for cross-provider compatibility."""
+    model_config = ConfigDict(validate_assignment=True, extra="forbid")
+    
+    provider_currency_code: str = Field(..., description="Provider-specific currency code")
+    base_currency_code: str = Field(..., description="Base currency code (e.g., BTC, USDT)")
+    network_code: Optional[str] = Field(None, description="Network code (e.g., eth, bsc, tron)")
+    name: str = Field(..., description="Human-readable currency name")
+    currency_type: str = Field(..., description="Currency type (fiat, crypto, metal)")
+    is_enabled: bool = Field(default=True, description="Whether currency is enabled")
+    is_popular: bool = Field(default=False, description="Whether currency is popular")
+    is_stable: bool = Field(default=False, description="Whether currency is a stablecoin")
+    priority: int = Field(default=0, description="Currency priority for sorting")
+    logo_url: str = Field(default="", description="Currency logo URL")
+    available_for_payment: bool = Field(default=True, description="Available for payment")
+    available_for_payout: bool = Field(default=True, description="Available for payout")
+    min_payment_amount: Optional[float] = Field(None, description="Minimum payment amount in USD")
+    raw_data: dict = Field(default_factory=dict, description="Raw provider data")
+
+
+class UniversalCurrenciesResponse(BaseModel):
+    """Response containing list of universal currencies."""
+    model_config = ConfigDict(validate_assignment=True, extra="forbid")
+    
+    currencies: List[UniversalCurrency] = Field(default_factory=list, description="List of currencies")
+
+
+class CurrencySyncResult(BaseModel):
+    """Result of currency synchronization operation."""
+    model_config = ConfigDict(validate_assignment=True, extra="forbid")
+    
+    currencies_created: int = Field(default=0, description="Number of currencies created")
+    currencies_updated: int = Field(default=0, description="Number of currencies updated")
+    networks_created: int = Field(default=0, description="Number of networks created")
+    provider_currencies_created: int = Field(default=0, description="Number of provider currencies created")
+    provider_currencies_updated: int = Field(default=0, description="Number of provider currencies updated")
+    errors: List[str] = Field(default_factory=list, description="List of errors encountered")
+    total_processed: int = Field(default=0, description="Total currencies processed")

django_cfg/apps/payments/services/providers/nowpayments/__init__.py

@@ -0,0 +1,31 @@
+"""
+NowPayments provider package for Universal Payment System v2.0.
+
+Comprehensive NowPayments integration with currency synchronization.
+"""
+
+from .provider import NowPaymentsProvider
+from .models import (
+    NowPaymentsProviderConfig,
+    NowPaymentsCurrency,
+    NowPaymentsFullCurrenciesResponse,
+    NowPaymentsPaymentRequest,
+    NowPaymentsPaymentResponse,
+    NowPaymentsWebhook,
+    NowPaymentsStatusResponse
+)
+from .sync import NowPaymentsCurrencySync
+from .config import NowPaymentsConfig as Config
+
+__all__ = [
+    'NowPaymentsProvider',
+    'NowPaymentsProviderConfig',
+    'NowPaymentsCurrency', 
+    'NowPaymentsFullCurrenciesResponse',
+    'NowPaymentsPaymentRequest',
+    'NowPaymentsPaymentResponse',
+    'NowPaymentsWebhook',
+    'NowPaymentsStatusResponse',
+    'NowPaymentsCurrencySync',
+    'Config'
+]

django_cfg/apps/payments/services/providers/nowpayments/config.py

@@ -0,0 +1,70 @@
+"""
+NowPayments provider configuration.
+
+Simple configuration constants for NowPayments provider.
+"""
+
+from decimal import Decimal
+
+# NowPayments configuration constants
+class NowPaymentsConfig:
+    """Simple NowPayments configuration."""
+    
+    # Fees
+    FEE_PERCENTAGE = Decimal('0.005')  # 0.5%
+    FIXED_FEE_USD = Decimal('0.0')     # No fixed fee
+    
+    # Limits
+    MIN_AMOUNT_USD = Decimal('0.000001')  # Minimum for all crypto
+    MAX_AMOUNT_USD = Decimal('1000000.0')
+    
+    # Network names
+    NETWORK_NAMES = {
+        'eth': 'Ethereum',
+        'bsc': 'Binance Smart Chain', 
+        'matic': 'Polygon',
+        'trx': 'TRON',
+        'btc': 'Bitcoin',
+        'ltc': 'Litecoin',
+        'sol': 'Solana',
+        'avaxc': 'Avalanche C-Chain',
+        'arbitrum': 'Arbitrum',
+        'op': 'Optimism',
+        'base': 'Base',
+        'ton': 'TON',
+        'near': 'NEAR',
+        'algo': 'Algorand',
+        'xtz': 'Tezos',
+        'dot': 'Polkadot',
+        'ada': 'Cardano',
+        'xlm': 'Stellar',
+        'xrp': 'Ripple',
+        'atom': 'Cosmos',
+        'luna': 'Terra',
+        'neo': 'Neo',
+        'waves': 'Waves',
+    }
+    
+    # Confirmation blocks
+    CONFIRMATION_BLOCKS = {
+        'btc': 1,
+        'eth': 12,
+        'bsc': 3,
+        'matic': 20,
+        'trx': 19,
+    }
+    
+    @classmethod
+    def get_network_name(cls, network_code: str) -> str:
+        """Get human-readable network name."""
+        return cls.NETWORK_NAMES.get(network_code.lower(), network_code.upper())
+    
+    @classmethod
+    def get_confirmation_blocks(cls, network_code: str) -> int:
+        """Get confirmation blocks for network."""
+        return cls.CONFIRMATION_BLOCKS.get(network_code.lower(), 1)
+    
+    @classmethod
+    def get_min_amount(cls) -> Decimal:
+        """Get minimum amount for all currencies."""
+        return cls.MIN_AMOUNT_USD