Payment Providers

Self-Host Pro integrates with payment providers so you can sell your software and receive payments directly. When a customer completes a purchase, they automatically get access to your product.

Supported providers

• Stripe — Credit cards, subscriptions, global payments
• Lemon Squeezy — Merchant of record, handles taxes and compliance

More providers coming soon.

Stripe

Stripe is the most popular payment processor for software businesses. Self-Host Pro uses Stripe Connect so payments go directly to your Stripe account.

Connecting Stripe

During onboarding:

The onboarding flow prompts you to connect Stripe after creating your team. Click Connect Stripe to start the OAuth flow.

From team settings:

1. Go to your team settings
2. Find the Integrations section
3. Click Connect Stripe

You'll be redirected to Stripe to authorize the connection. After authorization, your Stripe account is linked and you can start selling.

Creating Stripe products

Create products and prices in your Stripe Dashboard:

1. Go to Products → Add product
2. Set a name and description
3. Add pricing:
   • One-time — Customer pays once
   • Recurring — Monthly or yearly subscription

Linking to your product version

1. Go to your product's Versions tab
2. Edit the version you want to sell
3. Under Purchase Access, click Add Marketplace Product
4. Select your Stripe integration
5. Choose the Stripe product from the dropdown
6. Set access duration:
   • Indefinite — Customer keeps access forever
   • Expires after X days — Access revoked after the period ends

How purchases work

1. Customer completes Stripe checkout
2. Stripe sends a webhook to Self-Host Pro
3. Customer record is created (or matched by email)
4. Customer gets access to the product
5. Customer receives an email with a link to install

Subscriptions

For recurring subscriptions, Self-Host Pro listens to Stripe webhooks:

• Subscription created — Customer gains access
• Subscription renewed — Access continues
• Subscription canceled — Access is revoked

Disconnecting

To disconnect Stripe, go to team settings and click Disconnect on your Stripe integration.

Lemon Squeezy

Lemon Squeezy is a merchant of record platform — they handle payments, taxes, and compliance so you don't have to. This is useful if you want to sell globally without managing tax collection yourself.

Connecting Lemon Squeezy

1. Go to your team settings
2. Find the Integrations section
3. Click Connect Lemon Squeezy
4. Enter a name for the integration (e.g., "My Store")
5. Enter your Lemon Squeezy API key

To get your API key:

1. Log in to Lemon Squeezy
2. Go to Settings → API
3. Create a new API key
4. Copy the key and paste it into Self-Host Pro

Creating Lemon Squeezy products

Create products in your Lemon Squeezy Dashboard:

1. Go to Products → New Product
2. Set name, description, and pricing
3. Configure as one-time or subscription

Linking to your product version

1. Go to your product's Versions tab
2. Edit the version you want to sell
3. Under Purchase Access, click Add Marketplace Product
4. Select your Lemon Squeezy integration
5. Choose the product from the dropdown
6. Set access duration

How purchases work

1. Customer completes checkout on Lemon Squeezy
2. Lemon Squeezy sends a webhook to Self-Host Pro
3. Customer record is created (or matched by email)
4. Customer gets access to the product
5. Customer receives an email with a link to install

Subscriptions

For recurring subscriptions:

• Order created — Customer gains access
• Subscription updated — Access status updated
• Subscription expired — Access is revoked

Disconnecting

To disconnect, go to team settings and click Disconnect on your Lemon Squeezy integration.

Multiple providers

You can connect multiple payment providers and even link the same product version to products from different providers. This lets you:

• Offer customers payment choice
• Sell through different channels
• Test providers before switching

Each marketplace product you link can have its own access duration settings.

Pricing strategies

One-time purchase with lifetime access

• Set a one-time price in your payment provider
• In Self-Host Pro, set access to Indefinite
• Customer pays once, keeps access forever

Annual subscription

• Set a recurring yearly price
• In Self-Host Pro, set access to expire after 365 days
• When the subscription renews, access extends automatically

Monthly subscription

• Set a recurring monthly price
• In Self-Host Pro, set access to expire after 30 days
• Access extends with each renewal

Tiered pricing

Create multiple Stripe/Lemon Squeezy products at different price points, each linked to different versions:

• Basic → Links to v1-basic version
• Pro → Links to v1-pro version with more features

Test mode

Before going live, test the full purchase flow:

1. Use your payment provider's test mode
2. Create test products
3. Link them in Self-Host Pro
4. Make test purchases
5. Verify customers get access and can install

When ready, create live products and update your marketplace product links.