# Stripe Integration

Downloading Sphere's Stripe app enables a.) seamless transaction data import and b.) live tax calculation within Stripe Billing and Checkout products.

This guide provides step-by-step instructions on how to download Sphere's Stripe app and turn on live tax calculation within Stripe products.

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

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

<figure><img src="/files/5Hd0V7qgrPNofkGL9gJV" 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="/files/88wNBZPDCOdckMMIOlMR" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/ThwbpgHcqFhyMTjfQGNu" 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.

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

1. 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).

<figure><img src="/files/5Jki3I9DBNxkpIKPprtq" alt=""><figcaption></figcaption></figure>

2. 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 on

<figure><img src="/files/z37vp0PlwESuI0MYM1lE" alt=""><figcaption></figcaption></figure>

3. Then navigate to the Advanced options tab and ensure your Tax calculation provider is set to Sphere

<figure><img src="/files/COBijIsRl8r2V9Odp9Js" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Note: If you create invoices / subscriptions / checkout sessions via Stripe's API you must ensure that the `automatic_tax` parameter is set to `enabled` (more info [here](https://docs.stripe.com/api/subscriptions/create#create_subscription-automatic_tax)).
{% endhint %}

4. In the Business information tab, ensure your tax inclusive / exclusive pricing setting in Stripe is set to 'Automatic' (this ensures tax inclusive pricing in regions that require it, e.g. EU, UK etc).

<figure><img src="/files/qqqLQaBtBpblDZ6GSgmQ" alt=""><figcaption></figcaption></figure>

5. 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getsphere.com/features/integrations/prebuilt-connectors/stripe-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.