Ctrlk
Support Request
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.

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

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.

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

Existing Stripe accounts can be linked via OAuth without going through onboarding again. Your existing customers, products, and payment methods remain intact.

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

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

PreviousGetting Started with Stripe
NextConfigure Stripe Payment Settings

Last updated

Was this helpful?