django-stripe-marketplace

Production-grade Django app for Stripe marketplace integration with multi-tenant support, webhook handling, and comprehensive audit logging.

Features

• Multi-tenant Support: Manage multiple Stripe accounts from a single Django application
• Webhook Handling: Secure webhook processing with HMAC-SHA256 signature verification
• Subscription Management: Full subscription lifecycle management with trial support
• Payment Processing: Payment intent handling with automatic retries
• Audit Logging: Comprehensive audit trail for all Stripe operations
• Idempotency: Built-in idempotency key generation for safe API calls
• Async Processing: Celery tasks for background synchronization
• Bidirectional Sync: Keep your database in sync with Stripe

Installation

pip install django-stripe-marketplace

Add to your Django settings:

INSTALLED_APPS = [
    # ...
    'stripe_marketplace',
]

STRIPE_MARKETPLACE = {
    'SECRET_KEY': 'sk_test_your_stripe_secret_key',
    'PUBLISHABLE_KEY': 'pk_test_your_stripe_publishable_key',
    'WEBHOOK_SECRET': 'whsec_your_webhook_secret',
    'API_VERSION': '2024-04-10',
    'CURRENCY': 'usd',
}

Run migrations:

python manage.py migrate stripe_marketplace

Quick Start

Setting Up Your Account

python manage.py setup_stripe --account-id acct_your_account_id --business-name "Your Business"

Creating a Customer

from stripe_marketplace.client import StripeClient
from stripe_marketplace.settings import settings_module

client = StripeClient(api_key=settings_module.SECRET_KEY)
customer = client.create_customer(email="customer@example.com")

Syncing Data

python manage.py sync_stripe --account-id acct_your_account_id

Handling Webhooks

Add to your URL configuration:

from django.urls import path, include

urlpatterns = [
    path('stripe/', include('stripe_marketplace.urls')),
]

Configuration

Required Settings

Optional Settings

Models

• StripeAccount: Stripe account configuration
• StripeCustomer: Customer linked to Django user
• StripeProduct: Stripe product
• StripePlan: Subscription plan
• StripeSubscription: Subscription
• StripeInvoice: Invoice
• StripePaymentIntent: Payment intent
• WebhookEvent: Received webhook events
• AuditLog: Audit trail

Development

# Clone the repository
git clone https://github.com/mojnomiya/django-stripe-marketplace.git
cd django-stripe-marketplace

# Create virtual environment
python -m venv venv
source venv/bin/activate

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run linting
flake8 src/
black src/
isort src/

License

MIT License - see LICENSE for details.