Guide

Lemon Squeezy : le merchant of record pour vendre du numérique

Lemon Squeezy vend tes produits numériques en son nom et gère la TVA. Frais réels, statut après le rachat par Stripe, webhooks, licences, SDK et alternatives.

L'équipe CodeWorlds20 min de lecture ·

Pratique HTML et CSS dans des leçons interactives avec un éditeur de code.

Crée un compte gratuit→
Dans cet article10

Lemon Squeezy vend tes produits numériques en son propre nom, et c'est lui, et non toi, qui répond devant les autorités fiscales de la TVA et de la sales tax. Tu paies pour cela 5 pour cent plus 50 cents par transaction. Au 22 août 2026, la plateforme accepte encore de nouveaux vendeurs, mais elle appartient à Stripe et construit en parallèle son propre successeur sous un autre nom.

Ce que fait un merchant of record

Un merchant of record est l'entreprise qui est formellement le vendeur face à ton client. Son nom apparaît sur le reçu et sur le relevé de carte, il émet le document de vente, il facture la taxe selon le lieu de résidence de l'acheteur, il dépose les déclarations et paie la taxe à la bonne autorité. Tu vends le produit à cette entreprise et elle le revend. Ta seule relation fiscale est avec elle, pas avec mille clients répartis sur quarante juridictions.

Cette distinction décide si un article sur Lemon Squeezy a même un sens. Des frais de 5 pour cent paraissent chers à côté de 2,9 pour cent chez un simple processeur de paiement, jusqu'à ce que tu chiffres l'inscription au guichet unique OSS pour la TVA, le suivi des seuils de nexus dans les États américains, les déclarations mensuelles et le comptable qui gère tout cela. Pour une entreprise d'une personne qui vend un outil à 29 dollars par mois, la différence de pourcentage est moins chère que la différence d'heures.

Le périmètre est limité aux produits numériques : SaaS, téléchargements, abonnements, adhésions, formations. Tu ne peux pas y vendre de biens physiques, et la liste des produits interdits dans la documentation est plus longue qu'on ne s'y attendrait.

Le statut de la plateforme après le rachat par Stripe

Stripe a racheté Lemon Squeezy le 26 juillet 2024. Ce n'est pas une rumeur mais un article du blog de la plateforme elle-même. Depuis, le statut du produit a assez changé pour qu'il faille le dire clairement avant de décider quoi que ce soit.

Le 28 janvier 2026, JR Farr, le cofondateur qui signe désormais « Co-Founder, Lemon Squeezy (Stripe) », a publié un article qui résume cette période. Il y admet trois choses. Premièrement, l'équipe a surtout travaillé sur Stripe Managed Payments, la solution de merchant of record construite à l'intérieur de Stripe. Deuxièmement, cela a coûté à la communauté de Lemon Squeezy des réponses de support plus lentes et des mises à jour du produit moins fréquentes. Troisièmement, l'objectif est « to provide Lemon Squeezy users an easy way to migrate to Stripe Managed Payments ».

Aucune date de fermeture n'apparaît nulle part. L'inscription fonctionne, les tarifs sont publiés, la documentation est mise à jour et le site marketing t'invite à ouvrir un compte. En même temps, Stripe Managed Payments prend en charge des commerçants dans plus de 35 pays selon cet article, tandis que la documentation de Stripe parle de conformité fiscale dans plus de 80 pays. Ce sont deux chiffres différents qui décrivent deux périmètres différents et ils ne doivent pas être confondus.

Il y a un détail de plus que tu ne trouveras pas dans un communiqué de presse. Le pied de page de lemonsqueezy.com indique aujourd'hui « Sold through Link, LLC f/k/a Lemon Squeezy LLC », ce qui signifie que l'entité juridique a été renommée, f/k/a voulant dire « formerly known as ». Le pied de page de la documentation technique indique toujours « Lemon Squeezy, LLC ». Si tu signes un contrat ou inscris une contrepartie dans tes livres, vérifie quel nom figure dans tes propres conditions, car le fournisseur n'est pas cohérent ici.

