Set up your development environment

Install

From the command-line, use an install script or download and extract a versioned archive file for your operating system to install the CLI.

brew install stripe/stripe-cli/stripe

brew install stripe-cli

Authenticate

Login and authenticate your Stripe user Account to generate a set of restricted keys. To learn more, see Stripe CLI keys and permissions.

stripe login

Your pairing code is: enjoy-enough-outwit-win
This pairing code verifies your authentication with Stripe.
Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit)

Confirm setup

Now that you’ve installed the CLI, you can make a single API request to Create a product.

stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"

Look for the product identifier (in id) in the response object. Save it for the next step.

If everything worked, the command-line displays the following response.

{
  "id": 
"prod_LTenIrmp8Q67sa",
  "object": "product",

Next, call Create a price to attach a price of 30 USD. Swap the placeholder in product with your product identifier (for example, prod_LTenIrmp8Q67sa).

stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product=
{{PRODUCT_ID}}

If everything worked, the command-line displays the following response.

{
  "id": 
"price_1KzlAMJJDeE9fu01WMJJr79o",
  "object": "price",

We recommend managing third-party dependencies using the venv module, which allows you to add new libraries and include them in your Python 3 projects.

On Windows (cmd.exe):

python3 -m venv env
.\env\Scripts\activate.bat

On GNU/Linux or MacOS (bash):

python3 -m venv env
source env/bin/activate

The latest version of the Stripe Python server-side SDK is v11.0.0. It supports Python versions 3.6+.

Check your Python version:

python3 --version

Install the library

Install the library from PyPi, a package manager for Python:

pip3 install --upgrade stripe

Next, specify the following version in your requirements.txt file:

stripe>=11.0.0

Now that you have the Python SDK installed, you can create a subscription Product and attach a Price with a couple API requests. We’re using the product identifier returned in the response to create the price in this example.

import stripe
stripe.api_key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

starter_subscription = stripe.Product.create(
  name="Starter Subscription",
  description="$12/Month subscription",
)

starter_subscription_price = stripe.Price.create(
  unit_amount=1200,
  currency="usd",
  recurring={"interval": "month"},
  product=starter_subscription['id'],
)

# Save these identifiers
print(f"Success! Here is your starter subscription product id: {starter_subscription.id}")
print(f"Success! Here is your starter subscription price id: {starter_subscription_price.id}")

Save the file as create_price.py. From the command line, cd to the directory containing the file you just saved and run:

python3 create_price.py

If everything worked, the command line shows the following response. Save these identifiers so you can use them while building your integration.

Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb