> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fanfare.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Payments and fees

> Connect Stripe to receive payouts from Fanfare checkout, manage payouts and disputes, and understand Fanfare's per-order fees.

When you sell with Fanfare checkout, customer payments go straight to your connected Stripe account. Go to **Settings → Payments** (under **Commerce**) to connect Stripe, manage payouts, and review your per-order fee rates. To choose between Fanfare checkout and your own store's checkout, see [Organization settings](https://docs.fanfare.io/guide/account/organization.md) and [Checkout options](https://docs.fanfare.io/concepts/checkout-options.md).

## Before you start

* **Admin access required:** Only organization admins can connect, manage, or disconnect Stripe. Members can view rates and account status read-only.
* **US accounts in USD only:** Fanfare checkout currently supports US Stripe accounts charging US dollars.
* **Set your currency first:** Confirm your organization's **Currency** is set to **USD** in [Organization settings](https://docs.fanfare.io/guide/account/organization.md) before connecting. Linking a Stripe account sets your organization's country to match the Stripe account and permanently locks both country and currency.
* **Connect before creating drops:** Your Stripe account must be able to take payments before Fanfare will let you create a queue, draw, auction, or timed release (appointments aren't affected).

![Settings, Payments, showing the Fanfare checkout pricing card with a Starter plan rate badge and two rates, and below it the Stripe account card marked Active with account name, account ID, country, and a Disconnect button.](https://mintcdn.com/fanfare/1LIsN6sNCEZdXydH/images/guide/guide-account-payments-pricing-and-account.webp?fit=max\&auto=format\&n=1LIsN6sNCEZdXydH\&q=85\&s=f1feddd44bd38053938252bbdd23884b)

Review your per-order rates on the pricing card and your payout connection on the Stripe account card.

## Check your fees

The **Fanfare checkout pricing** card shows the exact rates applied to your paid orders:

* **Rate badge:** Shows whether you're on your plan's standard rate (**Starter plan rate**, **Growth plan rate**, **Pro plan rate**, or **Enterprise plan rate**) or a negotiated **Custom rate**.
* **Draws, queues and auctions:** The percentage fee on orders from those three drop types.
* **Timed releases:** The percentage fee on timed-release orders.
* **Minimum fee per order:** Appears only when a custom rate includes a minimum fee.
* **Split rates:** If your Shopify checkout orders carry a different custom rate, the card separates **On Fanfare checkout** and **On Shopify checkout**.
* **Full pricing:** Links to Fanfare's public pricing table.

Compare every plan's take rates in [Plans and what they unlock](https://docs.fanfare.io/guide/start/plans.md), or track total fees by billing period in [Billing and usage](https://docs.fanfare.io/guide/account/billing.md).

### How fees work

* **Automatic deduction:** Fanfare's fee is deducted directly in Stripe when payment is captured (including when a pre-authorized hold is captured). You're never invoiced for it separately.
* **Minimum fee:** If your custom rate has a minimum fee per order, Fanfare takes the percentage or the minimum—whichever is higher—never exceeding the order total itself.
* **Rate locked at payment:** Each order keeps the rate active when it was paid. Changing plans mid-period doesn't re-rate earlier orders.
* **Custom rates stay put:** A custom rate overrides standard plan rates across every tier, so changing plans won't alter it.
* **Other fees and exceptions:** Appointments never take payment, so they carry no fee. Stripe's own processing fees are billed separately to your Stripe account.
* **Order details and refunds:** After payment is captured, the fee appears as **Fanfare fee** on the order's **Payment** card (and in each distribution's payment settings—see [Admission and the payment window](https://docs.fanfare.io/concepts/admission-and-payment.md)). Refunding an order doesn't return the Fanfare fee ([Orders and refunds](https://docs.fanfare.io/guide/learn/orders.md)).

## Choose how to connect Stripe

You can either create a Stripe account through Fanfare or link an existing Stripe account you already own.

| | Created through Fanfare | Existing Stripe account |
| - | - | - |
| **How to connect** | Select **Set up payments** and complete Stripe onboarding | Select **Connect an existing Stripe account** and authorize Fanfare in Stripe |
| **Finish setup** | Select **Continue setup** on this page | Open your Stripe Dashboard (**Open Stripe Dashboard**) |
| **Manage payouts, bank details, and disputes** | Directly on this page under **Account and bank details**, **Payouts**, and **Payments and disputes** | In your Stripe Dashboard |
| **After disconnecting** | The account remains tied to your organization, and payout, balance, bank details, and disputes are hidden while disconnected—Fanfare-created Stripe accounts have no Stripe Dashboard of their own, so disconnecting leaves nowhere to view payouts, balance, or disputes. Select **Set up payments** to reconnect the same account. | You can reconnect only the same Stripe account via **Connect an existing Stripe account**—Fanfare can't create a new one. |

> [!WARNING]
>
> Selecting **Create account**—or connecting an existing Stripe account—immediately locks your organization's country and currency and permanently ties your organization to that Stripe account, even if you never finish onboarding or disconnect it later. You can't swap in a different Stripe account afterward, so decide which connection path you want before continuing.

![The Stripe account card before anything is connected, showing a Stripe account country picker set to United States, a Set up payments button, and a Connect an existing Stripe account button.](https://mintcdn.com/fanfare/1LIsN6sNCEZdXydH/images/guide/guide-account-payments-not-connected.webp?fit=max\&auto=format\&n=1LIsN6sNCEZdXydH\&q=85\&s=f7f7cb88fd96a8847105d1fbca97eee1)

## Create a Stripe account through Fanfare

1. Go to **Settings → Payments**.
2. Confirm **Stripe account country** is set to **United States**.
3. Select **Set up payments**.
4. Review the country-lock confirmation and select **Create account**.
5. Complete Stripe's onboarding flow. Stripe will return you to **Settings → Payments**.

Once Stripe verifies your account, your status updates to **Active**. If anything is still required, check [Account states](#account-states). (If an onboarding link expires before you finish, returning to this page reopens onboarding automatically.)

## Connect an existing Stripe account

1. Go to **Settings → Payments**.
2. Select **Connect an existing Stripe account**.
3. Sign in to Stripe and authorize Fanfare.
4. Stripe returns you to **Settings → Payments**.

Connecting sets your organization's country to your Stripe account's country and applies the same permanent country, currency, and account lock described above.

If Stripe can't connect your account, review the message shown on the page:

| Error message | How to fix it |
| - | - |
| "Connection was cancelled or denied." | Start again and authorize Fanfare in Stripe. |
| "Invalid connection state. Please try again." | Restart from **Connect an existing Stripe account**. |
| "Fanfare checkout isn't available for Stripe accounts in this country yet." | Connect a US Stripe account. |
| "Fanfare checkout is available for organizations that use US dollars with a US Stripe account." | Set your organization's currency to **USD** and ensure your Stripe account's default currency is US dollars, then try again. |
| "This Stripe account can't accept card payments yet. Finish its setup in Stripe, then connect it again." | Complete card-payment setup in your Stripe Dashboard, then reconnect. |
| "This organization is tied to a different Stripe account than the one you chose. Connect that account instead, or contact support." | Connect the original Stripe account linked to your organization, or contact support. |
| "Failed to connect Stripe account." / "An error occurred. Please try again." | Try connecting again in a moment. |

## Account states

Once an account is linked, the **Stripe account** card displays its **Account ID** (along with **Account Name**, **Email**, and **Country** once available from Stripe) and one of three badges:

| Badge | What it means | Next step |
| - | - | - |
| **Setup not finished** | Stripe needs additional details before your account can accept payments. | Select **Continue setup** (for Fanfare-created accounts) or **Open Stripe Dashboard** (for existing accounts). |
| **Action needed** | Stripe needs updated information—payments or payouts may pause until it's provided. | Complete the requested details in the sections below the notice (Fanfare-created accounts) or via **Open Stripe Dashboard** (existing accounts). |
| **Active** | Your account is ready to take payments. | You're all set. |

If you revoked Fanfare's access from your own Stripe Dashboard, the badge returns to **Setup not finished**—select **Disconnect**, then reconnect the same account using **Connect an existing Stripe account**.

![The Stripe account card with a Setup not finished badge, a notice that Stripe needs more details, and a Continue setup button.](https://mintcdn.com/fanfare/1LIsN6sNCEZdXydH/images/guide/guide-account-payments-setup-not-finished.webp?fit=max\&auto=format\&n=1LIsN6sNCEZdXydH\&q=85\&s=22cdcfcd5e8f2850c056495a841ce669)

## Manage payouts, bank details, and disputes

* **Fanfare-created accounts:** Once your account is **Active** or **Action needed**, organization admins can manage **Account and bank details**, **Payouts**, and **Payments and disputes** directly on the **Stripe account** card, with any Stripe notices shown above them.
* **Existing Stripe accounts:** Select **Open Stripe Dashboard** to manage payouts, bank accounts, and disputes in Stripe.

## Disconnect Stripe

1. On the **Stripe account** card, select **Disconnect**.
2. Review the confirmation dialog and select **Disconnect** again.

> [!WARNING]
>
> Disconnecting immediately stops Fanfare checkout from taking new payments—even during live or scheduled drops. Customers who have been admitted but haven't paid yet won't be able to finish checkout, and new shoppers won't be able to enter distributions that pre-authorize payment. Disconnecting also doesn't free up your organization to connect a different Stripe account or unlock your country and currency—you can only reconnect the same Stripe account later.

To reconnect an account you originally created through Fanfare, select **Set up payments** again. The dialog still says "Create your Stripe account", even though no new account is created—Fanfare reopens Stripe onboarding for your existing linked account so you can confirm its details.

## What members see

Non-admin team members can view your fee rates, Stripe status badge, and account details, but can't connect, manage, or disconnect Stripe, and won't see payout or bank management sections. For existing Stripe accounts, **Open Stripe Dashboard** remains visible. To grant admin permissions, see [Team members](https://docs.fanfare.io/guide/account/team.md).

## On Shopify

Fanfare checkout isn't available inside the Shopify app—orders run through Shopify checkout instead. See [Orders with Shopify checkout](https://docs.fanfare.io/guide/shopify/orders.md) and [Checkout protection](https://docs.fanfare.io/guide/shopify/checkout-protection.md).

In the Shopify app, **Settings → Payments** displays your **Fanfare checkout pricing** card alongside a **Coming soon** placeholder for Stripe.

> [!WARNING]
>
> If your organization connected a Stripe account outside Shopify earlier, **Disconnect** still appears here. If you disconnect it, you won't be able to reconnect from inside the Shopify app.

## Troubleshooting

> [accordion] Set up payments shows an error
>
> If you see a message about US dollars, update your organization's **Currency** to **USD** in [Organization settings](https://docs.fanfare.io/guide/account/organization.md) and try again. If the message says your organization uses its own Stripe account, reconnect that original account using **Connect an existing Stripe account**.

> [accordion] I returned from Stripe and my account still says 'Setup not finished'
>
> The status updates to **Active** once Stripe confirms your account can accept payments. If you just finished Stripe's onboarding steps, refresh the page—Stripe verification can take a moment to sync. If the badge shows **Action needed**, check what details Stripe is requesting.

> [accordion] I can't change my organization's country or currency
>
> Both lock permanently as soon as you create or connect a Stripe account, including after disconnecting. Currency can also be temporarily locked by active or undeleted auctions—see [Organization settings](https://docs.fanfare.io/guide/account/organization.md).

> [accordion] Account management sections are temporarily unavailable
>
> "Account management is unavailable right now. Please try again later." appears when Fanfare can't load your embedded Stripe payout or bank sections. Wait a moment and refresh the page, and contact [support@fanfare.io](mailto:support@fanfare.io) if the issue persists.

## Related

> [card] [Organization settings](https://docs.fanfare.io/guide/account/organization.md)
>
> Choose your checkout processor and set your country and currency.

> [card] [Checkout options](https://docs.fanfare.io/concepts/checkout-options.md)
>
> Compare Fanfare checkout, external checkout, and Shopify checkout.

> [card] [Plans and what they unlock](https://docs.fanfare.io/guide/start/plans.md)
>
> Compare every plan's monthly price and take rates.

> [card] [Orders and refunds](https://docs.fanfare.io/guide/learn/orders.md)
>
> See how Fanfare fees appear on orders and how refunds work.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.