> 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

## Account Types

When connecting your Stripe account, you can choose between two account types:

### Standard Account

A Standard account gives you full access to the Stripe Dashboard. This is recommended if you:

* Want complete control over your Stripe account settings
* Need access to all Stripe features and reports
* Prefer to manage disputes and refunds directly in Stripe

### Express Account

An Express account provides a streamlined experience with a simplified Stripe dashboard. This is suitable if you:

* Prefer a lightweight interface for managing payouts
* Want Limio to handle more of the payment operations
* Need quick onboarding for your team

## 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                                                                               |
| ---------------- | ------------------ | ----------------------------------------------------------------------------------------- |
| **Environment**  | Test / Production  | Select **Test** for development and testing, or **Production** for live transactions      |
| **Account Type** | Standard / Express | Choose the Stripe account type that fits your needs (see [Account Types](#account-types)) |

### 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

### Test Environment

Use the Test environment 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 test mode  | Verify you're using valid [Stripe test cards](https://docs.stripe.com/testing) |
| Payments failing in production | 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.