# Stripe Marketplace App

Bunny is available as an app that runs within the Stripe dashboard. This guide explains the installation process and how to use the app. 

{% hint style="success" %}
To allow Bunny to process payments via Stripe see the [Stripe plugin](/guide/advanced-guides/integrations/stripe.md). 
{% endhint %}

### Installation

The first step is to install the Bunny app from the Stripe marketplace. 

{% embed url="<https://marketplace.stripe.com/apps/bunny>" %}

The app can be installed in **Test mode** or into a live Stripe account.&#x20;

You will be prompted to grant the Bunny app access to read data about your accounts and subscriptions. The app needs this permission to identify subscriptions that are coming up for renewal and migrating pricing plans over into Bunny.&#x20;

### Connect to Bunny

Once the app is installed it will be displayed as a side bar in Stripe.&#x20;

The next step is to connect the app to Bunny. You can either connect to an existing Bunny account or create a new one.&#x20;

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

#### Create a new Bunny account

Clicking the "Create a new Bunny account" will create a new account in Bunny. This takes a few seconds and then you will get a notification about checking your email to continue the process.&#x20;

<figure><img src="/files/1LmrcJPHT4PQYdA29qis" alt=""><figcaption></figcaption></figure>

Open your email and look for an email from Bunny. If you cant find it then check your spam/junk folder.&#x20;

Once you locate the email then click the link in the email to continue. This will open up the Bunny app in your browser.&#x20;

After the Bunny app opens you can go back to Stripe and click the continue button.&#x20;

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

Next you will need to click the **Connect Bunny account** button. This allows Stripe to send product and subscription information to Bunny.&#x20;

<figure><img src="/files/6AJ19VwIk0hsadeeNXXy" alt=""><figcaption></figcaption></figure>

Click to **approve** Stripe access to Bunny. You will be redirect back to the Stripe dashboard and the process is complete.&#x20;

#### Connect an existing Bunny account

If you already have a Bunny account then you can connect the Stripe app by first setting up an API client in Bunny.&#x20;

Go to **Settings > API clients** and create a new client.&#x20;

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

You will need the following settings:

<table><thead><tr><th width="177">Setting</th><th>Value</th></tr></thead><tbody><tr><td><strong>Scopes</strong></td><td>product:read, product:write, standard:read, standard:write</td></tr><tr><td><strong>Grants</strong></td><td>Enable authorization code grant</td></tr><tr><td><strong>Redirect Uri</strong></td><td><p>If installing in Stripe Test Mode then use:<br><br><a href="https://dashboard.stripe.com/test/apps-oauth/com.bunny.app">https://dashboard.stripe.com/test/apps-oauth/com.bunny.app</a><br><br>If installing in a Live Stripe account then use:</p><p></p><p><a href="https://dashboard.stripe.com/apps-oauth/com.bunny.app">https://dashboard.stripe.com/apps-oauth/com.bunny.app</a><br></p></td></tr><tr><td><strong>Enable PKCE</strong></td><td>Enable</td></tr></tbody></table>

Save these settings to create the API client.&#x20;

Then copy the **Client ID** and paste it into the Stripe side bar in the field named Bunny Client ID.&#x20;

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

You will also need your Bunny subdomain which you can find by looking in the URL of the Bunny app. \
\
For example if the url was <https://example123.bunny.com/app/apiClients/144> then your Bunny subdomain is **example123**.

Finally, click **Continue** and follow the Bunny approval steps as mentioned above in the Create a new Bunny account flow.&#x20;

### Using the app

Once the app is installed and connected it will start to provide valuable information about subscriptions that are coming up for renewal within the next few months.&#x20;

Use this as a trigger to contact the customer, find out how they are getting on and look for upsell opportunities.&#x20;

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

#### Create a rewewal quote

If you navigate to a Subscription page in Stripe you will see a button to **Create a renewal quote**.&#x20;

Clicking this will open a new quote in Bunny that contains the products the customer is currently subscribed to. You can increase the quantities and add additional add-on products that you have configured in Bunny.&#x20;

[Learn more about quoting in Bunny](/guide/tour/quoting/quote-builder.md)

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

### Migrating billing to Bunny

The final step in leveling up your quoting with Bunny is to move the subscription management and billing from Stripe Billing over to Bunny. After completing this Step you will no longer need to pay Stripe Billing for managing the subscription. Bunny will look after the automated subscription billing and continue to charge the credit cards through your Stripe account.&#x20;

#### Connect the Stripe plugin in Bunny

To allow Bunny to process payments via your Stripe account. To do this you will need to [enable the Stripe plugin as described here](/guide/advanced-guides/integrations/stripe.md).&#x20;

Once the Stripe plugin is installed then you will be able to click the **Migrate subscription** button to move the subscription management and billing over to Bunny.

<figure><img src="/files/1VHVvQaAMj3M9raTTCq1" alt=""><figcaption></figcaption></figure>

From this point on the subscription and its renewals are managed directly in Bunny and you will not need to open the Stripe dashboard for this account. &#x20;


---

# 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.bunny.com/guide/advanced-guides/integrations/stripe-marketplace-app.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.