La conclusion pratique : Lemon Squeezy convient aujourd'hui pour démarrer les ventes, mais pas pour planifier cinq ans à l'avance sans plan de sortie. Considère l'intégration comme quelque chose que tu réécriras un jour vers Stripe Managed Payments ou Paddle. Garde les identifiants de commandes et d'abonnements dans ta propre base de données, par exemple dans Supabase, au lieu d'interroger l'API du fournisseur à chaque requête.

Frais, suppléments et arithmétique

Le titre de la page tarifaire est 5 pour cent plus 50 cents par transaction sans abonnement mensuel. La documentation des frais ajoute trois suppléments faciles à manquer parce qu'ils sont absents de la page des tarifs :

  • plus 1,5 pour cent pour les transactions internationales, c'est-à-dire hors des États-Unis,
  • plus 1,5 pour cent pour les paiements PayPal,
  • plus 0,5 pour cent pour les paiements d'abonnement.

Les frais sont calculés sur la valeur totale de la commande, donc y compris la taxe qui va de toute façon à l'autorité. Ce n'est pas évident et cela augmente le coût effectif.

Les frais de versement s'y ajoutent. Un virement bancaire via Stripe est gratuit pour les comptes américains et coûte 1 pour cent pour les comptes hors des États-Unis. PayPal coûte 50 cents par versement pour les comptes américains et 3 pour cent plafonnés à 30 dollars pour les autres. Les versements ont lieu deux fois par mois. Les fonctionnalités marketing sont facturées séparément : plus 5 pour cent sur les paiements récupérés via les e-mails de panier abandonné, plus 3 pour cent sur les recommandations d'affiliation côté commerçant, et plus 2 pour cent sur les versements d'affiliation.

Appliquons cela à un abonnement mensuel de 29 dollars vendu à un client en Pologne, par carte, versé sur un compte bancaire polonais.

ÉlémentMontant
Prix du produit29,00 USD
TVA à 23 pour cent6,67 USD
Total de la commande35,67 USD
Frais fixes0,50 USD
5 pour cent de 35,671,78 USD
1,5 pour cent de transaction internationale0,54 USD
0,5 pour cent d'abonnement0,18 USD
Total des frais de plateforme3,00 USD
Dû avant les frais de versement26,00 USD
Frais de versement, 1 pour cent0,26 USD
Sur ton compte25,74 USD

Tu abandonnes en réalité 3,26 dollars sur 29, soit 11,2 pour cent, et non les 5 pour cent du titre. Le même calcul pour une vente unique de 49 dollars à un client américain, sans taxe d'État et avec un versement sur un compte américain, donne des frais de 2,95 dollars, soit 6,0 pour cent. L'écart entre 6 et plus de 11 pour cent dépend de l'endroit où tu te trouves et de ceux à qui tu vends.

La documentation des frais propose son propre exemple et son arithmétique tient : un produit de 20 dollars, la TVA française à 20 pour cent ajoute 4 dollars, total de la commande 24 dollars, frais de 0,50 plus 1,20 plus 0,36 égale 2,06 dollars, dû 17,94 dollars. Note que pour les produits à moins de 10 dollars, les 50 cents fixes mangent une part si grande du prix que le fournisseur renvoie lui-même ces cas vers son équipe commerciale pour un tarif sur mesure.

Deux chiffres du fournisseur se contredisent et je donne les deux. La page des tarifs indique 16 moyens de paiement à un endroit et jusqu'à 21 à un autre. La même page cite la prise en charge de 95 devises dans le tableau comparatif et plus de 130 dans la section des questions. Il n'y a aucun moyen de savoir quel chiffre est à jour, donc pars sur le plus bas pour planifier.

Lemon Squeezy, Paddle et Stripe côte à côte

La différence la plus importante de ce tableau ne se trouve pas dans les pourcentages mais dans la ligne sur la responsabilité fiscale.

CritèreLemon SqueezyPaddleStripe en configuration standard
Merchant of recordouiouinon
Qui est responsable de la TVAle fournisseurle fournisseurtoi
Frais de base5 pour cent plus 50 cents5 pour cent plus 50 cents1,5 pour cent plus 1,00 PLN pour les cartes standard de l'EEE
Cartes internationalesplus 1,5 pour centinclus3,25 pour cent plus 1,00 PLN
Conversion de deviseincluseincluseplus 2 pour cent
Calcul de la taxeinclusinclusStripe Tax, 0,5 pour cent par transaction
Dépôt des déclarationsinclusinclusde ton côté
Frais de versement1 pour cent hors des États-Unisabsent de la grille tarifairedépend du pays
Dernière version officielle du SDK4.0.0, 5 novembre 20243.10.0, 7 août 202622.5.0, 10 août 2026

