Guide

Polar, un merchant of record pour les créateurs de logiciels

Polar vend tes produits numériques et gère la TVA à ta place : tarifs, licence Apache et MIT, SDK 0.x, comparaison avec Lemon Squeezy et intégration pas à pas.

L'équipe CodeWorlds17 min de lecture ·

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

Crée un compte gratuit→
Dans cet article8

Polar vend tes produits numériques en son nom propre, et c'est lui, pas toi, qui répond devant les autorités fiscales de la TVA et de la sales tax. L'offre gratuite coûte 5 pour cent plus 50 cents par transaction, et trois offres payantes descendent jusqu'à 3,4 pour cent plus 30 cents pour 400 dollars par mois. Le serveur est sous licence Apache 2.0 et le SDK TypeScript sous MIT, en version 0.49.0 publiée le 20 juillet 2026.

Ce qu'est Polar, ce qu'il n'est pas, et pourquoi on le confond avec polars

Commence par la confusion qui fait perdre quinze minutes. Taper « polar » dans un moteur de recherche renvoie deux projets entièrement différents. Celui décrit ici est la plateforme de paiement de polar.sh. L'autre est polars, une bibliothèque de dataframes écrite en Rust et utilisée surtout depuis Python, publiée sur PyPI en version 1.43.2 sous MIT. Ils partagent cinq lettres et rien d'autre.

Polar est un merchant of record, c'est-à-dire le vendeur officiel. Cette distinction décide de tout le reste. Un processeur de paiement ordinaire, Stripe dans sa configuration standard par exemple, déplace de l'argent et s'arrête là. Le contrat de vente lie ton entreprise au client final, donc l'enregistrement TVA OSS, les seuils de nexus entre les États américains et les déclarations mensuelles restent ton devoir. Un merchant of record s'interpose entre toi et le client en tant que revendeur. La facture porte son numéro fiscal, il perçoit et reverse la taxe, et tu reçois un versement et un seul règlement avec un seul interlocuteur.

Le périmètre du produit est plus large qu'un paiement. Polar gère les abonnements avec essais et proratisation, la facturation à l'usage avec tes propres compteurs d'événements, la vente de sièges, les crédits prépayés et les réductions. Par-dessus se trouve un mécanisme d'avantages attaché à un produit. Dans le SDK, la liste des types d'avantages est fermée et se lit : custom, discord, github_repository, downloadables, license_keys, meter_credit, feature_flag et slack_shared_channel. En pratique, cela signifie qu'un acheteur reçoit automatiquement une invitation à un dépôt GitHub privé, un rôle Discord, une clé de licence ou un fichier téléchargeable allant jusqu'à 10 Go, sans aucune logique écrite de ton côté.

Ce que Polar ne fait pas. Ce n'est pas une passerelle de paiement pour des biens physiques ni un système de facturation pour du conseil. Il ne remplace pas non plus ta propre base de données, car les identifiants de commandes et d'abonnements sont mieux conservés en local, dans Supabase par exemple, que récupérés chez le fournisseur à chaque requête. Il n'envoie pas non plus les e-mails de ton produit, au-delà des confirmations d'achat, donc les notifications seront toujours construites sur quelque chose comme Resend.

La licence vérifiée auprès de trois sources

Pour des plateformes de ce genre, la licence du client et celle du serveur sont deux sujets distincts, et les confondre mène à de mauvaises décisions. J'ai vérifié trois endroits indépendants.

La première source est le fichier LICENSE du dépôt. Dans polarsource/polar, le dépôt du serveur, se trouve le texte complet de l'Apache License 2.0. GitHub affiche un onglet intitulé Apache-2.0 pour ce dépôt, qui compte environ 10,2 mille étoiles et n'est pas archivé. Le SDK TypeScript vit dans un dépôt séparé, polarsource/polar-js, où le fichier LICENSE contient le texte MIT avec la mention « Copyright (c) 2026 Polar Software Inc. ».

La deuxième source est le champ license des registres de paquets. Sur npm, @polar-sh/sdk en 0.49.0 indique MIT. Sur PyPI, polar-sdk en 0.32.0 indique MIT et porte le classifieur License :: OSI Approved :: MIT License.

