dj-stripe 0.7.0

Badges

Documentation

The full documentation is at http://dj-stripe.rtfd.org.

Features

• Subscription management

• Designed for easy implementation of post-registration subscription forms

• Single-unit purchases

• Works with Django 1.8, 1.7

• Works with Python 3.4, 2.7

• Works with Bootstrap 3

• Built-in migrations

• Dead-Easy installation

• Leverages the best of the 3rd party Django package ecosystem

• djstripe namespace so you can have more than one payments related app

• Documented (Making good progress)

• 100% Test Coverage

Constraints

1. For stripe.com only

2. Only use or support well-maintained third-party libraries

3. For modern Python and Django

Quickstart

Install dj-stripe:

pip install dj-stripe

Add djstripe to your INSTALLED_APPS:

INSTALLED_APPS +=(
    "djstripe",
)

Add your stripe keys:

STRIPE_PUBLIC_KEY = os.environ.get("STRIPE_PUBLIC_KEY", "<your publishable key>")
STRIPE_SECRET_KEY = os.environ.get("STRIPE_SECRET_KEY", "<your secret key>")

Add some payment plans:

DJSTRIPE_PLANS = {
    "monthly": {
        "stripe_plan_id": "pro-monthly",
        "name": "Web App Pro ($24.99/month)",
        "description": "The monthly subscription plan to WebApp",
        "price": 2499,  # $24.99
        "currency": "usd",
        "interval": "month"
    },
    "yearly": {
        "stripe_plan_id": "pro-yearly",
        "name": "Web App Pro ($199/year)",
        "description": "The annual subscription plan to WebApp",
        "price": 19900,  # $199.00
        "currency": "usd",
        "interval": "year"
    }
}

Add to the urls.py:

url(r'^payments/', include('djstripe.urls', namespace="djstripe")),

Run the commands:

python manage.py migrate

python manage.py djstripe_init_customers

python manage.py djstripe_init_plans

If you haven’t already, add JQuery and the Bootstrap 3.0.0+ JS and CSS to your base template:

<!-- Latest compiled and minified CSS -->
<link rel="stylesheet" href="//netdna.bootstrapcdn.com/bootstrap/3.3.4/css/bootstrap.min.css">

<!-- Optional theme -->
<link rel="stylesheet" href="//netdna.bootstrapcdn.com/bootstrap/3.3.4/css/bootstrap-theme.min.css">

<!-- Latest JQuery (IE9+) -->
<script src="//code.jquery.com/jquery-2.1.4.min.js"></script>

<!-- Latest compiled and minified JavaScript -->
<script src="//netdna.bootstrapcdn.com/bootstrap/3.3.4/js/bootstrap.min.js"></script>

Also, if you don’t have it already, add a javascript block to your base.html file:

{% block javascript %}{% endblock %}

Running the Tests

Assuming the tests are run against PostgreSQL:

createdb djstripe
pip install -r requirements_test.txt
python runtests.py

Follows Best Practices

This project follows best practices as espoused in Two Scoops of Django: Best Practices for Django 1.8.

Similar Projects

• https://github.com/eldarion/django-stripe-payments - The project that dj-stripe forked. It’s an awesome project and worth checking out.

• https://github.com/agiliq/merchant - A single charge payment processing system that also includes many other Gateways. Really nice but doesn’t out-of-the-box handle the use case of subscription payments.

• https://github.com/GoodCloud/django-zebra - One of the first stripe payment systems for Django.

0.7.0 (2015-09-22)

• dj-stripe now responds to the invoice.created event (Thanks @wahuneke)

• dj-stripe now cancels subscriptions and purges customers during sync if they were deleted from the stripe dashboard (Thanks @unformatt)

• dj-stripe now checks for an active stripe subscription in the update_plan_quantity call (Thanks @ctrengove)

• Event processing is now handled by “event handlers” - functions outside of models that respond to various event types and subtypes. Documentation on how to tie into the event handler system coming soon. (Thanks @wahuneke)

• Experimental Python 3.5 support

• Support for Django 1.6 and lower is now officially gone.

• Much, much more!

0.6.0 (2015-07-12)

• Support for Django 1.6 and lower is now deprecated.

• Improved test harness now tests coverage and pep8

