Connect your Lemon Squeezy store

Before you start

You need:

• A Modsy modder account.
• A current Modder Membership plan that includes Lemon Squeezy monetization.
• An activated creator-owned Lemon Squeezy account and store.
• At least one active recurring subscription product and variant.
• Permission in Lemon Squeezy to create an API key and manage webhooks for the store.

Modsy currently maps recurring subscription variants. One-time products and non-subscription variants are shown as unsupported and cannot grant this type of premium access.

If you have not published a mod yet, complete the illustrated modder onboarding flow first, then return here to configure supporter access.

Create and activate your Lemon Squeezy account

If you do not already have a Lemon Squeezy account, start with their business-intent signup form:

Complete the account and store onboarding with accurate information about you, your modding business, and the digital products you intend to sell.

Lemon Squeezy may send a follow-up email before activating the account. For example, their review team may ask for:

• A clear product overview, including the games or communities you serve.
• The main features and benefits subscribers receive.
• A complete pricing breakdown for each subscription plan.
• Public links that help them review your modder profile, mods, or website.
• Additional identity, business, tax, or payout information when required.

Reply directly to the legitimate review thread with the requested product and pricing details. Confirm that the sender uses an official Lemon Squeezy domain before responding. If identity documents are requested, follow the secure instructions supplied by Lemon Squeezy rather than sending sensitive documents through an unverified channel.

Example reply template

Copy this template, replace every bracketed field, remove anything that does not apply, and make sure every statement matches your actual offering.

Subject: Re: Additional information for [modder or store name]

Hello [reviewer name or Lemon Squeezy team],

Thank you for your email. Please find the requested information below.

Product overview

[Modder or studio name] creates and distributes premium game modifications
for [game names]. The mods [briefly explain what they improve or add].

Subscribers receive:
- Access to [premium mods or content]
- [Updates, new releases, installation guides, or support]
- [Any other genuine subscriber benefit]

Examples of products:
- [Mod or product name] — [one-sentence description]
- [Mod or product name] — [one-sentence description]

Customers start their subscriptions from my Modsy modder or mod pages.
Payments and subscriptions are processed by Lemon Squeezy, and Modsy grants
access to the mapped digital content after verifying the subscription.

Public links:
- Modsy modder profile: [public profile URL]
- Example mod or product: [public product URL]
- Website or portfolio: [URL, if available]

Pricing information

- [Subscription name] — [currency and price] per month
- [Subscription name] — [currency and price] per year, if offered

All products are delivered digitally. There are no physical goods or shipping.

Please let me know if you need any additional information.

Kind regards,
[Your full name]
[Modder or studio name]

Once the account is activated, create and publish the recurring subscription products you want to offer. Then continue with the API key and Modsy connection steps below.

Create an API key

After Lemon Squeezy activates your account and store:

1. Sign in to Lemon Squeezy and open Settings → API.
2. Select the plus (+) icon in the top-right corner.
3. Enter a recognizable name, such as Modsy integration.
4. Select an expiration date. Modsy does not require the key to expire frequently, so you can choose a distant date if Lemon Squeezy allows it and that fits your security policy.
5. Select Create API key.
6. Copy the API key when Lemon Squeezy displays it and keep it available for the connection steps below.

Connect your store

1. Open Modder Dashboard → Monetization.
2. Find the Lemon Squeezy card, select Connect Lemon Squeezy, and paste the API key into the API key field.
3. Select Verify API key and confirm that the test succeeds.
4. Confirm that Modsy lists the expected store or stores.
5. Select the store that contains the subscription products you plan to use.
6. Select Connect store.
7. Clear the API key from any temporary clipboard manager or note where you may have placed it.

Modsy encrypts the connected credential and displays only a masked indicator afterward.

Configure the signed webhook

Modsy attempts to register the required webhook automatically. If the connection reports that the webhook is registered, continue to catalog sync.

If automatic registration is unavailable, Modsy displays a manual setup dialog containing:

