django-payments Integration

Install integration support with:

pip install "django-solana-payments[django-payments]"

Configure the provider in PAYMENT_VARIANTS:

PAYMENT_VARIANTS = {
    "solana": (
        "django_solana_payments.integrations.django_payments.SolanaPaymentsProvider",
        {
            "rpc_url": "https://api.devnet.solana.com",
            "supported_wallets": ["phantom", "solflare"],
            "widget_js_path": "solana_payments/solana-payment-widget/widget.js",
            "widget_css_path": "solana_payments/solana-payment-widget/widget.css",
            "verify_poll_interval_ms": 1500,
            "verify_timeout_ms": 45000,
        },
    ),
}

The provider creates or reuses django-solana-payments payment record, renders checkout widget, and uses package verification flow during checkout processing.

Provider settings

These settings belong to the backend PAYMENT_VARIANTS provider config:

• rpc_url (str | None): Solana RPC endpoint used by the widget wallet flow. If omitted, the provider falls back to the package settings value.

• supported_wallets (list[str] | None): built-in wallet names the widget should show. The current built-in set is phantom and solflare.

• widget_js_path (str | None): optional static path or full URL for the widget JavaScript bundle. If omitted, the provider uses the packaged default widget asset path.

• widget_css_path (str | None): optional static path or full URL for the widget stylesheet. If omitted, the provider uses the packaged default widget asset path.

• widget_theme (dict[str, Any] | None): optional theme overrides passed into the frontend widget theme config.

• verify_poll_interval_ms (int): polling interval used by the standalone widget verification flow.

• verify_timeout_ms (int): max time the standalone widget waits before showing a timeout.

• success_statuses (list[str] | None): verification API statuses that the frontend should treat as successful and stop polling on.

For frontend widget_config keys, direct widget mounting, verification defaults, and custom wallet adapters, see Frontend Widget Configuration.