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

# Stripe Connect Integration

Limio supports Stripe Connect, enabling you to accept payments through Stripe without managing your own Stripe API credentials. This integration uses Limio's Stripe Connect platform credentials to connect your Stripe account, simplifying setup and providing a seamless payment experience.

## Overview

Stripe Connect allows Limio to act as a platform that facilitates payments on behalf of your business. Instead of configuring your own Stripe API keys, you connect your Stripe account to Limio through a secure onboarding process. This approach offers several benefits:

* **Simplified setup**: No need to manage or rotate API keys
* **Secure onboarding**: Stripe's hosted onboarding handles identity verification and compliance
* **Unified billing**: Process payments directly through Stripe as your billing provider

## Prerequisites

Before setting up Stripe Connect, ensure you have:

* A Limio Commerce account with admin access
* A Stripe account (or you can create one during onboarding)
* Access to the Limio Integrations settings

## Integration Types

When you add the Stripe integration, you choose how Limio authenticates against Stripe:

### Stripe Connect

Limio connects to your Stripe account using its own Stripe Connect platform credentials, via Stripe's OAuth flow. You keep full access to your Stripe Dashboard and manage disputes, refunds and payouts there. No API keys are shared with Limio.

### Direct (API Key)

Instead of Connect, you can supply your own **Stripe Secret Key** and Limio will call Stripe directly with it. Choose this if you would rather manage and rotate your own credentials.

{% hint style="info" %}
Stripe Connect in Limio is OAuth-only. Stripe's **Express** and **Standard** account types are a property of how a platform onboards accounts; Limio does not offer a choice between them, and Express accounts are not supported.
{% endhint %}

## Setting Up Stripe Connect

### Step 1: Navigate to Integrations

1. Log in to your Limio admin panel
2. Go to **Integrations** in the main navigation
3. Select **Stripe** from the available integrations

### Step 2: Configure Connection Settings

Choose your configuration options:

| Setting               | Options                           | Description                                                                                                                      |
| --------------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Integration Type**  | Direct (API Key) / Stripe Connect | How Limio authenticates against Stripe (see [Integration Types](#integration-types)). Defaults to **Direct**.                    |
| **Platform Mode**     | Sandbox / Live                    | Shown for **Stripe Connect** only. Selects which of Limio's Stripe Connect platform credentials to use. Defaults to **Sandbox**. |
| **Stripe Secret Key** | Your Stripe secret key            | Shown for **Direct (API Key)** only, and required in that case.                                                                  |

{% hint style="info" %}
Platform Mode is set when you connect your account. To move a connected account from Sandbox to Live, reconnect through the onboarding flow with **Live** selected.
{% endhint %}

### Step 3: Connect your Stripe account

1. Click **Connect with Stripe** to begin
2. You will be redirected to Stripe's secure page:
   * **If you already have a Stripe account**, sign in via OAuth to link your existing account to Limio
   * **If you are new to Stripe**, complete the hosted onboarding (business details, identity verification, bank account for payouts)
3. Once complete, Stripe will redirect you back to Limio

{% hint style="info" %}
Existing Stripe accounts can be linked via OAuth without going through onboarding again. Your existing customers, products, and payment methods remain intact.
{% endhint %}

### Step 4: Verify Connection

After completing onboarding:

1. Return to the Limio Integrations page
2. Verify that your Stripe account shows as **Connected**
3. The connected account ID will be displayed for reference

## Configuring Stripe Connect on Offers

Once your Stripe Connect integration is set up, you can use it as a payment method on your offers.

### Adding Stripe Connect Payment Method

1. Navigate to your [https://docs.limio.com/product/pricing/what-are-offers-and-how-to-configure-them](https://docs.limio.com/product/pricing/what-are-offers-and-how-to-configure-them "mention") in the Limio catalog
2. Open the offer's payment settings
3. Select one or more Stripe payment types: **Stripe Card** or **Stripe BACS Direct Debit**
4. Save your changes

See [Configure Payment Methods](/integrations/stripe-billing-integration/manage-payments/configure-payment-methods.md) for full details on per-offer payment method configuration.

### Payment Flow

When a customer purchases an offer with Stripe Connect:

1. The customer enters their payment details in the checkout
2. Payment is processed through your connected Stripe account
3. Funds are deposited directly to your configured bank account
4. Subscription billing is managed through Stripe

### Sandbox mode

Connect with **Platform Mode** set to **Sandbox** during development to:

* Verify your integration is working correctly
* Test the checkout flow without processing real payments
* Use [Stripe test card numbers](https://docs.stripe.com/testing) for transactions

## Troubleshooting

### Connection Issues

| Issue                            | Solution                                                          |
| -------------------------------- | ----------------------------------------------------------------- |
| Onboarding not completing        | Ensure all required fields are filled in Stripe's onboarding form |
| Redirect not working             | Check that pop-ups are enabled for the Stripe domain              |
| Account not showing as connected | Refresh the Integrations page and verify onboarding was completed |

### Payment Issues

| Issue                       | Solution                                                                       |
| --------------------------- | ------------------------------------------------------------------------------ |
| Payments failing in Sandbox | Verify you're using valid [Stripe test cards](https://docs.stripe.com/testing) |
| Payments failing in Live    | Check your Stripe Dashboard for detailed error messages                        |
| Funds not appearing         | Review your Stripe payout schedule and bank account settings                   |

## Related Resources

* [Stripe Connect Documentation](https://docs.stripe.com/connect)
* [Stripe Testing Guide](https://docs.stripe.com/testing)
* [Configure Payment Type on Offer](https://docs.limio.com/integrations/zuora-integration/configuring-payment-gateways/configuring-payment-type/how-to-configure-zuora-payment-type-on-the-offer)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.limio.com/integrations/stripe-billing-integration/getting-started/stripe-connect-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.