La troisième source est le contenu du paquet publié, car une déclaration de registre est parfois de la fiction. L'archive npm de la 0.49.0 pèse 1,67 Mo, près de 20 Mo décompressée, et contient 9693 fichiers dont 2152 fichiers .js, un dossier src avec les sources TypeScript et un dossier dist en deux variantes, CommonJS et ESM. Le fichier LICENSE s'y trouve. La vérification de sécurité qui consiste à demander si le paquet contient du code passe ici. Le côté Python a l'air similaire : polar_sdk-0.32.0-py3-none-any.whl pèse 909 811 octets, contient 881 fichiers .py plus polar_sdk-0.32.0.dist-info/licenses/LICENSE, et son METADATA indique License: MIT.

Des divergences existent, et elles concernent les paquets d'aide. @polar-sh/nextjs en 0.9.6 et @polar-sh/better-auth en 1.8.4 n'ont aucun champ license dans leur package.json, donc le registre npm n'affiche aucune licence pour eux. Décompresser l'archive de @polar-sh/nextjs montre qu'un fichier LICENSE est en fait présent et contient le texte Apache 2.0. Pendant ce temps, @polar-sh/checkout en 0.4.1 et @polar-sh/adapter-utils en 0.4.6 déclarent explicitement Apache-2.0. Le résultat est qu'un seul arbre de dépendances te donne du MIT au cœur, de l'Apache 2.0 dans les adaptateurs et deux paquets sans déclaration, qu'un audit automatisé de licences signalera comme inconnus. Si ton entreprise tient une telle liste, inscris Apache 2.0 à la main d'après le fichier à l'intérieur du paquet plutôt que d'après les métadonnées.

Apache 2.0 sur le serveur est une bonne nouvelle, car SSPL ou AGPL apparaissent dans cette catégorie et excluent une partie des usages commerciaux. La valeur pratique de l'auto-hébergement est toutefois faible ici, car le produit n'est pas le code mais le statut de merchant of record. Faire tourner le dépôt sur ton propre serveur ne fera reverser ta TVA par personne d'autre.

Un SDK en dessous de la version 1.0 et ce que cela signifie en pratique

Le numéro 0.49.0 n'est ni un accident ni de la modestie. En versionnement sémantique, tout ce qui est inférieur à 1.0 libère l'auteur de toute promesse de compatibilité ascendante : un changement cassant peut arriver dans une version mineure. Et c'est arrivé. Le README du paquet comporte un avertissement explicite : à partir des versions supérieures à 0.6.0, le générateur du SDK a changé et la nouvelle version n'est pas rétrocompatible avec les précédentes.

L'historique des versions montre le rythme. Depuis la 0.1.0 du 13 octobre 2023 jusqu'à aujourd'hui, 161 versions ont été publiées. Parallèlement à la ligne 0.x court une ligne qui vise la version un point zéro : le tag next sur npm pointe vers 1.0.0-alpha.17 du 19 août 2026. Cela signifie que la version 1.0 est en préparation mais reste une alpha au moment de la rédaction, et ce que tu installes en production est la ligne d'avant la un.

Le SDK est généré par Speakeasy à partir d'une spécification OpenAPI, comme le montrent les en-têtes des fichiers sources. La conséquence est que chaque changement d'API atteint le code généré sans filtre humain. Les dépendances sont modestes : zod dans la plage ^3.25.65 || ^4.0.0 et standardwebhooks en ^1.0.0. Le build Python exige Python 3.9.2 ou plus récent et tire httpx, pydantic, jsonpath-python et standardwebhooks.

La conclusion opérationnelle est simple. Épingle une version exacte plutôt qu'une plage, garde les appels au SDK derrière ta propre fine couche d'adaptation et lis le changelog avant chaque mise à jour. C'est la même discipline que celle que tu appliques aux grands sauts de version dans Next.js, sauf que le risque est plus élevé ici car le numéro majeur n'a pas encore commencé.

Tarifs : offres, suppléments et versements

Les tarifs sont publiés à deux endroits, dans la documentation sur docs.polar.sh et sur le site marketing. J'ai vérifié les deux et cette fois les chiffres concordent, ce qui chez les fournisseurs de paiement n'est pas la règle.

OffreFrais mensuelsPar transactionSupport
Starter0 USD5 pour cent plus 50 centsstandard
Pro20 USD3,8 pour cent plus 40 centsprioritaire
Growth100 USD3,6 pour cent plus 35 centsprioritaire
Scale400 USD3,4 pour cent plus 30 centsprioritaire plus Slack et SSO