Les tarifs Stripe viennent de la grille servie pour la Pologne, car la tarification de Stripe dépend du pays du compte. Ce qui compte, c'est la dernière ligne de la colonne du milieu avec la ligne sur le dépôt des déclarations : avec Stripe tu paies moins en pourcentage, mais l'inscription à la TVA de l'UE, les seuils de nexus américains et les déclarations mensuelles restent ton problème. Stripe Tax calculera la taxe, mais il ne la paiera pas à ta place et ne déposera rien. Si tu vends une douzaine de licences par mois, cette différence pèse plus que chaque point de pourcentage du tableau.

Un acteur manque dans le tableau qui, au même tarif d'entrée, offre quelque chose que Lemon Squeezy n'offre pas. Polar est lui aussi un merchant of record et démarre aussi à 5 pour cent plus 50 cents, mais il propose des offres payantes qui abaissent le taux à 3,4 pour cent contre un abonnement mensuel fixe, donc au-delà d'un certain chiffre d'affaires il revient nettement moins cher. Il ne facture pas non plus de supplément d'abonnement séparé. Deux inconvénients sont à peser : c'est une société bien plus jeune et plus petite, sans le soutien de Stripe, et son paquet JavaScript porte encore un numéro de version inférieur à 1.0, ce qui signifie que l'interface peut encore changer.

Checkout hébergé et overlay

Tu as trois façons de faire payer un client. La plus simple est un lien de checkout hébergé généré dans le tableau de bord et collé n'importe où. La deuxième est l'overlay, le même checkout ouvert dans une fenêtre modale au-dessus de ta page sans quitter l'application. La troisième est un checkout créé via l'API, quand tu veux remplacer le prix, préremplir des données ou transmettre tes propres métadonnées.

Tu ne peux pas construire ton propre formulaire de paiement. Les numéros de carte sont toujours collectés par Lemon Squeezy, car il est le vendeur et porte la responsabilité PCI. Tu peux ajuster les couleurs et les textes, pas la mise en page.

TypeScript
import {
  lemonSqueezySetup,
  createCheckout,
} from '@lemonsqueezy/lemonsqueezy.js'

lemonSqueezySetup({
  apiKey: process.env.LEMONSQUEEZY_API_KEY,
  onError: (error) => console.error(error.message),
})

const { data, error } = await createCheckout(
  process.env.LEMONSQUEEZY_STORE_ID!,
  process.env.LEMONSQUEEZY_VARIANT_ID!,
  {
    checkoutData: {
      email: user.email,
      name: user.name,
      custom: { user_id: user.id },
    },
    productOptions: {
      redirectUrl: 'https://example.com/dashboard',
      receiptThankYouNote: 'Your licence key is in this email.',
      enabledVariants: [Number(process.env.LEMONSQUEEZY_VARIANT_ID)],
    },
    checkoutOptions: {
      embed: true,
      media: false,
      subscriptionPreview: true,
      buttonColor: '#111827',
    },
    testMode: process.env.NODE_ENV !== 'production',
    expiresAt: null,
  },
)

if (error) throw new Error(error.message)
const url = data?.data.attributes.url

Le champ checkoutData.custom est celui sur lequel la plupart des gens trébuchent. Il arrive dans la charge utile du webhook sous meta.custom_data et c'est le seul moyen fiable de relier une commande à un utilisateur dans ta base. N'utilise pas l'adresse e-mail pour cela, car un client peut payer avec une autre adresse que celle avec laquelle il s'est inscrit.

L'overlay a besoin du script Lemon.js et de l'objet global LemonSqueezy. Il y a quatre méthodes plus deux pour l'affiliation : Setup, Refresh, Url.Open, Url.Close, Affiliate.GetID et Affiliate.Build.

