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

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

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
Easily adding payment processing capabilities to your application

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

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

Create a Stripe account and install the Stripe CLI.
Install or update the Netlify CLI.
From your local project’s directory, create and initialize your app/site with Stripe Projects:
```
stripe projects init YOUR_PROJECT_NAME
```
Link your existing Netlify account or create a new one, and create a new Netlify project:
```
stripe projects add netlify/project
```

At this point, Stripe Projects has created a Netlify project linked to your account, but no content has been deployed to it yet.

To deploy, prompt your AI agent to build your application and deploy it to Netlify. Once it does, your site will be live with the Stripe API key (and any other credentials Stripe Projects set up) already wired into your Netlify project’s environment variables — no manual configuration needed.

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

Did you find this doc useful?

Your feedback helps us improve our docs.