sales-lemonsqueezy

用途

本技能用于提供 Lemon Squeezy 平台的使用帮助。Lemon Squeezy 是一个作为记录商户（Merchant of Record）的数字产品销售平台，涉及支付、订阅、税务合规、数字产品交付、许可证密钥和结账等环节。当用户需要了解或解决 Lemon Squeezy 平台相关问题时，可使用本技能。

主要能力

技能覆盖以下问题类型：

店铺设置与产品配置
订阅与循环计费
许可证密钥生成或验证
结账设置（托管、覆盖层或嵌入式）
Webhook 或 API 集成
打款、税务或合规问题
Lemon Squeezy 内的邮件营销
联盟计划设置
从其他平台迁移（Gumroad、Paddle、Stripe）
故障排查

技能会先收集上下文（若存在 references/learnings.md 则先读取），询问用户具体需求以及所售产品类型（数字产品、SaaS/订阅软件、课程或会员、其他）。若用户提示已包含足够上下文，则跳过收集直接进入下一步。

对于策略类问题，技能会路由到对应技能，例如：数字产品定价、发布策略、平台对比路由到 /sales-digital-products；结账页优化、追加销售、订单增购、购物车放弃路由到 /sales-checkout；会员站点结构、课程设计、留存路由到 /sales-membership；邮件营销策略、序列、细分路由到 /sales-email-marketing；联盟计划设计、佣金结构、招募路由到 /sales-affiliate-program；邮件送达率、SPF/DKIM/DMARC 路由到 /sales-deliverability。

对于 Lemon Squeezy 平台问题，技能会参考 references/platform-guide.md 获取完整平台参考（模块、定价、集成、数据模型、工作流、API 快速参考），并仅使用相关部分作答，不会倾倒完整参考。随后进入可执行指导阶段，针对用户具体情况提供具体下一步；若涉及 API，则参考 references/lemonsqueezy-api-reference.md 获取端点细节。若发现 references/learnings.md 未覆盖的坑、变通方法或提示，会追加到该文件。

使用方式

用户可直接提出 Lemon Squeezy 相关问题，技能会按步骤收集上下文、路由或直接回答、参考平台指南、给出可执行指导。

适用场景

设置 SaaS 订阅：例如以 $29/月和 $290/年出售 SaaS，含 14 天免费试用。技能会引导创建含两个变体（月度和年度）的产品、配置试用期、设置结账覆盖层、实现订阅生命周期事件（创建、更新、取消、过期）的 Webhook 监听，并涵盖用于软件访问控制的许可证密钥设置。
从 Gumroad 迁移：比较费用结构（Gumroad 10% vs LS 5% + 50¢），解释 MoR 税务处理优势，引导产品重建、客户迁移注意事项和 URL 重定向策略，并提示账户审批延迟。
Next.js Webhook 集成：排查生产环境 Webhook 未触发问题，检查常见原因（Cloudflare WAF 拦截、Webhook URL 错误、缺少签名验证、SSL/TLS 问题如错误 525），使用 LS 测试模式 Webhook 模拟进行测试，并提供 Webhook 签名验证代码模式。

限制与注意事项

以下为基于研究的最佳努力，需注意其中关于计划限制功能和集成坑点可能已过时：

账户审批可能需要数天到数周：Lemon Squeezy 在接受实时支付前需要人工账户验证。应提前提交完整业务详情和身份文件以加速。在账户获批前不要计划发布日。
打款可能延迟或冻结：有多份报告称打款长时间失败且支持响应缓慢。应保留财务缓冲，不要依赖立即获取资金，尤其是在最初几个月。
支持缓慢且以 AI 为先：聊天支持是 AI 机器人；人工支持仅通过邮件，响应时间可能长达数天。紧急问题应直接发送邮件至 hello@lemonsqueezy.com，而非使用聊天组件。
Cloudflare 可能静默拦截 Webhook：若站点使用 Cloudflare，即使配置了 IP 允许列表，Webhook 仍可能被拦截。应检查 Cloudflare WAF 规则，为 Lemon Squeezy 的 Webhook IP 和 Webhook 路径创建显式允许规则。
Stripe 收购导致路线图不确定：Stripe 于 2024 年收购 Lemon Squeezy，并正在构建自己的 MoR 解决方案（Stripe Managed Payments）。功能迭代速度已放缓。应评估 LS 当前功能集是否满足需求，而不依赖未来更新。
5% + 50¢ 可能更高：基础交易费为 5% + 50¢，但附加费会叠加：+1.5% 国际、+1.5% PayPal、+0.5% 订阅、+5% 购物车放弃恢复、+3% 联盟推荐订单。打款也有费用（非美国银行 1%，非美国 PayPal 3% 上限 $30）。在承诺前应模拟实际总费用。
邮件营销功能基础：内置邮件仅支持新闻通讯和广播。没有自动化工作流、没有高级细分、没有 A/B 测试。若需严肃邮件营销，应通过 Webhook 或 Zapier 连接到专用 ESP（Kit、Mailchimp、ActiveCampaign）。

故障排查

Webhook 在生产环境未触发：症状为测试模式正常但生产环境不工作，或返回 4xx/5xx 错误。原因可能是 Cloudflare WAF 拦截 POST 请求、Webhook URL 错误、SSL 证书问题（错误 525）或端点未返回 200 响应。解决方案：为 Webhook 路径创建 Cloudflare WAF 允许规则；验证 Webhook URL 指向生产环境（非 localhost）；确保端点在超时内返回 200；检查 Lemon Squeezy 仪表板 → Settings → Webhooks 的投递状态和重试历史。非 200 响应会重发最多 3 次（共 4 次尝试）；之后可从仪表板手动重发最近的 Webhook。
打款未到账：症状为销售有进账但打款延迟或失败。原因可能是账户验证未完成、打款方式未配置或未达到打款阈值。解决方案：检查 Settings → Payouts 状态；确保身份验证和税务表格已完成；验证银行/PayPal 打款方式配置正确；若长时间延迟，直接联系 hello@lemonsqueezy.com，AI 聊天支持无法解决打款问题。
许可证密钥激活失败：症状为客户报告“invalid license key”错误。原因可能是密钥状态为 inactive/disabled/expired、达到激活上限或使用了错误的 API 端点。解决方案：License API 使用不同的基础地址和速率限制（60 请求/分钟，主 API 为 300）。在仪表板检查密钥状态——过期密钥需要订阅续费。验证是否 POST 到正确的激活端点，且 Content-Type 为 application/x-www-form-urlencoded（不是 JSON:API 格式）。

技能介绍

用途