JavaScript
LemonSqueezy.Setup({
  eventHandler: (event) => {
    if (event.event === 'Checkout.Success') {
      // event.data holds the order object, but trust the webhook instead
      window.location.href = '/dashboard?pending=1'
    }
  },
})

LemonSqueezy.Url.Open(checkoutUrl)

Les événements disponibles sont Checkout.Success, PaymentMethodUpdate.Mounted, PaymentMethodUpdate.Closed et PaymentMethodUpdate.Updated. Dans une application monopage, pense à LemonSqueezy.Refresh() après un changement de vue, car les écouteurs de boutons ne sont attachés qu'une fois au chargement.

Webhooks et vérification de signature

Accorder l'accès dans ton application doit reposer sur un webhook, pas sur la redirection après paiement. Une redirection peut être falsifiée en visitant simplement cette URL.

Lemon Squeezy signe la requête avec un secret que tu fixes toi-même en créant le webhook, d'une longueur de 6 à 40 caractères. La signature arrive dans l'en-tête X-Signature sous forme de HMAC SHA-256 hexadécimal du corps brut de la requête.

TypeScript
import crypto from 'node:crypto'

export async function POST(request: Request) {
  const raw = await request.text()
  const secret = process.env.LEMONSQUEEZY_WEBHOOK_SECRET!

  const digest = Buffer.from(
    crypto.createHmac('sha256', secret).update(raw).digest('hex'),
    'utf8',
  )
  const signature = Buffer.from(
    request.headers.get('X-Signature') ?? '',
    'utf8',
  )

  if (
    digest.length !== signature.length ||
    !crypto.timingSafeEqual(digest, signature)
  ) {
    return new Response('Invalid signature', { status: 401 })
  }

  const payload = JSON.parse(raw)
  const eventName = payload.meta.event_name
  const userId = payload.meta.custom_data?.user_id

  if (eventName === 'subscription_created') {
    // grant access to the user identified by userId
  }

  return new Response('ok', { status: 200 })
}

Trois choses cassent le plus souvent cette vérification. La première est un corps de requête déjà analysé : un framework qui appelle JSON.parse pour toi changera l'ordre des clés ou le formatage et la signature ne correspondra plus, donc il te faut le texte brut. La deuxième est timingSafeEqual, qui lève une exception quand les tampons ont des longueurs différentes, c'est pourquoi la longueur est vérifiée d'abord. La troisième concerne les edge functions : dans Next.js, la route du webhook doit s'exécuter sur le runtime Node car elle utilise le module node:crypto, et sur Vercel la valeur par défaut peut différer de ce que tu supposes.

Il y a dix-sept événements : de order_created et order_refunded, en passant par le cycle complet de l'abonnement de subscription_created à subscription_expired, jusqu'à license_key_created, customer_updated et affiliate_activated. Un ensemble minimal sensé pour les abonnements est subscription_created, subscription_updated, subscription_payment_success et subscription_expired. L'événement subscription_updated est un fourre-tout et porte toujours l'état actuel, donc si tu n'en gères qu'un, gère celui-là.

Envoie l'e-mail transactionnel après avoir accordé l'accès par ton propre canal, par exemple via Resend, car le module de messagerie intégré de Lemon Squeezy est facturé séparément selon le nombre d'abonnés et vise les newsletters plutôt que les notifications système.

Clés de licence et mode test

Les clés de licence sont la fonctionnalité qui fait choisir Lemon Squeezy à certaines équipes plutôt qu'un simple processeur de paiement. Après un achat, une clé est générée, et une application de bureau l'active sous un nom d'instance, ce qui permet de plafonner le nombre de postes.

L'API de licences est séparée de l'API principale, a sa propre limite de 60 requêtes par minute au lieu de 300, et n'a pas besoin de clé d'API, ce qui permet de l'appeler directement depuis une application cliente.

Bash
# activate a key on a specific machine
curl -X POST https://api.lemonsqueezy.com/v1/licenses/activate \
  -H "Accept: application/json" \
  -d "license_key=38b1460a-5104-4067-a91d-77b872934d51" \
  -d "instance_name=Anna's MacBook Pro"

