Create account
Sign in
Home
Payments
Business operations
Financial services
Developer tools
Security
All products
Home
Payments
Business operations
Home
Payments
Business operations
Financial services
Developer tools
Support
Overview
Quickstart
Stripe CLI
Listen to webhooks
Test and monitor your integration
Configure
Reference
Stripe for Visual Studio Code
Webhooks
File uploads
Error handling
Error codes
API
Keys
Libraries
Upgrades
Rate limits
Card testing
Expanding responses
Domains and IP addresses
Building With Stripe
Stripe.js and Elements
Prebuilt iOS UI
Prebuilt Android UI
Extensions
Plugins
Samples
Checklist
HomeDeveloper tools

Stripe CLI

Build, test, and manage your Stripe integration right from the terminal.

The Stripe CLI is a developer tool to help you help build, test, and manage your integration with Stripe directly from your terminal. The Stripe CLI is easy to install, works on macOS, Windows, and Linux, and offers you a range of functionality to make your developer experience with Stripe better.

Want to see how the Stripe CLI works or help develop it? Check out the project on GitHub.

With the Stripe CLI, you can:

  • Securely test webhooks without relying on third-party tunneling software
  • Trigger webhook events to easily test your integration
  • Receive API request logs locally
  • Create, retrieve, update, and delete API objects

Follow the steps below to get started with the Stripe CLI.

Install the Stripe CLI

To install the Stripe CLI with homebrew, run:

Terminal
brew install stripe/stripe-cli/stripe

Login with your Stripe account

After installing the Stripe CLI, you must pair it with your Stripe account. To do so, run stripe login in the terminal. You’ll be prompted to launch your browser and login to the Stripe Dashboard to grant the Stripe CLI access to your account.

Terminal
stripe login
Output
Your pairing code is: humour-nifty-finer-magic Press Enter to open up the browser (^C to quit)

Pairing generates a pair of secret API keys—one test mode, one live mode—that are valid for 90 days. You can also manually delete the key under API Keys in the Dashboard (e.g., when you’re done using the Stripe CLI). If you’re in an environment that doesn’t have a browser, a URL will be printed to use outside of that environment.

Run your first command

You are now ready to use the Stripe CLI, and to get started you can run your first command to create a customer by running:

Terminal
stripe customers create

This command creates a new customer on Stripe and returns the raw Customer object as JSON.

See also

  • Listen to webhooks events
  • Test and monitor your integration
  • Configure the Stripe CLI
  • Stripe CLI Reference
Was this page helpful?
Questions? Contact us.
Developer tutorials on YouTube.
You can unsubscribe at any time. Read our privacy policy.
On this page
Install the Stripe CLI
Login with your Stripe account
Run your first command