Un tarif historique existe à côté. Les organisations créées avant le 27 mai 2026 restent sur le tarif Early Member, c'est-à-dire 4 pour cent plus 40 cents avec un supplément de 0,5 pour cent sur les paiements d'abonnement et sans frais mensuels. Le piège est énoncé clairement : passer à une offre payante met fin définitivement à Early Member, et redescendre te fait atterrir sur Starter au nouveau tarif de 5 pour cent plus 50 cents. Les nouvelles organisations créées après cette date démarrent sur Starter, même ouvertes par un ancien compte.

Il y a deux suppléments et seulement deux. Plus 1,5 pour cent pour les cartes émises en dehors des États-Unis, et plus 0,5 pour cent pour les paiements d'abonnement sur le seul tarif Early Member. Starter, Pro, Growth et Scale n'ont aucun supplément distinct pour les abonnements, et c'est une vraie différence face à la concurrence.

Les versements sont réglés par Stripe et Polar indique n'y ajouter aucune marge. Les tarifs sont de 2 dollars pour chaque mois où un versement a eu lieu, plus 0,25 pour cent et 25 cents par versement, plus une conversion de devises de 0,25 pour cent au sein de l'Union européenne et jusqu'à 1 pour cent ailleurs. Un litige avec la banque du client coûte 15 dollars quelle qu'en soit l'issue. Quand tu rembourses un client, les frais de la transaction d'origine ne te reviennent pas.

J'ai vérifié séparément l'arithmétique du seuil de rentabilité, car le fournisseur la présente sous forme de chiffres tout faits : 1 379 dollars de ventes mensuelles pour Pro, 5 634 pour Growth et 19 048 pour Scale. Ces valeurs ne ressortent que sous l'hypothèse que la transaction moyenne est d'environ 40 dollars, ce que la page ne dit nulle part. Pour Pro, l'écart de taux est de 1,2 point et l'écart de frais fixes de 10 cents, donc l'équation 0,012 fois les ventes plus 0,10 fois le nombre de transactions égale à 20 ne donne 1 379 dollars qu'à 34,5 transactions par mois. Le même facteur de 40 dollars reproduit les deux autres seuils au dollar près. Si tu vends un produit à 9 dollars, ton propre seuil se situe tout à fait ailleurs et tu devrais le calculer toi-même.

Polar face à Lemon Squeezy sur un montant concret

C'est la question qui guide réellement le choix. Lemon Squeezy prend 5 pour cent plus 50 cents, appartient à Stripe et a lui-même annoncé un successeur ainsi qu'une migration des utilisateurs vers Stripe Managed Payments. Polar prend la même chose sur l'offre gratuite mais diffère par la structure des suppléments.

PostePolar StarterLemon Squeezy
Frais de base5 pour cent plus 50 cents5 pour cent plus 50 cents
Cartes internationalesplus 1,5 pour centplus 1,5 pour cent
Paiement d'abonnementaucun supplémentplus 0,5 pour cent
Paiement PayPalnon pris en chargeplus 1,5 pour cent
Tarifs plus bas contre des frais mensuelsoui, à partir de 20 USD par moisaucune option de ce genre
Versement hors des États-Unis2 USD par mois plus 0,25 pour cent et 25 cents plus conversion1 pour cent du versement
Litige bancaire15 USD15 USD
Propriétaireentreprise indépendanteStripe

Prenons un abonnement à 29 dollars vendu à un client en Pologne, avec 23 pour cent de TVA et une carte émise en dehors des États-Unis. La valeur de la transaction est de 35,67 dollars. Sur Polar Starter, les frais sont de 1,78 plus 0,50 plus 0,54, soit 2,82 dollars. Sur Lemon Squeezy, le supplément d'abonnement de 0,18 dollar s'ajoute, donc cela donne 3,00 dollars. La différence sur une seule transaction est de 18 cents.

Sur un mois, elle grandit, car les versements s'y joignent. Avec vingt abonnements de ce type, soit 580 dollars de revenu de base, Polar prend 56,37 dollars de frais plus environ 4,87 dollars pour un versement vers un compte au sein de l'Union européenne, soit 61,24 dollars au total, ou 10,6 pour cent. Lemon Squeezy prend 59,93 dollars de frais plus 5,20 dollars de coût de versement, soit 65,13 dollars, ou 11,2 pour cent. Le gain à changer est inférieur à quatre dollars par mois et ne justifie pas une migration à lui seul.

