Django + Stripe Made Easy

• Subscription management
• Designed for easy implementation of post-registration subscription forms
• Single-unit purchases
• Works with Django >= 1.10
• Works with Python 3.6, 3.5, 3.4, 2.7
• 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
• 100% Tested
• Current API version (2017-06-05), in progress of being updated

Contents

Getting Started

• Installation
  • Get the distribution
  • Configuration
  • Running Tests

Usage

• Checking if a customer has a subscription
• Subscribing a customer to a plan
• Creating a one-off charge for a customer
• Restricting access to only active subscribers
  • Constraining Entire Sites
  • Constraining Class-Based Views
  • Constraining Function-Based Views
  • Don’t do this!
• Managing subscriptions and payment sources
  • Extending subscriptions
• Creating invoices
  • Adding line items to invoices
• Running reports
• Webhooks
• Manually syncing data with Stripe
• Cookbook
  • Customer User Model has_active_subscription property
  • Making individual purchases
  • REST API

Reference

• Context Managers
  • Temporary API Version
• Decorators
  • Standard Decorators
    • Payment Required
  • Event Handling Decorators
    • Specific Event(s) Handler
    • All Events Handler
• Enumerations
  • ApiErrorCode
  • BankAccountHolderType
  • BankAccountStatus
  • CardCheckResult
  • CardBrand
  • CardFundingType
  • CardTokenizationMethod
  • ChargeStatus
  • CouponDuration
  • DisputeReason
  • DisputeStatus
  • PayoutFailureCode
  • PayoutMethod
  • PayoutStatus
  • PayoutType
  • PlanInterval
  • SourceFlow
  • SourceStatus
  • SourceType
  • LegacySourceType
  • SourceUsage
  • SourceCodeVerificationStatus
  • SourceRedirectFailureReason
  • SourceRedirectStatus
  • SubscriptionStatus
• Managers
  • SubscriptionManager
  • TransferManager
  • ChargeManager
• Middleware
  • SubscriptionPaymentMiddleware
• Models
  • Charge
  • Customer
  • Dispute
  • Event
  • Payout
  • BankAccount
  • Card
  • Source
  • Coupon
  • Invoice
  • UpcomingInvoice
  • InvoiceItem
  • Plan
  • Subscription
  • Account
  • Transfer
  • WebhookEventTrigger
• Settings
  • STRIPE_API_VERSION (=‘2017-02-14’)
  • DJSTRIPE_IDEMPOTENCY_KEY_CALLBACK (=djstripe.settings._get_idempotency_key)
  • DJSTRIPE_PRORATION_POLICY (=False)
  • DJSTRIPE_SUBSCRIPTION_REQUIRED_EXCEPTION_URLS (=())
  • DJSTRIPE_SUBSCRIBER_MODEL (=settings.AUTH_USER_MODEL)
  • DJSTRIPE_SUBSCRIBER_MODEL_MIGRATION_DEPENDENCY (=”__first__”)
  • DJSTRIPE_SUBSCRIBER_MODEL_REQUEST_CALLBACK (=None)
  • DJSTRIPE_USE_NATIVE_JSONFIELD (=False)
  • DJSTRIPE_WEBHOOK_URL (=r”^webhook/$”)
  • DJSTRIPE_WEBHOOK_EVENT_CALLBACK (=None)
  • STRIPE_API_HOST (= unset)
• Utilities
  • Subscriber Has Active Subscription Check
  • Supported Currency Choice Generator
  • Clear Expired Idempotency Keys
  • Convert Stripe Timestamp to Datetime
  • Friendly Currency Amount String

Project

• Contributing
  • Types of Contributions
    • Report Bugs
    • Fix Bugs
    • Implement Features
    • Write Documentation
    • Submit Feedback
  • New Modules
  • Get Started!
  • Pull Request Guidelines
• Credits
  • Development Lead
  • Contributors
• History
  • 1.2.4 (2019-02-27)
  • 1.2.3 (2018-10-13)
  • 1.2.2 (2018-08-11)
  • 1.2.1 (2018-07-18)
  • 1.2.0 (2018-06-11)
  • 1.1.0 (2018-06-11)
  • Upgrade notes
    • Migration reset
    • Python 2.7 end-of-life
  • Backwards-incompatible changes and deprecations
    • Removal of polymorphic models
    • Full support for Stripe Sources (Support for v3 stripe.js)
    • Core fields renamed
  • 1.0.0 (2017-08-12)
    • Subscription and InvoiceItem migration is not possible because old records don’t have Stripe IDs (so we can’t sync them). Our approach is to delete all local subscription and invoiceitem objects and re-sync them from Stripe.
    • We 100% recommend you create a backup of your database before performing this upgrade.
      • Other changes
  • 0.8.0 (2015-12-30)
  • 0.7.0 (2015-09-22)
  • 0.6.0 (2015-07-12)
  • 0.5.0 (2015-05-25)
  • 0.4.0 (2015-04-05)
  • 0.3.5 (2014-05-01)
  • 0.3.4 (2014-05-01)
  • 0.3.3 (2014-04-24)
  • 0.3.2 (2014-01-16)
  • 0.3.1 (2013-11-14)
  • 0.3.0 (2013-11-12)
  • 0.2.9 (2013-09-06)
  • 0.2.8 (2013-09-02)
  • 0.2.7 (2013-08-24)
  • 0.2.6 (2013-08-20)
  • 0.2.5 (2013-08-18)
  • 0.2.4 (2013-08-18)
  • 0.2.3 (2013-08-16)
  • 0.2.2 (2013-08-15)
  • 0.2.1 (2013-08-12)
  • 0.2.0 (2013-08-12)
  • 0.1.7 (2013-08-08)
  • 0.1.6 (2013-08-08)
  • 0.1.5 (2013-08-08)
  • 0.1.4 (2013-08-08)
  • 0.1.3 (2013-08-7)
  • 0.1.2 (2013-08-6)
  • 0.1.1 (2013-08-6)
  • 0.1.0 (2013-08-5)
• Support

Constraints

1. For stripe.com only
2. Only use or support well-maintained third-party libraries
3. For modern Python and Django