Migrate an extension to Stripe Apps

Extensions are legacy apps built on Stripe, available to Stripe users in the Partner Directory. Through OAuth and API requests, they bring payments data into other business tools, like analytics dashboards or data warehouses.

Stripe Apps replaces extensions as the preferred way to integrate Stripe with other tools. Stripe will redirect users from the Partner Directory to discover apps on the Stripe App Marketplace.

After May 24, 2022, you can no longer create new extensions. On August 31, 2022, Stripe will remove all mentions of extensions on the Partner Directory. If you own an extension, migrate to Stripe Apps now to ensure continued discoverability.

Reasons to migrate

Stripe Apps is an upgrade from the current extensions. By migrating, you get the following:

• Better discoverability, with broad visibility in the Stripe Dashboard and the Stripe App Marketplace
• More granular permissions, so you can set (and your users can understand) what data and APIs an app can access
• Interactive functionality, with embedded UI components in the Stripe Dashboard (so users can interact directly with your app without leaving Stripe)
• No interruption to your existing extension users if they choose to migrate

What happens if you don’t migrate

If you choose not to migrate your extension to a Stripe App, your extension will continue to work as it does today, without impact to users until 2024. We’ll continue to support extensions on our backend until the end of 2024. However, new users won’t be able to find any mention of extensions in the Partner Directory starting August 31, 2022.

Stripe Apps vs. extensions

An app can do everything an extension does, with two key additions:

1. Interactive functionality, using embedded UI components in the Stripe Dashboard
2. More granular permissions to help users understand what an app can access

The other difference is that any user can discover apps from the Stripe App Marketplace instead of the Partner Directory.

Impact on your extension’s users

After migrating your extension, your existing users will see a badge in their extension settings page prompting them to re-authenticate. Your users must accept permissions to begin using your migrated app. If they choose not to accept permissions, they can continue to use their extension uninterrupted until 2024.

Migrating lets you keep your existing extension code on the Stripe account you’re already using. You can’t have both an existing extension and a Stripe app on the same Stripe account—you can only have either an extension or an app. If you choose to migrate, you must migrate using the Stripe account linked to your extension. Using the same Stripe account also ensures continuity in the user experience, and users only need to accept a prompt in the Stripe Dashboard to switch from an extension to your new app.

If you don’t want to migrate your extension, and you still want to create an app, you will encounter several restrictions:

• You must create another Stripe account to publish the app.
• The app must have a unique and different purpose than your existing extension’s service.

Migrate to Stripe Apps

Follow the steps below to migrate your extension to a Stripe App.

Migrating an extension to a Stripe App

Before you begin

• To protect your extension’s users while you develop your Stripe App, test and upload your app with a separate or new Stripe account to fully separate the app’s users from your extension’s users.
• To add an extra layer of safety, create a separate testing instance of your backend. While testing your Stripe app, avoid making changes to the backend code powering your live extension.
• After you have fully tested your Stripe app, upload the app to the same Stripe account that links to your extension to submit for App Review.

{
  "id": "evt_X88equMnfsEfTX",
  "livemode": true,
  "object": "event",
  "type": "account.application.authorized",
  "account": "acct_DxW1vvNUscAugD",
  "pending_webhooks": 2,
  "created": 1349654313,
  "data": {...}
}

Add permissions and upload your app

Add permissions to your app manifest and upload your app. After uploading the app, you can use the permission migration tool on the App Details page to view recommended missing permissions. Administrators of your connected accounts must accept these permissions to migrate to your app.

Warning

The permissions model for Stripe Apps will overwrite the global permissions previously accepted by a user that authorized an extension. To ensure your existing users don’t experience permissions related interruptions, you must identify which objects your extension (not your app) calls on the Stripe API to know which permissions to add to your app.

The migration process between your connected account administrator, Stripe, and your extension looks like:

You can find the migration tool by navigating to your app on the App Details page in the Dashboard. The tool exists in multiple locations highlighted below.

Callout and button for unpublished apps

Pushed to overflow menu option when app is published

After your app passes review and you publish your app, your extension’s users must accept permissions in their Dashboard settings to see and use the migrated app. If you add UI extensions, users get redirected to the Stripe App Marketplace to accept changes instead of in the Dashboard.