• The exact webhook URL for this creator connection.
• A signing secret that is shown once.
• The required event list.
• The signature header Modsy verifies.

In Lemon Squeezy, create the webhook for the selected store and copy these values exactly. Select every event listed by Modsy.

Open Manage connection → Connection details to copy the current webhook URL and event list later. It shows only a masked secret indicator.

Sync your catalog

Select Sync after the store is connected. Modsy imports products and variants from the selected store. Expand View products to see their current status, recurring price, currency, and interval.

Run another sync whenever you:

• Create or publish a subscription product.
• Rename a product or variant.
• Change its price or billing interval.
• Disable, archive, or replace a product.

Only active recurring variants appear in the premium mod selector.

Configure mod access

When uploading or editing a mod:

1. Choose whether the mod itself is Free or Premium.
2. Select Lemon Squeezy under Payment providers. You may also select Patreon so a supporter can qualify through either provider.
3. Select the active Lemon Squeezy subscription product shown by Modsy.
4. Optionally enable Scheduled Early Access release and choose a duration of no more than 30 days. Early Access works for both Free and Premium mods. When it ends, that release becomes the mod's main version: it is free to download on a Free mod, while on a Premium mod it becomes the main Premium version and the mod remains Premium.
5. Complete the upload details and submit the mod for review.

Premium and Early Access mods use the same plan allowance. If a count limit applies, a mod using both features counts only once. See the Modder Membership plans for current allowances. All uploaded mod files count toward your included storage.

Supporters must begin checkout from the Modsy mod page. A random purchase, a manually edited checkout URL, or a subscription to an unmapped product does not grant access.

Test subscriber access

Use a test-mode store or a controlled low-risk product before using the integration with a public release:

1. Start checkout from the approved Modsy mod page.
2. Complete the subscription using a separate supporter account.
3. Confirm the signed-in Modsy account can unlock and download the mapped mod.
4. Confirm an account without the mapped subscription remains locked.
5. Cancel the test subscription and verify access follows the provider-confirmed paid-through date.
6. Confirm future subscription updates reach the signed webhook.

Troubleshooting

Credentials are rejected

Create a new Lemon Squeezy API key from an account that can access the store, then test it again. Do not send the key to Modsy support.

The expected store is missing

The API key cannot access that store. Confirm the Lemon Squeezy account and store permissions before reconnecting.

No subscription products appear

Confirm the product and variant are active and recurring, then select Sync. One-time variants are not eligible.

Webhook needs setup

Open Manage connection → Connection details, compare the URL and required event list with Lemon Squeezy, and confirm the saved signing secret is the one generated for this Modsy connection. Reconnect if the secret is lost.

A completed checkout did not unlock access

Confirm checkout began from the correct Modsy mod page and used the mapped product. Then verify webhook health in the Monetization card. Avoid repeating a charge while investigating.

Syncing and unavailable products

After a successful Sync, Modsy automatically unpublishes mods whose premium or active or scheduled Early Access settings no longer offer access. This covers removed or inactive products and variants, and variants changed from subscriptions to one-time purchases. A mod remains available when another selected subscription product or configured provider still offers access.

You receive the unpublished mod count and a notification. Fix the affected subscription product mappings, then use Publish Mod in your dashboard. Renaming a valid product or changing its price does not unpublish mods, and syncing never automatically republishes them. A failed catalog request does not count as confirmation that products were removed.

Disconnecting

You may disconnect Lemon Squeezy even when monetization management is locked. If any of your premium mods or active or scheduled Early Access releases use Lemon Squeezy, Modsy asks you to confirm that their mods will be unpublished. This includes mods that also accept Patreon subscriptions. Canceling keeps your connection and mods unchanged.

After confirmation, those mods are hidden from public pages and downloads are unavailable. Modsy also attempts to remove its remote webhook. Reconnect your store, complete webhook setup, sync your catalog, and restore valid subscription product mappings before using Publish Mod in your dashboard. Reconnecting does not automatically publish your mods.