Repository files navigation

Django + Paddle Made Easy

(this project is heavily inspired bydj-stripe)

dj-paddle implements Paddle models (currently Subscription only), for Django.Set up your webhook and start receiving model updates.You will then have a copy of all Paddle subscriptions available in Django, no API traffic required!

The full documentation is available athttps://dj-paddle.readthedocs.io.

• Django Signals for all incoming webhook events from paddle
• Subscriptions

• Django >= 2.1
• Python >= 3.5

Install dj-paddle:

pip install dj-paddle

Adddjpaddle to yourINSTALLED_APPS:

INSTALLED_APPS=(    ..."djpaddle",    ...)

Add to urls.py:

path("paddle/",include("djpaddle.urls",namespace="djpaddle")),

Tell paddle about the webhook (paddle webhook docs can be foundhere) using the full URL of your endpoint from the urls.py step above (e.g.https://example.com/paddle/webhook/).

Add your paddle keys and set the operating mode:

# can be found at https://vendors.paddle.com/authenticationDJPADDLE_VENDOR_ID='<your-vendor-id>'# create one at https://vendors.paddle.com/authenticationDJPADDLE_API_KEY='<your-api-key>'# can be found at https://vendors.paddle.com/public-keyDJPADDLE_PUBLIC_KEY='<your-public-key>'# More info at https://developer.paddle.com/getting-started/sandboxDJPADDLE_SANDBOX=False

djpaddle includesvendor_id andsandbox template context processors which adds your vendor ID asDJPADDLE_VENDOR_ID and if you want to use the sandbox asDJPADDLE_SANDBOX to each template context:

TEMPLATES= [{    ...'OPTIONS': {        ...'context_processors': [            ...'djpaddle.context_processors.vendor_id','djpaddle.context_processors.sandbox',            ...        ]    }}

Run the commands:

python manage.py migrate# fetches all subscription plans from paddlepython manage.py djpaddle_sync_plans_from_paddle

Next to setup aPaddleJS checkout page

First load in PaddleJS and initialise it by including the dj-paddle PaddleJS template in your own template to load PaddleJS:

{%include"djpaddle_paddlejs.html"%}

Next add a Paddle product or subscription plan into the page context. Below is an example of how to do this using a class based view whereplan_id is passed through as a value from the URL:

fromdjango.confimportsettingsfromdjango.views.genericimportTemplateViewfromdjpaddle.modelsimportPlanclassCheckout(TemplateView):template_name='checkout.html'defget_context_data(self,**kwargs):context=super().get_context_data(**kwargs)context['paddle_plan']=Plan.objects.get(pk=kwargs['plan_id'])# If you have not added 'djpaddle.context_processors.vendor_id' as a template context processorscontext['DJPADDLE_VENDOR_ID']=settings.DJPADDLE_VENDOR_ID# If you have not added 'djpaddle.context_processors.sandbox' as a template context processorscontext['DJPADDLE_SANDBOX']=settings.DJPADDLE_SANDBOXreturncontext

Finally put aBuy Now! button for the plan subscription you added to the context:

<ahref="#!"class="paddle_button"data-product="{{ paddle_plan.id }}">Buy Now!</a>

You can pass data to Paddle JS by add data attributes to the button. For example to set the users email you can use thedata-email attribute:

<ahref="#!"class="paddle_button"data-product="{{ paddle_plan.id }}"data-email="{{ user.email }}" >Buy Now!</a>

A full list of parameters can be found on thePaddleJS parameters page

For more information about options on what to do after a successful checkout please see ourCheckout success documentation

You can override the model that subscriptions are attached to using theDJPADDLE_SUBSCRIBER_MODEL setting. This setting must use the string model reference in the style 'app_label.ModelName'.

The model chosen must have anemail field.

# Defaults to AUTH_USER_MODELDJPADDLE_SUBSCRIBER_MODEL='myapp.MyModel'

Warning: To use this setting you must have already created and ran the initial migration for the app/model before addingdjpadding toINSTALLED_APPS.

Please do not report security issues in public, but email the authors directly.