Configurer Creem : checkout Next.js étape par étape
Creem est ce qui ressemble le plus à un checkout hébergé de type Stripe avec un Merchant of Record attaché. Il gère la taxe de vente et la TVA pour vous, ce qui explique des frais plus élevés qu'un processeur brut — l'arbitrage est expliqué dans l'aperçu du Merchant of Record. Ce tutoriel fait passer un SaaS Next.js de zéro à un vrai paiement sandbox.

Étape 0 : Lire la doc d'abord
La documentation Creem est assez courte pour être parcourue d'une seule assise. Les deux pages qui comptent ici sont produits/prix et webhooks. Gardez le guide des webhooks Creem ouvert — vous y reviendrez à l'étape 3.
Étape 1 : Créer le compte et la clé API
Inscrivez-vous sur Creem, passez en mode test et créez une clé API. Stockez-la dans CREEM_API_KEY. Définissez CREEM_ENV=test pour le développement et ne la changez en live qu'après un aller-retour sandbox au vert. Les clés de test et les clés réelles sont distinctes ; les mélanger est le moyen le plus rapide d'obtenir un 401 déroutant.
PAYMENT_PROVIDER=creem
CREEM_API_KEY=creem_test_xxx
CREEM_ENV=test
CREEM_WEBHOOK_SECRET=whsec_test_xxx
CREEM_PRICE_ID_BUYOUT=price_buyout_test
CREEM_PRICE_ID_CARE=price_care_test
Étape 2 : Créer les produits et les prix
Dans le tableau de bord Creem, créez un produit unique pour Buyout et un produit récurrent pour Care. Copiez leurs ids de prix dans CREEM_PRICE_ID_BUYOUT et CREEM_PRICE_ID_CARE — les noms des emplacements correspondent aux offres. Si vous migrez une ancienne configuration, les anciens noms CREEM_PRICE_ID_PRO et CREEM_PRICE_ID_SCALE servent encore de repli. Pour une promo Black Friday, créez des ids de prix séparés et définissez CREEM_PRICE_ID_BUYOUT_BF et CREEM_PRICE_ID_CARE_BF ; l'inférence du plan par le webhook les reconnaît déjà.

Étape 3 : Définir le webhook
Pointez Creem vers votre point d'accès /api/payments/webhook/creem et copiez le secret du webhook dans CREEM_WEBHOOK_SECRET. L'intégration vérifie la signature à chaque événement avant de lui faire confiance. Un événement de checkout résout le plan depuis l'id de produit ou de prix et accorde la licence ; un événement de remboursement ou d'annulation la révoque.
export async function POST(req: Request) {
const body = await req.text();
if (!verifyCreemSignature(body, req.headers)) {
return new Response("bad signature", { status: 400 });
}
const evt = JSON.parse(body);
if (evt.type === "checkout.completed") {
await grantLicence(evt.customer, inferPlan(evt.product.id), evt.id);
}
if (evt.type === "subscription.canceled") {
await revokeLicence(evt.customer);
}
return new Response("ok");
}
Le gestionnaire s'exécute comme un route handler Next.js App Router, donc la vérification reste côté serveur. Rendez l'octroi idempotent : Creem retente les événements, et un checkout retenté ne doit pas créer une seconde licence. Journalisez l'id et le type de l'événement — lorsqu'un remboursement semble ne pas révoquer l'accès, ce journal vous dit quel événement est réellement arrivé.
Étape 4 : Définir le fournisseur
Définissez PAYMENT_PROVIDER=creem ainsi que CREEM_API_KEY et CREEM_WEBHOOK_SECRET. Un appel de checkout choisit le bon id de prix pour l'offre active — ou l'id BF quand la promo est active — et redirige vers le checkout hébergé de Creem. Vous ne touchez jamais aux données de carte, ce qui garde votre application hors du périmètre PCI.
Étape 5 : Lancer un test sandbox
Utilisez le mode test et un achat test. Confirmez que le webhook se déclenche, que le plan est correctement déduit, que la clé de licence est émise, puis émettez un remboursement test et regardez la licence être révoquée. Cette dernière étape est celle qu'on oublie, et c'est celle qui protège votre revenu. Passez en production avec CREEM_ENV=live et des clés réelles uniquement après un aller-retour complet au vert.