• SubscribeFormView and ChangePlanView no longer populate self.error with form errors

• InvoiceItems.plan can now be null (as it is with individual charges), resolving #140 (Thanks @awechsler and @MichelleGlauser for help troubleshooting)

• Email templates are now packaged during distribution.

• sync_plans now takes an optional api_key

• 100% test coverage

• Stripe ID is now returned as part of each model’s str method (Thanks @areski)

• Customer model now stores card expiration month and year (Thanks @jpadilla)

• Ability to extend subscriptions (Thanks @TigerDX)

• Support for plan heirarchies (Thanks @chrissmejia)

• Rest API endpoints for Subscriptions [contrib] (Thanks @philippeluickx)

• Admin interface search by email funtionality is removed (#221) (Thanks @jpadilla)

0.5.0 (2015-05-25)

• Began deprecation of support for Django 1.6 and lower.

• Added formal support for Django 1.8.

• Removed the StripeSubscriptionSignupForm

• Removed djstripe.safe_settings. Settings are now all located in djstripe.settings

• DJSTRIPE_TRIAL_PERIOD_FOR_SUBSCRIBER_CALLBACK can no longer be a module string

• The sync_subscriber argument has been renamed from subscriber_model to subscriber

• Moved available currencies to the DJSTRIPE_CURRENCIES setting (Thanks @martinhill)

• Allow passing of extra parameters to stripe Charge API (Thanks @mthornhill)

• Support for all available arguments when syncing plans (Thanks @jamesbrobb)

• charge.refund() now returns the refunded charge object (Thanks @mthornhill)

• Charge model now has captured field and a capture method (Thanks @mthornhill)

• Subscription deleted webhook bugfix

• South migrations are now up to date (Thanks @Tyrdall)

0.4.0 (2015-04-05)

• Formal Python 3.3+/Django 1.7 Support (including migrations)

• Removed Python 2.6 from Travis CI build. (Thanks @audreyr)

• Dropped Django 1.4 support. (Thanks @audreyr)

• Deprecated the djstripe.forms.StripeSubscriptionSignupForm. Making this form work easily with both dj-stripe and django-allauth required too much abstraction. It will be removed in the 0.5.0 release.

• Add the ability to add invoice items for a customer (Thanks @kavdev)

• Add the ability to use a custom customer model (Thanks @kavdev)

• Added setting to disable Invoice receipt emails (Thanks Chris Halpert)

• Enable proration when customer upgrades plan, and pass proration policy and cancellation at period end for upgrades in settings. (Thanks Yasmine Charif)

• Removed the redundant context processor. (Thanks @kavdev)

• Fixed create a token call in change_card.html (Thanks @dollydagr)

• Fix charge.dispute.closed typo. (Thanks @ipmb)

• Fix contributing docs formatting. (Thanks @audreyr)

• Fix subscription cancelled_at_period_end field sync on plan upgrade (Thanks @nigma)

• Remove “account” bug in Middleware (Thanks @sromero84)

• Fix correct plan selection on subscription in subscribe_form template. (Thanks Yasmine Charif)

• Fix subscription status in account, _subscription_status, and cancel_subscription templates. (Thanks Yasmine Charif)

• Now using user.get_username() instead of user.username, to support custom User models. (Thanks @shvechikov)

• Update remaining DOM Ids for Bootstrap 3. (Thanks Yasmine Charif)

• Update publish command in setup.py. (Thanks @pydanny)

• Explicitly specify tox’s virtual environment names. (Thanks @audreyr)

• Manually call django.setup() to populate apps registry. (Thanks @audreyr)

0.3.5 (2014-05-01)

• Fixed djstripe_init_customers management command so it works with custom user models.

0.3.4 (2014-05-01)

• Clarify documentation for redirects on app_name.

• If settings.DEBUG is True, then django-debug-toolbar is exempt from redirect to subscription form.

• Use collections.OrderedDict to ensure that plans are listed in order of price.

• Add ordereddict library to support Python 2.6 users.

• Switch from __unicode__ to __str__ methods on models to better support Python 3.

• Add python_2_unicode_compatible decorator to Models.

• Check for PY3 so the unicode(self.user) in models.Customer doesn’t blow up in Python 3.

0.3.3 (2014-04-24)

• Increased the extendability of the views by removing as many hard-coded URLs as possible and replacing them with success_url and other attributes/methods.

• Added single unit purchasing to the cookbook

0.3.2 (2014-01-16)

• Made Yasmine Charif a core committer

• Take into account trial days in a subscription plan (Thanks Yasmine Charif)

• Correct invoice period end value (Thanks Yasmine Charif)

• Make plan cancellation and plan change consistently not prorating (Thanks Yasmine Charif)

• Fix circular import when ACCOUNT_SIGNUP_FORM_CLASS is defined (Thanks Dustin Farris)

• Add send e-mail receipt action in charges admin panel (Thanks Buddy Lindsay)

• Add created field to all ModelAdmins to help with internal auditing (Thanks Kulbir Singh)

0.3.1 (2013-11-14)

• Cancellation fix (Thanks Yasmine Charif)

• Add setup.cfg for wheel generation (Thanks Charlie Denton)

0.3.0 (2013-11-12)

• Fully tested against Django 1.6, 1.5, and 1.4

• Fix boolean default issue in models (from now on they are all default to False).

• Replace duplicated code with djstripe.utils.user_has_active_subscription.

0.2.9 (2013-09-06)

• Cancellation added to views.

• Support for kwargs on charge and invoice fetching.

• def charge() now supports send_receipt flag, default to True.

• Fixed templates to work with Bootstrap 3.0.0 column design.

0.2.8 (2013-09-02)

• Improved usage documentation.

• Corrected order of fields in StripeSubscriptionSignupForm.

• Corrected transaction history template layout.

• Updated models to take into account when settings.USE_TZ is disabled.

0.2.7 (2013-08-24)

• Add handy rest_framework permission class.

• Fixing attribution for django-stripe-payments.

• Add new status to Invoice model.

0.2.6 (2013-08-20)

• Changed name of division tag to djdiv.

• Added safe_setting.py module to handle edge cases when working with custom user models.

• Added cookbook page in the documentation.

0.2.5 (2013-08-18)

• Fixed bug in initial checkout

• You can’t purchase the same plan that you currently have.

0.2.4 (2013-08-18)

• Recursive package finding.

0.2.3 (2013-08-16)

• Fix packaging so all submodules are loaded

0.2.2 (2013-08-15)

• Added Registration + Subscription form

0.2.1 (2013-08-12)

• Fixed a bug on CurrentSubscription tests

• Improved usage documentation

• Added to migration from other tools documentation

0.2.0 (2013-08-12)

• Cancellation of plans now works.

• Upgrades and downgrades of plans now work.

• Changing of cards now works.

• Added breadcrumbs to improve navigation.

• Improved installation instructions.

• Consolidation of test instructions.

• Minor improvement to django-stripe-payments documentation

• Added coverage.py to test process.

• Added south migrations.

• Fixed the subscription_payment_required function-based view decorator.

• Removed unnecessary django-crispy-forms

0.1.7 (2013-08-08)

• Middleware excepts all of the djstripe namespaced URLs. This way people can pay.

0.1.6 (2013-08-08)

• Fixed a couple template paths

• Fixed the manifest so we include html, images.

0.1.5 (2013-08-08)

• Fixed the manifest so we include html, css, js, images.

0.1.4 (2013-08-08)

• Change PaymentRequiredMixin to SubscriptionPaymentRequiredMixin

• Add subscription_payment_required function-based view decorator

• Added SubscriptionPaymentRedirectMiddleware

• Much nicer accounts view display

• Much improved subscription form display

• Payment plans can have decimals

• Payment plans can have custom images

0.1.3 (2013-08-7)

• Added account view

• Added Customer.get_or_create method

• Added djstripe_sync_customers management command

• sync file for all code that keeps things in sync with stripe

• Use client-side JavaScript to get history data asynchronously

• More user friendly action views

0.1.2 (2013-08-6)

• Admin working

• Better publish statement

• Fix dependencies

0.1.1 (2013-08-6)

• Ported internals from django-stripe-payments

• Began writing the views

• Travis-CI

• All tests passing on Python 2.7 and 3.3

• All tests passing on Django 1.4 and 1.5

• Began model cleanup

• Better form

• Provide better response from management commands

0.1.0 (2013-08-5)

• First release on PyPI.