Skip to main content
Connect Stripe from Marketplace to enable the provider in your workspace and make its payment tools available in Brain Studio. Stripe connects using the BYOK (Bring Your Own Key) model, using your own account.

​
Before you begin

Make sure you have:
  • An active Stripe account
  • A Secret API Key (sk_) (Test or Production)
If you don’t have your Secret API Key yet, follow the Obtaining credentials guide.

​
Connect from Marketplace

1

Open Marketplace

In Brain Studio, go to Marketplace from the side menu.You can find Stripe under the Payments & Processing category or by using the search bar.
Stripe in the Marketplace integrations catalog
2

Select Stripe

Click on the Stripe card to open its detail view.
3

Click Install (or Connect)

Click Install.In some UI versions the button may appear as Connect. Both serve the same purpose: initiating the provider connection.
4

Enter your Secret API Key

A modal will open asking for an API Key.
Modal to enter Stripe Secret API Key
Paste your Secret API Key (sk_test_... or sk_live_...) and confirm the installation.
Do not use the Publishable Key (pk_). Brain Studio requires a Secret Key (sk_) to operate correctly.
5

Integration ready to use

Brain Studio will validate the key and connect Stripe to your workspace.
If Stripe appears as installed in Marketplace and its tools are available in Canvas, the integration was enabled successfully.

​
Using Test vs Production credentials

You can connect the integration with:
  • Test Secret Key (sk_test_) → For test or QA environments.
  • Production Secret Key (sk_live_) → To process real payments.
The environment you use will depend on the key entered at the time of installation.
Test keys do not process real payments. Make sure to use Production credentials before going live.

​
Changing the API Key

If you need to move from Test to Production (or rotate credentials):
1

Uninstall the integration

Remove or uninstall Stripe from Marketplace.
2

Reinstall

Repeat the connection process and enter the new Secret API Key.
Once reinstalled, the integration will use the new credentials.

​
Next step

Once the integration is connected, continue with:

Usage and configuration

Configure Stripe tools and handle payment states in your flow.