Creem-Zahlung einrichten: Next.js-Checkout Schritt für Schritt
Creem ist das nächste, was es zu einem Stripe-ähnlichen gehosteten Checkout mit Merchant of Record gibt. Es übernimmt für Sie Umsatzsteuer und MwSt., weshalb die Gebühr höher ist als bei einem reinen Processor — der Trade-off wird im Merchant-of-Record-Überblick erklärt. Dieses Tutorial führt ein Next.js-SaaS von null zu einer echten Sandbox-Zahlung.

Schritt 0: Zuerst die Doku lesen
Die Creem-Dokumentation ist kurz genug, um sie in einem Rutsch zu überfliegen. Die zwei Seiten, die hier zählen, sind Produkte/Preise und Webhooks. Halten Sie den Creem-Webhook-Leitfaden offen — in Schritt 3 kommen Sie darauf zurück.
Schritt 1: Konto und API-Schlüssel erstellen
Registrieren Sie sich bei Creem, wechseln Sie in den Testmodus und erstellen Sie einen API-Schlüssel. Speichern Sie ihn als CREEM_API_KEY. Setzen Sie CREEM_ENV=test für die Entwicklung und ändern Sie es erst nach einem grünen Sandbox-Durchlauf auf live. Test- und Live-Schlüssel sind getrennt; sie zu verwechseln ist der schnellste Weg zu einem verwirrenden 401.
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
Schritt 2: Produkte und Preise anlegen
Erstellen Sie im Creem-Dashboard ein einmaliges Produkt für Buyout und ein wiederkehrendes für Care. Kopieren Sie deren Price-IDs in CREEM_PRICE_ID_BUYOUT und CREEM_PRICE_ID_CARE — die Slot-Namen entsprechen den Plänen. Bei der Migration einer älteren Konfiguration werden die alten Namen CREEM_PRICE_ID_PRO und CREEM_PRICE_ID_SCALE weiterhin als Fallback aufgelöst. Für eine Black-Friday-Aktion erstellen Sie separate Price-IDs und setzen CREEM_PRICE_ID_BUYOUT_BF und CREEM_PRICE_ID_CARE_BF; die Webhook-Planerkennung erkennt sie bereits.

Schritt 3: Den Webhook festlegen
Richten Sie Creem auf Ihren Endpunkt /api/payments/webhook/creem und kopieren Sie das Webhook-Secret in CREEM_WEBHOOK_SECRET. Die Integration prüft die Signatur bei jedem Ereignis, bevor sie ihm vertraut. Ein Checkout-Ereignis löst den Plan aus der Produkt- oder Price-ID auf und gewährt die Lizenz; ein Rückerstattungs- oder Stornierungsereignis entzieht sie.
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");
}
Der Handler läuft als Next.js-App-Router-Route-Handler, die Prüfung bleibt also auf dem Server. Machen Sie die Erteilung idempotent: Creem wiederholt Ereignisse, und ein wiederholter Checkout darf keine zweite Lizenz erzeugen. Protokollieren Sie Ereignis-ID und -Typ — wenn eine Rückerstattung den Zugriff scheinbar nicht entzieht, verrät Ihnen dieses Protokoll, welches Ereignis tatsächlich ankam.
Schritt 4: Den Anbieter festlegen
Setzen Sie PAYMENT_PROVIDER=creem plus CREEM_API_KEY und CREEM_WEBHOOK_SECRET. Ein Checkout-Aufruf wählt die passende Price-ID für den aktiven Plan — oder die BF-Price-ID bei laufender Aktion — und leitet zum gehosteten Creem-Checkout weiter. Sie berühren niemals Kartendaten, wodurch der PCI-Anwendungsbereich außerhalb Ihrer App bleibt.
Schritt 5: Einen Sandbox-Test durchführen
Nutzen Sie den Testmodus und einen Testkauf. Bestätigen Sie, dass der Webhook auslöst, der Plan korrekt abgeleitet und der Lizenzschlüssel ausgestellt wird, lösen Sie dann eine Testrückerstattung aus und sehen Sie zu, wie die Lizenz entzogen wird. Dieser letzte Schritt wird vergessen — und er ist es, der Ihren Umsatz schützt. Gehen Sie erst mit CREEM_ENV=live und Live-Schlüsseln live, wenn der vollständige Durchlauf grün ist.