Dépannage de trois échecs courants
Si le webhook renvoie 400, vérifiez la fenêtre de timestamp et le secret — un événement rejoué ou décalé est rejeté par conception. Si le plan reste toujours celui par défaut, l'id de prix dans Creem ne correspond pas à celui de votre environnement. Si un remboursement laisse l'accès actif, vérifiez que vous traitez les types d'événements d'annulation ET de remboursement, pas seulement le checkout.
Changer de fournisseur plus tard
Creem, Waffo, Stripe, PayPal et Lemon Squeezy sont tous derrière le même contrat de checkout et de webhook sur Uncorne : changer de fournisseur est une modification de configuration, pas une réécriture. Voir le tutoriel de configuration Waffo pour les étapes parallèles et le guide des passerelles de facturation pour le choix plus large.
Ce que fait réellement l'appel de checkout
Cliquer sur Buyout ou Care déclenche une server action qui résout l'id de prix de l'offre et crée une session de checkout Creem. L'id de prix est choisi côté serveur : un client ne peut donc pas modifier un paramètre d'URL pour acheter Care au prix de Buyout. La session porte votre référence utilisateur interne dans les metadata ; quand le webhook arrive, cette référence permet de créditer le bon compte. Redirigez le navigateur vers l'URL renvoyée par Creem — n'essayez pas de rendre leur checkout dans votre propre mise en page.
Événements, idempotence et contrat de nouvelle tentative
Creem retente les livraisons de webhook jusqu'à ce que votre point d'accès réponde avec un 2xx. Rendez le gestionnaire rapide et idempotent : accusez réception d'abord, puis faites le travail dans une tâche de fond si votre service de licence est lent. Stockez l'id de l'événement dans une colonne unique afin qu'un checkout.completed retenté ne crée pas une seconde licence. Journalisez l'id de l'événement, son type et l'id du produit — lorsqu'on signale qu'un remboursement n'a pas retiré l'accès, ce journal révèle quel événement est réellement arrivé.
Care récurrent : trois événements à gérer
Care est un abonnement : un premier checkout réussi n'est que le début. Gérez subscription.active pour maintenir l'accès, subscription.canceled pour le révoquer à la fin de la période payée, et le chemin de remboursement pour révoquer immédiatement. Décidez délibérément si une annulation prend effet maintenant ou en fin de période — couper l'accès en cours de période est un ticket de support que vous n'avez pas besoin. Conservez la date de renouvellement renvoyée par Creem pour l'afficher dans votre propre interface.
Une matrice sandbox, pas un seul chemin heureux
Exécutez ces cas en mode test avant de toucher à la production :
- Buyout avec l'id de prix standard — licence unique émise.
- Care avec l'id de prix standard — abonnement actif, date de renouvellement stockée.
- Id de prix BF avec la promo active — bon plan BF déduit.
- Le même événement
checkout.completedlivré deux fois — une licence, pas deux. - Un remboursement test sur Care — accès révoqué, aucun abonnement orphelin.
Les lignes 4 et 5 sont là où la plupart des intégrations cassent. Un seul achat réussi prouve bien peu.
Liste de contrôle avant production
Passez à CREEM_ENV=live, remplacez la clé API et le secret de webhook de test par leurs versions réelles, et vérifiez que l'URL du webhook utilise HTTPS sur votre domaine de production. Retirez les ids de prix PRO et SCALE hérités de l'environnement, sauf si vous avez toujours besoin du repli. Faites ensuite un petit achat réel, remboursez-le, et suivez toute la chaîne — checkout, signature, plan, licence, révocation — avant toute annonce.
Pour aller plus loin
Comme les cinq adaptateurs partagent un seul contrat, ces habitudes opérationnelles se transposent si vous changez de fournisseur. Le tutoriel Waffo parcourt la configuration parallèle, et la comparaison des passerelles explique quand les frais de Merchant of Record de Creem rentabilisent.
FAQ
Creem est-il un Merchant of Record ?+
Oui — Creem gère la taxe de vente / la TVA et la conformité pour vous, ce qui explique des frais plus élevés qu'un processeur brut. Vérifiez le tarif actuel sur la page de tarification de Creem avant de vous engager.
Dois-je vérifier la signature du webhook Creem ?+
Oui. L'intégration la vérifie avec CREEM_WEBHOOK_SECRET à chaque événement, côté serveur. L'ignorer permettrait à quiconque de forger un événement de checkout avec une requête non signée.
Que se passe-t-il lors d'un remboursement ?+
Le webhook voit l'événement d'annulation ou de remboursement et révoque la licence afin qu'un client remboursé ne conserve pas l'accès. Testez ce chemin en sandbox avant de passer en production.
Puis-je conserver les anciens noms d'ids de prix PRO et SCALE ?+
Oui. CREEM_PRICE_ID_PRO et CREEM_PRICE_ID_SCALE servent encore de repli lors de la migration d'une ancienne configuration, mais les nouveaux projets doivent utiliser les noms BUYOUT et CARE correspondant aux offres.
Toutes les questions fréquentes · Version Markdown (pour les agents IA)