Skip to content
Netlify Docs

Unlimited seats on Netlify Pro for $20/month → Learn more 👥

Stripe Projects

Deploy your Stripe Project to Netlify and streamline your development workflow by provisioning and managing all your site’s services from a single command line interface.

Overview

Section titled “Overview”

Stripe Projects simplifies provisioning and managing services for your app or site directly from the command line with the Stripe Projects CLI. This enables you or your AI agent to quickly set up and manage your project without leaving the command line. You or your agent can deploy your project to Netlify and keep it synced with other services your project needs.

Use cases

Section titled “Use cases”
  • Provisioning and managing services for your app or site directly from the command line
  • Keeping services up to date as your app evolves
  • Connecting supported third-party services to your project without manually copying credentials between dashboards

Learn more about the use cases that Stripe Projects helps with at Stripe Projects use cases recap.

Requirements for using Stripe Projects with Netlify

Section titled “Requirements for using Stripe Projects with Netlify”

To deploy on Netlify, you’ll need the following:

  • A Stripe account
  • Stripe CLI installed or updated
  • Stripe Projects plugin installed
  • Netlify CLI installed or updated
  • A Netlify account (you’ll be redirected to create one if you haven’t already)

Get started

Section titled “Get started”

These docs assume you are setting up a new Stripe Project and deploying it to Netlify. For the most up-to-date setup steps, supported services, and configuration options, check out Stripe’s documentation: Stripe Projects overview

  1. Create a Stripe account if you haven’t already.

  2. Install the Stripe CLI or update it to the latest version. For more comprehensive CLI install instructions, check out the official Stripe Install CLI guide.

    • To install:
    brew install stripe/stripe-cli/stripe
    • To update:
    brew upgrade stripe/stripe-cli/stripe

  3. Install the Projects plugin:

    stripe plugins install projects

  4. Install the Netlify CLI or update it to the latest version:

    npm install -g netlify-cli@latest

  5. From your local project’s directory, create and initialize your app/site with Stripes Projects:

    stripe projects init YOUR_PROJECT_NAME

  6. Link your existing Netlify account or create a new one, and create a new Netlify project:

    stripe projects add netlify/project

After completing the setup prompts you will have your Stripe Project connected to your Netlify account so that it’s ready to deploy.

Authentication with Stripe Projects

Section titled “Authentication with Stripe Projects”

While the Stripe CLI design allows for authentication using the email address of the Stripe account owner or the current user making API calls, Netlify only authenticates users using the user email address that is performing the CLI actions and not the Stripe Account owner.

This ensures the following:

  • Netlify’s integration with Stripe Projects does not authenticate on behalf of the Stripe account owner
  • Stripe users creating accounts with Netlify do not create accounts that authenticate with a different user’s email

After you connect Stripe Projects to your Netlify project, credentials for any services Stripe Projects helps to set up are written to a .env file at the root of your project. If any of these credentials are used by your project, you will need to use the Netlify CLI or UI to manage these environment variables.

Learn more

Section titled “Learn more”