🍋 LemonSqueezy 定价拆解

Merchant of Record 模式全解析——含税含合规的全包定价，与 Paddle/Gumroad 深度对比

📋 概览

LemonSqueezy 成立于 2021 年，定位为数字产品专用的电商 + 支付平台。它的核心差异化在于：作为 Merchant of Record (MoR)，LemonSqueezy 在法律上代表你向客户出售产品——这意味着它承担税务收集/申报、退款处理、欺诈防护、PCI 合规等全部责任。

💸 费率结构详解

LemonSqueezy 的费率不是一个简单数字，而是基础费率 + 条件附加费的组合。理解附加费是算清真实成本的关键。

基础费率

附加费（在基础费率之上）

提现费用

🏪 Merchant of Record 模式深度解析

MoR 是 LemonSqueezy 最核心的价值主张。理解 MoR vs PSP 的区别，是理解 LemonSqueezy 费率是否"贵"的前提。

什么是 Merchant of Record？

MoR 是一个法律实体概念——在交易中，MoR 是法律上的卖家，而非支付通道。这意味着：

MoR vs PSP：本质区别

MoR 的资金流

🧮 费率计算器

⚔️ 三方对比：LemonSqueezy vs Paddle vs Gumroad

三个平台都声称自己是 MoR，但定位和费率差异显著。

费率对比一览

同场景费率实测

以 $30 产品为例，不同场景下三方的实际扣费：

功能对比雷达图（文字版）

🌍 税务处理机制

MoR 模式最大的价值在于税务。LemonSqueezy 的税务处理分为两种模式：

税外定价 (Tax-Exclusive)

税内定价 (Tax-Inclusive)

税务处理的注意事项

📅 结算与提现流程

🛠️ 核心功能清单

Dunning（追款）机制详解

🎯 适用场景决策矩阵

LemonSqueezy 最适合的 5 种人

🔧 API 实操示例

LemonSqueezy 提供 REST API，可用于自定义结账流程、License Key 验证、Webhook 集成等。

创建结账链接

# 创建结账链接（最常用的 API 调用）
curl -X POST https://api.lemonsqueezy.com/v1/checkouts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/vnd.api+json" \
  -H "Accept: application/vnd.api+json" \
  -d '{
    "data": {
      "type": "checkouts",
      "attributes": {
        "checkout_data": {
          "custom": {
            "user_id": "12345"
          }
        }
      },
      "relationships": {
        "store": {
          "data": {
            "type": "stores",
            "id": "1"
          }
        },
        "variant": {
          "data": {
            "type": "variants",
            "id": "1"
          }
        }
      }
    }
  }'

验证 License Key

# 验证 License Key（在你的应用中调用）
curl -X POST https://api.lemonsqueezy.com/v1/licenses/validate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/vnd.api+json" \
  -H "Accept: application/vnd.api+json" \
  -d '{
    "data": {
      "type": "licenses",
      "attributes": {
        "license_key": "YOUR_LICENSE_KEY",
        "instance_name": "my-app-instance"
      }
    }
  }'

Webhook 签名验证

# Node.js: 验证 LemonSqueezy Webhook 签名
import crypto from "crypto";

function verifyWebhook(payload, signature, secret) {
  const hmac = crypto.createHmac("sha256", secret);
  hmac.update(payload);
  const digest = hmac.digest("hex");
  // 使用时间安全比较防止时序攻击
  return crypto.timingSafeEqual(
    Buffer.from(digest, "hex"),
    Buffer.from(signature, "hex")
  );
}

// Express 中间件
app.post("/webhook/lemonsqueezy", (req, res) => {
  const signature = req.headers["x-signature"];
  const rawBody = JSON.stringify(req.body);

  if (!verifyWebhook(rawBody, signature, process.env.LS_WEBHOOK_SECRET)) {
    return res.status(401).send("Invalid signature");
  }

  // 处理事件
  const event = req.body;
  if (event.data.attributes.type === "subscription_created") {
    console.log("新订阅:", event.data.attributes.user_email);
    // 激活用户权限...
  }

  res.status(200).send("OK");
});

License Key 激活限制实现

# Python: 限制 License Key 激活设备数
import httpx
import os

LS_API_KEY = os.environ["LS_API_KEY"]
MAX_ACTIVATIONS = 3  # 每个 License 最多激活 3 台设备

async def activate_license(license_key: str, instance_name: str):
    """激活 License 并检查设备限制"""
    async with httpx.AsyncClient() as client:
        # 1. 验证 License
        resp = await client.post(
            "https://api.lemonsqueezy.com/v1/licenses/validate",
            headers={
                "Authorization": f"Bearer {LS_API_KEY}",
                "Content-Type": "application/vnd.api+json",
                "Accept": "application/vnd.api+json",
            },
            json={
                "data": {
                    "type": "licenses",
                    "attributes": {
                        "license_key": license_key,
                        "instance_name": instance_name,
                    }
                }
            }
        )
        data = resp.json()

        if resp.status_code != 200:
            return {"valid": False, "error": "Invalid license key"}

        # 2. 检查激活数
        activation_count = data["meta"]["activation_usage"]
        if activation_count >= MAX_ACTIVATIONS:
            return {
                "valid": False,
                "error": f"已达最大激活数 ({MAX_ACTIVATIONS})",
            }

        # 3. 激活
        activate_resp = await client.post(
            "https://api.lemonsqueezy.com/v1/licenses/activate",
            headers={
                "Authorization": f"Bearer {LS_API_KEY}",
                "Content-Type": "application/vnd.api+json",
            },
            json={
                "data": {
                    "type": "licenses",
                    "attributes": {
                        "license_key": license_key,
                        "instance_name": instance_name,
                    }
                }
            }
        )
        return {"valid": True, "data": activate_resp.json()}

❓ 常见问题

📝 总结