# validate on application startup
curl -X POST https://api.lemonsqueezy.com/v1/licenses/validate \
  -H "Accept: application/json" \
  -d "license_key=38b1460a-5104-4067-a91d-77b872934d51" \
  -d "instance_id=47596ad9-a811-4ebf-ac8a-03fc7b6d2a17"

La réponse contient les champs activated, error, license_key, instance et meta. Dans l'objet license_key, tu obtiens status, activation_limit, activation_usage et expires_at. Le statut prend quatre valeurs : inactive pour une clé sans activation, active avec au moins une, expired une fois le terme passé ou l'abonnement terminé, et disabled après une désactivation manuelle dans le tableau de bord.

Le mode test est le mode par défaut sur un nouveau compte et couvre tout le flux : checkout, abonnements, clés de licence et webhooks. Les clés d'API sont liées à un mode, donc une clé de test ne touche jamais les données de production. Les cartes de test comprennent 4242 4242 4242 4242 pour Visa, 4000 0000 0000 9995 pour fonds insuffisants et 4000 0027 6000 3184 pour 3D Secure. Deux pièges : les téléchargements de fichiers sont désactivés en mode test, donc tu ne peux pas y tester la livraison de fichiers, et les produits créés en mode test ne passent pas en production tout seuls, ce à quoi sert l'option « Copy to Live Mode ».

Le SDK, sa licence et ce qui manque

Voici la partie qu'il faut dire clairement. Le paquet officiel @lemonsqueezy/lemonsqueezy.js est en version 4.0.0, publiée le 5 novembre 2024. Aucune version n'a paru depuis, soit plus de 21 mois de silence. J'ai aussi vérifié la branche principale du dépôt lmsqueezy/lemonsqueezy.js : le package.json sur main indique aussi 4.0.0, donc il n'y a même pas de changements non publiés qui attendent dans la file.

Bash
# state as of 22 August 2026
npm view @lemonsqueezy/lemonsqueezy.js version   # 4.0.0
npm view @lemonsqueezy/lemonsqueezy.js time.4.0.0 # 2024-11-05
npm install @lemonsqueezy/lemonsqueezy.js

Les conséquences sont mesurables, pas théoriques. Le type Events du SDK liste quinze événements de webhook alors que la documentation de l'API en liste dix-sept. Les manquants sont customer_updated et affiliate_activated. Si tu crées un webhook via createWebhook et veux t'abonner à l'un d'eux, TypeScript rejettera une valeur parfaitement valide. Le contournement est trivial, un cast suffit, mais il en dit long sur l'état de cette bibliothèque.

Pour le reste, le paquet est correct : 59 fonctions, types TSDoc complets, aucune dépendance de production, engines.node fixé à la version 20 ou plus récente, construit en variantes ESM et CommonJS. Les noms de fonctions sont prévisibles, de listSubscriptions et updateSubscription à createUsageRecord et issueOrderRefund.

La licence est l'un des rares endroits où tout concorde, et cela mérite d'être mentionné car c'est souvent l'inverse. J'ai vérifié trois sources. Le fichier LICENSE sur la branche principale du dépôt porte le texte MIT avec la mention « Copyright (c) 2024 Lemon Squeezy, LLC ». Le champ license du registre npm indique MIT. Le paquet publié se décompresse en 340 ko, contient package/LICENSE avec le même texte et du vrai code dans dist/index.js et dist/index.cjs plutôt qu'une coquille vide. Trois sources, une réponse, aucune surprise.

Fais attention au périmètre : la licence MIT couvre un client HTTP, pas la plateforme. Le service lui-même est fermé et fonctionne selon des conditions que le fournisseur peut changer. Une licence de SDK ouverte ne te donne aucun moyen de faire tourner Lemon Squeezy sur tes propres machines.

L'écosystème au-delà du paquet JavaScript se compose d'un paquet Laravel officiel et de bibliothèques communautaires non officielles pour Go, Ruby, Rust, Swift, Python, PHP, Elixir et Java. Toutes ces dernières sont maintenues par des individus isolés, donc vérifie la date de la dernière version avant de les mettre dans ton go.mod ou ton Gemfile.

Erreurs courantes

Accorder l'accès d'après la redirection après paiement. Quiconque devine le redirectUrl peut l'ouvrir. N'accorde les droits qu'après un webhook vérifié, et traite la redirection comme un écran « en cours de traitement ».

