# Stripe app for Salesforce Platform installation

Install and configure the Stripe app for Salesforce Platform.

> **For existing users considering an upgrade to the latest version**: As of version `1.17` of the Stripe app for Salesforce Platform, OAuth-based authentication is no longer offered. To migrate your Stripe account from OAuth to API key authentication, simply choose `Reauthorize using API key` under `Account Management` and enter your Stripe API keys.

## Before you begin

- Identify the environment where you want to install your app. We provide separate installation options for test and production environments.
- You can install this application from the [Salesforce AppExchange](https://appexchange.salesforce.com/appxListingDetail?listingId=4dff0f8e-0b10-47c2-a3a3-f3905e7f7927).
- For users in Japan, [AppExchange Japan](https://appexchangejp.salesforce.com/appxListingDetail?listingId=a0N3u00000RgdoWEAR) is also available.
- Make sure to enable `Lightning Web Security`. To do so, go to **Setup** > **Session Management** > **Session Settings**.

1. Log into the Salesforce organization where you want to install the package.
1. After logging in, you’re directed to the installation page. Click **Continue** to begin the installation process.
1. We recommend installing **Install for Admins Only**. This option allows for controlling access and permissions after the package has been installed. ![](https://b.stripecdn.com/docs-statics-srv/assets/SFU_AdminOnly.39c4e7785aaaacfa3a88ffd07b8d2aa1.png)
1. **Approve Third-Party Access** check off the box and click **Continue** to start the package installation when the modal appears. As it states, this is to allow data to be sent back and forth between your Salesforce org and the Stripe PBO. ![](https://b.stripecdn.com/docs-statics-srv/assets/SFU_3rdPartyAccess.f4fbd0b81b4316d943bb05bd522e07e8.png)

## Stripe for Salesforce Platform setup wizard

When users first access the Stripe app for Salesforce app, they must complete an Initial Setup flow. This guided wizard flow helps users authorize an org, add a Stripe account, and configure sync preferences. After completing the initial setup, the Account Management tab becomes the users’ landing page. Here, they can add more Stripe accounts or go to other tabs to edit configuration settings.

### Add a Stripe account using the setup wizard

1. Launch the initial setup wizard, and go to **App Launcher > Stripe for Salesforce Platform** ![](https://b.stripecdn.com/docs-statics-srv/assets/sfPlatform_app_launcher.1e09ddf1553eadb08eb896da3b1131cb.png)
1. Click the **Get Started** button. ![](https://b.stripecdn.com/docs-statics-srv/assets/SFU_AppGetStarted.78464fbff085da988de93c2d6de890d6.png)
1. Click the **Authorize** button. ![](https://b.stripecdn.com/docs-statics-srv/assets/SFU_AppGetStartedAuthorize.fe176d8502ff431cb46fe4bcb5ab59fb.png)
1. After the new window opens, click **Allow** to grant access for your org.
1. Click the **Next** button. ![](https://b.stripecdn.com/docs-statics-srv/assets/SFU_AppGetStartedAuthorizeNext.a696556bd86ed09857ef170e9032d39d.png)
1. Input your Stripe [publishable key](https://docs.stripe.com/keys.md) and [restricted access key](https://docs.stripe.com/keys.md), and click **Add Account** to add the Stripe account. ![](https://b.stripecdn.com/docs-statics-srv/assets/sf_platform_app_RAK_Add.db3650bc8a29a66752e14a975f5bf907.png)
1. After you select an account, click the **Next** button. ![](https://b.stripecdn.com/docs-statics-srv/assets/SFU_AppGetStartedAuthorizeAccountNext.ded02a21b3970c98af817266ea1e30fe.png)
1. (Optional) Click the **toggle** if you wish to enable the Stripe Events and Sync Logs cleanup.
1. If the cleanup trigger is active, enter the numerical value in the input box to set the desired amount of records to be retained in the Salesforce org.
1. Click the **Next** button. ![](https://b.stripecdn.com/docs-statics-srv/assets/SFU_AppGetStartedRecordClean.e53021fe6e2fd9ff9270215033c35f00.png)
1. Click the **Stripe API Version** dropdown and install the `2025-04-30` version
1. Click the **Install Package** button, which launches another window that you need to use to complete the installation of the extension package.
1. Click **Finish**

## See also

- [Configuration](https://docs.stripe.com/use-stripe-apps/stripe-app-for-salesforce/configuration.md)
- [Configure events](https://docs.stripe.com/use-stripe-apps/stripe-app-for-salesforce/configure-events.md)
- [Training](https://docs.stripe.com/use-stripe-apps/stripe-app-for-salesforce/training.md)