# 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: Complete Stripe Onboarding

1. Click **Connect with Stripe** to begin the onboarding process
2. You will be redirected to Stripe's secure hosted onboarding page
3. Complete the required information:
   * Business details
   * Identity verification
   * Bank account for payouts
4. Once complete, Stripe will redirect you back to Limio

### 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 **Stripe Payment Element** as the payment method
4. Save your changes

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