Le tableau change avec l'échelle. À deux cents abonnements, soit 5 800 dollars par mois, l'offre Growth coûte 433,82 dollars de frais plus 100 dollars d'abonnement plus environ 29 dollars de coût de versement, soit 562,90 dollars au total, ou 9,7 pour cent. Lemon Squeezy dans les mêmes conditions coûte 651,35 dollars, ou 11,2 pour cent. La différence est de 88 dollars par mois et de plus de mille par an. C'est seulement ici que le calcul a un sens.

Il faut dire aussi l'inverse. À 580 dollars par mois, l'offre Pro coûterait 70,73 dollars au lieu de 61,24 sur Starter, car un abonnement de 20 dollars ne se rentabilise pas à ce volume. Une offre payante en dessous du seuil est de l'argent perdu, et le seuil dépend de la valeur moyenne du panier, pas seulement du chiffre d'affaires.

L'intégration en pratique

Installation et choix de l'environnement. Polar propose un environnement de test distinct et tu y bascules avec un seul paramètre, sans changer aucune URL dans le code.

Bash
npm install @polar-sh/sdk
npm install @polar-sh/nextjs
export POLAR_ACCESS_TOKEN="polar_oat_..."
export POLAR_WEBHOOK_SECRET="whsec_..."

Créer une session de paiement. Le champ products est obligatoire et prend un tableau d'identifiants, le reste est facultatif. Les valeurs par défaut du schéma sont allowDiscountCodes à true et requireBillingAddress à false.

TypeScript
import { Polar } from '@polar-sh/sdk'

const polar = new Polar({
  accessToken: process.env.POLAR_ACCESS_TOKEN,
  server: 'sandbox'
})

const checkout = await polar.checkouts.create({
  products: ['5b2a0f4c-3f11-4a1e-9c33-2f0a4d8b1f77'],
  successUrl: 'https://yourapp.com/thanks?checkout_id={CHECKOUT_ID}',
  customerEmail: 'john@example.com',
  externalCustomerId: 'user_8213',
  allowDiscountCodes: true,
  requireBillingAddress: false,
  metadata: { plan: 'pro', source: 'pricing-page' }
})

console.log(checkout.url, checkout.clientSecret, checkout.totalAmount)

Recevoir des événements. La signature est vérifiée selon la spécification Standard Webhooks, et validateEvent renvoie un événement analysé ou lève WebhookVerificationError. Les noms d'événements utilisent une forme pointée, dont order.paid, subscription.active, subscription.past_due, checkout.updated et customer.state_changed.

TypeScript
import { validateEvent, WebhookVerificationError } from '@polar-sh/sdk/webhooks'

export async function POST(request: Request) {
  const body = await request.text()
  const headers = Object.fromEntries(request.headers)

  try {
    const event = validateEvent(body, headers, process.env.POLAR_WEBHOOK_SECRET!)

    if (event.type === 'order.paid') {
      await grantAccess(event.data.customerId, event.data.productId)
    }

    return new Response('', { status: 202 })
  } catch (error) {
    if (error instanceof WebhookVerificationError) {
      return new Response('', { status: 403 })
    }
    throw error
  }
}

Les clés de licence pour une application installée en local. La méthode validate prend un key et un organizationId obligatoires, et en option activationId, benefitId, customerId, incrementUsage et conditions. La réponse contient entre autres status, usage, limitUsage, limitActivations, validations, lastValidatedAt et expiresAt.

TypeScript
const license = await polar.licenseKeys.validate({
  key: 'POLAR-1A2B-3C4D-5E6F',
  organizationId: 'e2ff1d55-84e2-4b47-9d9e-8b8a1c0f2a11',
  incrementUsage: 1,
  conditions: { major_version: 3 }
})

if (license.status !== 'granted') {
  throw new Error('License inactive')
}

console.log(license.usage, license.limitUsage, license.expiresAt)

Si ton authentification tourne déjà sur Better Auth, le paquet @polar-sh/better-auth en 1.8.4 s'y branche comme plugin et liste des dépendances peer de @polar-sh/sdk dans la plage ^0.47.0, de better-auth dans la plage ^1.4.12 et de zod. L'adaptateur @polar-sh/nextjs en 0.9.6 exige Next dans la plage ^15.0.0 || ^16.0.0 et propose des helpers Checkout, CustomerPortal et Webhooks prêts à monter sur des routes. Déployer sur Vercel ne demande rien de plus que des variables d'environnement.

