Lemon Squeezy
Merchant-of-record checkout. Needs API key, store ID, one-time variant ID, and webhook signing secret.
Lemon Squeezy
Merchant-of-record hosted checkout. The site sets custom_price per cart on a one-time variant.
Where to find it
Admin → Settings → Payment → gateways → Lemon Squeezy
Setup
1. Create an API key under Lemon Squeezy → Settings → API.
2. Copy Store ID (digits only) from Settings → Stores.
3. Create a one-time product and copy the variant ID (not the product ID).
4. In Settings → Webhooks, add https://YOUR-DOMAIN/api/webhooks/lemon-squeezy, event order_created, choose a signing secret, paste the same secret in admin.
5. Enable checkout; turn Test mode on while learning.
Official: Lemon Squeezy docs.
| Field | Key |
|---|---|
| Enable | lemon_squeezy_checkout_enabled |
| API key | lemon_squeezy_api_key |
| Store ID | lemon_squeezy_store_id |
| Variant ID | lemon_squeezy_variant_id |
| Webhook secret | lemon_squeezy_webhook_secret |
| Test mode | lemon_squeezy_test_mode |
Return: /api/checkout/lemon-squeezy/return.
Common problems
Wrong variant
Must be a one-time variant compatible with custom pricing.
Webhook signature failures
Secret in Lemon Squeezy ≠ secret saved in admin.