Associer les comptes par adresse e-mail. Un client paie avec une adresse professionnelle alors qu'il s'est inscrit avec une personnelle, et le compte se retrouve sans abonnement. Transmets l'identifiant de l'utilisateur via checkoutData.custom et lis-le dans meta.custom_data.

Prévoir le chiffre d'affaires d'après le titre de la page tarifaire. En vendant depuis l'Europe vers l'Europe, le vrai coût est d'environ 11 pour cent, car les suppléments international, d'abonnement et de versement s'additionnent. Budgète avec le chiffre calculé pour ton propre cas, pas avec 5 pour cent.

Analyser le corps de la requête avant de vérifier la signature. Un middleware qui transforme automatiquement le JSON en objet invalide le HMAC. Il te faut le texte brut avant que quoi que ce soit n'y touche.

Ne pas gérer les réémissions. Le même webhook peut arriver deux fois. Stocke l'identifiant de l'événement et rends le traitement idempotent, sinon un seul paiement créditera deux périodes de facturation.

Traiter le module de messagerie comme un système d'autorisation. Lemon Squeezy connaît les commandes mais ignore tout des sessions dans ton application. La connexion et les permissions restent de ton côté, dans Better Auth ou Clerk, et le paiement n'est qu'un indicateur attaché à un compte.

Repousser le plan de sortie. Puisque le fournisseur lui-même parle de migrer vers Stripe Managed Payments, garde la couche de paiement derrière ta propre interface avec deux ou trois méthodes. Remplacer l'implémentation prend alors une journée plutôt qu'un trimestre.

FAQ

Lemon Squeezy accepte-t-il encore de nouveaux clients ?

Oui. Au 22 août 2026, l'inscription fonctionne, les tarifs sont publiés et la documentation est mise à jour. Aucune date de fermeture n'est annoncée. Il y a toutefois un article officiel du 28 janvier 2026 sur la construction de Stripe Managed Payments et l'intention de donner aux utilisateurs une migration facile, donc pars du principe que tu déménageras tôt ou tard.

Combien est-ce que je garde réellement d'une vente ?

Sur un abonnement de 29 dollars vendu à un client en Pologne, avec 23 pour cent de TVA et un versement hors des États-Unis, 25,74 dollars arrivent sur ton compte, ce qui signifie un coût de 11,2 pour cent du prix net. Sur une vente unique de 49 dollars à un client américain versée sur un compte américain, le coût tombe à 6,0 pour cent.

En quoi Lemon Squeezy diffère-t-il de Stripe ?

Lemon Squeezy est un merchant of record et prend en charge le calcul, le dépôt et le paiement de la TVA et de la sales tax. Stripe en configuration standard est un processeur de paiement, donc les obligations fiscales restent chez toi, et Stripe Tax ne fait que calculer la taxe pour 0,5 pour cent de plus par transaction. L'écart de pourcentage compte moins que l'écart de responsabilité.

Puis-je construire mon propre formulaire de paiement ?

Non. Les données de carte sont toujours collectées par Lemon Squeezy, car il est le vendeur formel. Tes options sont le checkout hébergé, l'overlay Lemon.js et une session créée via l'API avec un prix remplacé et des données préremplies. Tu personnalises les couleurs, les textes et la visibilité des éléments, pas la mise en page.

Un SDK sans version depuis 2024 exclut-il la plateforme ?

Il ne l'exclut pas, mais il faut l'intégrer dans le coût. L'API est versionnée avec le préfixe /v1 et promet la rétrocompatibilité, donc les appels existants continuent de fonctionner. Les lacunes se voient dans les types, par exemple deux événements de webhook manquent dans le type Events. Si tu préfères ne pas contourner cela, appelle directement l'API avec fetch.

Les clés de licence suffisent-elles pour protéger une application de bureau ?

Elles suffisent pour compter les postes et révoquer l'accès, car activation_limit avec activation_usage plafonnent le nombre d'instances et une clé peut être désactivée depuis le tableau de bord. Elles ne protègent pas contre le piratage, car la validation se fait côté client et la limite de 60 requêtes par minute t'oblige à mettre le résultat en cache localement.

À lire aussi