Erreurs courantes

Projeter ses revenus à partir du tarif affiché. En vendant des abonnements en Europe, le coût réel sur l'offre gratuite tombe autour de 10,6 pour cent plutôt que 5 pour cent, car le supplément pour cartes internationales et le coût des versements s'y ajoutent. Pour une prévision, utilise le chiffre calculé pour ton propre cas.

Acheter trop tôt une offre payante. Un abonnement de 20 dollars ne se rentabilise qu'au-dessus d'un seuil qui, avec un panier moyen de 40 dollars, se situe à 1 379 dollars de ventes mensuelles. En dessous de cette ligne, l'offre payante coûte plus cher que la gratuite.

Traiter les seuils de rentabilité comme universels. Les chiffres donnés par le fournisseur supposent une transaction moyenne d'environ 40 dollars. Avec un produit moins cher, les frais fixes pèsent plus et le seuil monte.

Se fier au champ license lors d'un audit de dépendances. Deux paquets d'adaptation ne déclarent aucune licence dans leurs métadonnées, même si le fichier Apache 2.0 se trouve dans le paquet. Un outil automatisé les signalera comme inconnus et quelqu'un devra trancher à la main.

Installer le SDK avec une plage de versions. Avec un numéro majeur à zéro, un changement cassant peut arriver dans une version mineure, ce qui est déjà arrivé quand le générateur a changé après la 0.6.0. Épingle une version exacte.

Supposer qu'Apache 2.0 sur le serveur te permet d'échapper au fournisseur. Tu peux exécuter le code toi-même, mais le rôle de merchant of record ne se copie pas, car c'est un contrat et un ensemble d'enregistrements fiscaux, pas un dépôt.

Ignorer le coût des litiges. Quinze dollars par litige bancaire sur un produit à 19 dollars signifient que deux litiges pour cent transactions mangent tout le bénéfice de cinq ventes.

FAQ

Polar est-il moins cher que Lemon Squeezy ?

Sur l'offre gratuite, à peine, car les deux plateformes facturent 5 pour cent plus 50 cents et le même supplément de 1,5 pour cent pour les cartes internationales, la différence venant de l'absence de supplément de 0,5 pour cent sur les abonnements et de versements moins chers. À 580 dollars par mois, l'économie est d'environ 4 dollars. À 5 800 dollars sur l'offre Growth, l'écart passe à environ 88 dollars par mois.

Que signifie la version 0.49.0 pour la stabilité de l'intégration ?

Un numéro majeur à zéro libère l'auteur de toute promesse de compatibilité ascendante, donc un changement cassant peut arriver dans une version mineure ordinaire. C'est arrivé quand le générateur a changé après la 0.6.0. La ligne 1.0.0-alpha.17 existe mais est une alpha sous le tag next au moment de la rédaction, tandis que latest publie encore la ligne 0.x.

Quelle licence le serveur Polar utilise-t-il ?

Le dépôt polarsource/polar contient le texte complet de l'Apache License 2.0 dans son fichier LICENSE. C'est une licence permissive avec une clause de brevets, donc sans les restrictions typiques d'AGPL ou de SSPL. Le SDK TypeScript est sous MIT, tandis que certains paquets d'aide sont sous Apache 2.0 ou ne portent aucune déclaration dans les métadonnées npm.

Polar permet-il de vendre l'accès à un dépôt privé ?

Oui, dans le SDK le type d'avantage s'appelle github_repository et après l'achat le client reçoit automatiquement une invitation au dépôt privé choisi. À côté, tu disposes de clés de licence, de fichiers téléchargeables allant jusqu'à 10 Go, de rôles Discord, de feature flags et de crédits pour un compteur d'usage.

Quel est le risque de s'engager avec Polar pour des années ?

L'entreprise est plus jeune et plus petite que Stripe ou Paddle, le dépôt compte environ 10,2 mille étoiles et la communauté est proportionnellement plus petite, donc tu trouveras moins de réponses toutes faites à un problème inhabituel. Un SDK d'avant la version 1.0 s'y ajoute. Garde les identifiants de commandes de ton côté et cache les appels au fournisseur derrière ta propre interface, pour que remplacer la couche de paiement prenne un jour plutôt qu'un trimestre.

À lire aussi