Fehlerbehebung bei drei häufigen Problemen
Gibt der Webhook 400 zurück, prüfen Sie das Timestamp-Fenster und das Secret — ein wiederholtes oder zeitlich verschobenes Ereignis wird absichtlich abgelehnt. Bleibt der Plan immer der Standard, stimmt die Price-ID in Creem nicht mit der in Ihrer Umgebung überein. Bleibt der Zugriff nach einer Rückerstattung aktiv, stellen Sie sicher, dass Sie sowohl Stornierungs- als auch Rückerstattungsereignisse behandeln, nicht nur Checkout.
Später den Anbieter wechseln
Creem, Waffo, Stripe, PayPal und Lemon Squeezy liegen bei Uncorne alle hinter demselben Checkout- und Webhook-Vertrag. Ein Anbieterwechsel ist eine Konfigurationsänderung, keine Neuentwicklung. Die analogen Schritte finden Sie im Waffo-Zahlungs-Setup-Tutorial, die größere Entscheidung im Leitfaden zu Abrechnungs-Gateways.
Was der Checkout-Aufruf tatsächlich tut
Ein Klick auf Buyout oder Care löst eine Server Action aus, die die Price-ID des Plans auflöst und eine Creem-Checkout-Session erstellt. Die Price-ID wird auf dem Server gewählt, ein Kunde kann also keinen URL-Parameter ändern, um Care zum Buyout-Preis zu kaufen. Die Session trägt Ihre interne Benutzerreferenz in den Metadaten; wenn der Webhook eintrifft, ermöglicht genau diese Referenz die Gutschrift auf das richtige Konto. Leiten Sie den Browser auf die von Creem zurückgegebene URL um — versuchen Sie nicht, deren Checkout in Ihr eigenes Layout zu rendern.
Ereignisse, Idempotenz und der Wiederholungsvertrag
Creem wiederholt Webhook-Zustellungen, bis Ihr Endpunkt mit einem 2xx antwortet. Machen Sie den Handler schnell und idempotent: bestätigen Sie zuerst, und erledigen Sie die Arbeit in einem Hintergrundjob, wenn Ihr Lizenzdienst langsam ist. Speichern Sie die Ereignis-ID in einer eindeutigen Spalte, damit ein wiederholtes checkout.completed keine zweite Lizenz erzeugt. Protokollieren Sie Ereignis-ID, Ereignistyp und Produkt-ID — wenn jemand meldet, dass eine Rückerstattung den Zugriff nicht entfernt hat, verrät dieses Protokoll, welches Ereignis tatsächlich ankam.
Wiederkehrendes Care: drei Ereignisse, die Sie behandeln müssen
Care ist ein Abonnement, ein erfolgreicher erster Checkout ist also erst der Anfang. Behandeln Sie subscription.active, um den Zugriff aufrechtzuerhalten, subscription.canceled, um ihn am Ende der bezahlten Periode zu entziehen, und den Rückerstattungspfad für den sofortigen Entzug. Entscheiden Sie bewusst, ob eine Stornierung jetzt oder am Periodenende wirkt — Zugriff mitten in der Periode zu kappen ist ein Support-Ticket, das Sie nicht brauchen. Speichern Sie das von Creem zurückgegebene Verlängerungsdatum, damit Ihre eigene Oberfläche es anzeigen kann.
Eine Sandbox-Matrix, kein einzelner Erfolgsfall
Führen Sie diese Fälle im Testmodus aus, bevor Sie die Produktion anfassen:
- Buyout mit Standard-Price-ID — einmalige Lizenz ausgestellt.
- Care mit Standard-Price-ID — Abonnement aktiv, Verlängerungsdatum gespeichert.
- BF-Price-ID bei aktivierter Aktion — korrekter BF-Plan abgeleitet.
- Dasselbe
checkout.completed-Ereignis zweimal zugestellt — eine Lizenz, keine zwei. - Eine Testrückerstattung bei Care — Zugriff entzogen, kein verwaistes Abonnement.
Die Zeilen 4 und 5 sind die Stellen, an denen die meisten Integrationen brechen. Ein einzelner erfolgreicher Kauf beweist sehr wenig.
Go-Live-Checkliste
Wechseln Sie zu CREEM_ENV=live, ersetzen Sie den Test-API-Schlüssel und das Webhook-Secret durch die Live-Versionen, und prüfen Sie, dass die Webhook-URL HTTPS auf Ihrer Produktionsdomain verwendet. Entfernen Sie die veralteten PRO- und SCALE-Price-IDs aus der Umgebung, sofern Sie den Fallback nicht mehr brauchen. Machen Sie dann einen kleinen echten Kauf, erstatten Sie ihn und verfolgen Sie die ganze Kette — Checkout, Signatur, Plan, Lizenz, Entzug — bevor Sie irgendetwas ankündigen.
Weiterlesen
Da alle fünf Adapter einen Vertrag teilen, übertragen sich diese betrieblichen Gewohnheiten bei einem Anbieterwechsel. Das Waffo-Tutorial behandelt die analogen Schritte, der Gateway-Vergleich erklärt, wann Creems Merchant-of-Record-Gebühr sich auszahlt.
FAQ
Ist Creem ein Merchant of Record?+
Ja — Creem übernimmt Umsatzsteuer/MwSt. und Compliance für Sie, daher die höheren Gebühren als bei einem reinen Processor. Prüfen Sie den aktuellen Satz auf Creems Preisseite, bevor Sie sich festlegen.
Muss ich die Creem-Webhook-Signatur prüfen?+
Ja. Die Integration prüft sie mit CREEM_WEBHOOK_SECRET bei jedem Ereignis auf dem Server. Das Auslassen würde jedem erlauben, mit einer unsignierten Anfrage ein Checkout-Ereignis zu fälschen.
Was passiert bei einer Rückerstattung?+
Der Webhook sieht das Stornierungs- oder Rückerstattungsereignis und entzieht die Lizenz, damit ein erstatteter Kunde keinen Zugriff behält. Testen Sie diesen Pfad vor dem Go-Live in der Sandbox.
Kann ich die alten PRO- und SCALE-Price-ID-Namen behalten?+
Ja. CREEM_PRICE_ID_PRO und CREEM_PRICE_ID_SCALE werden bei der Migration einer älteren Konfiguration weiterhin als Fallback aufgelöst, aber neue Projekte sollten die planbezogenen Namen BUYOUT und CARE verwenden.