> For the complete documentation index, see [llms.txt](https://docs.getsphere.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getsphere.com/features/integrations/prebuilt-connectors/stripe-integration-flexible.md).

# Stripe Integration (Flexible)

Configuring Stripe to use Sphere as a tax calculation provider for billing flows.

Our Stripe app simplifies the configuration of your Stripe account, allowing you to get Sphere's Flexible tax calculation up and running in minutes. This guide provides step-by-step instructions on how to download Sphere's Stripe app and turn on live tax calculation within specific Stripe products.

### Part 1: Download Sphere's Stripe App

1. In your Sphere account click **Connect** on the Stripe tile.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FkVk2kFVTppV2fZwVwclK%2FStripe.png?alt=media&amp;token=420c78bd-1cc6-4826-88ad-a625b917a256" alt=""><figcaption></figcaption></figure>

2. You will be redirected to a new tab where you will be required to **select your Stripe account** that should be integrated with Sphere.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FXneEUvgqgcZnGPISG0jg%2FGroup%2081361.png?alt=media&amp;token=9ee8c6f3-c25e-4487-b4d2-957f647feeca" alt=""><figcaption></figcaption></figure>

3. Select **Continue** to install Sphere's Stripe app.

<figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FjiOOIUbetKgcbySlsQn7%2Fimage.png?alt=media&amp;token=e6cbd3b7-bf57-4292-85e7-74bce243edc3" alt=""><figcaption></figcaption></figure>

4. If the connection is successful, you'll see a success message on screen and you'll be redirected back to the Sphere app.
5. Ensure all your 'Subscribed Regions' in Sphere have 'Tax Calculations' settings switched to Yes (see video [here](https://www.loom.com/share/6254e72b130c44808a59513046ee60ea?sid=463c87f3-0683-4622-a479-0f960620d332) on how to ensure this is done).<br>

   <figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FOIwyuwlTx1VhyETgcJNy%2FProducts%20-%20Turn%20on%20(2).png?alt=media&amp;token=269a8987-6138-40ed-ae2d-060eb900181c" alt=""><figcaption></figcaption></figure>

### Part 2: Disable automatic tax calculation in your Stripe account

1. Once you have the Stripe app installed (refer to Part 1), go to your Stripe Dashboard, click on the gear icon in the top right hand corner of your screen, click Tax, go to the Integrations tab and ensure that the automatic tax' toggle is switched off.<br>

   <figure><img src="https://970780403-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCwrKUWiKw8qxo6t83mBG%2Fuploads%2FudRVJT8fZuvbViIDJGmd%2FScreenshot%202026-09-04%20at%2012.03.35%E2%80%AFpm.png?alt=media&amp;token=19336314-0245-47f2-9df1-480ed17eb04a" alt=""><figcaption></figcaption></figure>

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Note: If you create invoices / subscriptions / checkout sessions via Stripe's API you must ensure that the <code>automatic_tax.enabled</code> parameter is set to <code>false</code> (more info <a href="https://docs.stripe.com/api/subscriptions/create#create_subscription-automatic_tax">here</a>).</p></div>
2. Reach out to your Sphere representative, and ask them to enable Flexible tax calculation for you.
3. Once all the above steps are complete, be sure to test out your existing billing flows and reach out to your Sphere representative if you have any issues or questions.