Installation

Install the package
```
pip install django-solana-payments
```
For DRF support, which provides API endpoints for creating and managing payments, install the drf extra:
```
pip install "django-solana-payments[drf]"
```

Configure `settings.py`

INSTALLED_APPS = [
    ...,
    'django_solana_payments',
]

SOLANA_PAYMENTS = {
    "RPC_URL": "https://api.mainnet-beta.solana.com",
    "RECEIVER_ADDRESS": "YOUR_WALLET_ADDRESS", # Wallet that receives funds
    "FEE_PAYER_KEYPAIR": "WALLET_KEYPAIR", # Wallet keypair that pays network fees (address is derived from keypair)
    # FEE_PAYER_ADDRESS is derived from the keypair and doesn't need to be set separately
    "ONE_TIME_WALLETS_ENCRYPTION_ENABLED": True, # Enables encryption for one-time payments wallets
    "ONE_TIME_WALLETS_ENCRYPTION_KEY": "ONE_TIME_WALLETS_ENCRYPTION_KEY", # Generate with the Fernet.generate_key()
    "SOLANA_PAYMENT_MODEL": "payments.CustomSolanaPayment", # Custom model for solana payment
    "PAYMENT_CRYPTO_TOKEN_MODEL": "payments.CustomPaymentToken", # Custom model for solana payment token
    "RPC_COMMITMENT": "Confirmed", # RPC Commitment
    "PAYMENT_ACCEPTANCE_COMMITMENT": "Confirmed", # Commitment for payment acceptance
    "MAX_ATAS_PER_TX": 8, # Max associated token accounts to create/close per transaction
    "PAYMENT_VALIDITY_SECONDS": 30 * 60, # Payment validity window in seconds (default: 30 minutes)
}

Migrate and Route

python manage.py migrate

# Add this to your urls.py
urlpatterns = [
    path('solana-payments/', include('django_solana_payments.urls')),
]

Create payment tokens (required)

Open the admin panel and create at least one active payment token before initiating payments. A common setup is:
- Native SOL token (token_type=NATIVE, mint_address empty)
- USDC SPL token (token_type=SPL, with the correct USDC mint for your network)
See Payment Tokens for model fields, validation rules, and examples.
Continue with API usage

See DRF API Usage for endpoint details and request examples.