PayPal Integration for Subscriptions in Django 5.1

To integrate PayPal subscriptions with your Django 5.1 website, you have a few options. While there isn't a specific Django app in the provided context that directly handles PayPal subscriptions, you can implement this using PayPal's REST APIs directly.

Recommended Approach

1. Set Up PayPal Developer Account

First, you'll need to set up your PayPal developer account:

1. Create a PayPal Developer account and log in to the Developer Dashboard
2. Get your client ID and client secret from the Apps & Credentials section
3. Set up sandbox accounts for testing (both business and personal accounts)

2. Install Required Packages

BASHCopied
pip install requests

3. Basic Implementation Steps

Here's a simplified approach to implementing PayPal subscriptions in your Django project:

Create a PayPal Client in Django

PYTHONCopied
# paypal/client.py
import requests
import json
from django.conf import settings

class PayPalClient:
    def __init__(self):
        self.client_id = settings.PAYPAL_CLIENT_ID
        self.client_secret = settings.PAYPAL_CLIENT_SECRET
        self.base_url = "https://api-m.sandbox.paypal.com" if settings.PAYPAL_SANDBOX else "https://api-m.paypal.com"
        
    def get_access_token(self):
        url = f"{self.base_url}/v1/oauth2/token"
        headers = {
            "Content-Type": "application/x-www-form-urlencoded",
        }
        data = "grant_type=client_credentials"
        response = requests.post(
            url, 
            auth=(self.client_id, self.client_secret),
            headers=headers,
            data=data
        )
        return response.json().get("access_token")
        
    def create_subscription_plan(self, plan_data):
        url = f"{self.base_url}/v1/billing/plans"
        headers = {
            "Content-Type": "application/json",
            "Authorization": f"Bearer {self.get_access_token()}"
        }
        response = requests.post(url, headers=headers, data=json.dumps(plan_data))
        return response.json()
        
    def create_subscription(self, subscription_data):
        url = f"{self.base_url}/v1/billing/subscriptions"
        headers = {
            "Content-Type": "application/json",
            "Authorization": f"Bearer {self.get_access_token()}"
        }
        response = requests.post(url, headers=headers, data=json.dumps(subscription_data))
        return response.json()

Configure Settings

Add these to your Django settings:

PYTHONCopied
# settings.py
PAYPAL_CLIENT_ID = 'your_client_id'
PAYPAL_CLIENT_SECRET = 'your_client_secret'
PAYPAL_SANDBOX = True  # Set to False for production

Create Views for Subscription Flow

PYTHONCopied
# views.py
from django.shortcuts import render, redirect
from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt
from .paypal.client import PayPalClient

def create_subscription_plan(request):
    paypal_client = PayPalClient()
    
    plan_data = {
        "product_id": "PROD-XXXX",  # You need to create a product first
        "name": "Monthly Subscription",
        "description": "Monthly subscription plan",
        "status": "ACTIVE",
        "billing_cycles": [
            {
                "frequency": {
                    "interval_unit": "MONTH",
                    "interval_count": 1
                },
                "tenure_type": "REGULAR",
                "sequence": 1,
                "total_cycles": 0,
                "pricing_scheme": {
                    "fixed_price": {
                        "value": "9.99",
                        "currency_code": "USD"
                    }
                }
            }
        ],
        "payment_preferences": {
            "auto_bill_outstanding": True,
            "setup_fee": {
                "value": "0",
                "currency_code": "USD"
            },
            "setup_fee_failure_action": "CONTINUE",
            "payment_failure_threshold": 3
        }
    }
    
    response = paypal_client.create_subscription_plan(plan_data)
    return JsonResponse(response)

def subscribe(request, plan_id):
    paypal_client = PayPalClient()
    
    subscription_data = {
        "plan_id": plan_id,
        "application_context": {
            "return_url": request.build_absolute_uri('/subscription/success/'),
            "cancel_url": request.build_absolute_uri('/subscription/cancel/')
        }
    }
    
    response = paypal_client.create_subscription(subscription_data)
    
    # Redirect to PayPal approval URL
    if "links" in response:
        for link in response["links"]:
            if link["rel"] == "approve":
                return redirect(link["href"])
    
    return JsonResponse(response)

@csrf_exempt
def subscription_success(request):
    # Handle successful subscription
    return render(request, 'subscription_success.html')

@csrf_exempt
def subscription_cancel(request):
    # Handle cancelled subscription
    return render(request, 'subscription_cancel.html')

Add URLs

PYTHONCopied
# urls.py
from django.urls import path
from . import views

urlpatterns = [
    path('create-plan/', views.create_subscription_plan, name='create_plan'),
    path('subscribe/<str:plan_id>/', views.subscribe, name='subscribe'),
    path('subscription/success/', views.subscription_success, name='subscription_success'),
    path('subscription/cancel/', views.subscription_cancel, name='subscription_cancel'),
]

Alternative: Third-Party Packages

While not mentioned in the context, you might want to explore these third-party packages:

1. django-paypal - Though it might need customization for subscriptions
2. dj-paypal - Specifically designed for PayPal subscriptions

Webhook Integration

For a complete solution, you should also implement PayPal webhooks to receive notifications about subscription events (payments, cancellations, etc.). This would require:

1. Setting up a webhook endpoint in your Django app
2. Registering the webhook URL in your PayPal Developer Dashboard
3. Processing webhook events to update your database

This basic implementation should get you started with PayPal subscriptions in your Django 5.1 project. You'll need to adapt it to your specific requirements and add proper error handling, database models for storing subscription data, and user interface elements.