
Mini-Lektion · Deutsch
So nimmst du eine Zahlung auf deiner Website an
Erstelle einen Test-Payment-Link, verbinde ihn mit der bereitgestellten Seite und prüfe die Zahlung in deinem Anbieterkonto, ohne ein Zahlungsbackend zu entwickeln.
Für wen ist das gedacht?
Für alle, die eine Zahlungsschaltfläche auf einer Website möchten. Der grundlegende Weg nutzt eine gehostete Zahlungsseite und einen Programmierassistenten für den Link; Servercode, Datenbankeinrichtung und Webhookprogrammierung sind optionale Vertiefungen.
Bevor du beginnst
Dein eigenes berechtigtes Stripe-Konto mit Sandbox- beziehungsweise Testumgebung und die bereitgestellte Seite. Ein Programmierassistent kann den öffentlichen Testlink konfigurieren. Der grundlegende Weg braucht weder Supabase noch einen geheimen API-Schlüssel im Browser oder einen eigenen Server.
Geschätzte Dauer: 35–53 Min.
Schätzungen für die mitgelieferten Startdateien bei bereits eingerichteten Konten und Werkzeugen. Einrichtung, Deployment-Warteschlangen sowie E-Mail- und DNS-Wartezeiten kommen hinzu. Kontoberechtigung, Aktivierung und echter Geschäftsstart liegen außerhalb dieser Testübung. Es werden weder echtes Geld noch echte Kartendaten verwendet.
Was du lernen wirst
- Erstelle einen klar erkennbaren Sandbox-Checkoutlink.
- Verbinde und teste die Zahlungsschaltfläche der Website.
- Prüfe tatsächlich bezahlte und abgebrochene Zustände beim Anbieter, statt einer Rückkehrseite zu vertrauen.
Schritt 1
Wähle ein Sandbox-Zahlungsziel
Beginne mit einem gehosteten Checkout, statt selbst Kartendaten zu erfassen.
Nutze deine eigene Stripe-Testumgebung und ein fiktives Produkt mit Preis. Öffne die bereitgestellte Seite mit deinem Assistenten und entscheide, was die Zahlungsschaltfläche beschreiben soll.
Halte diese Übung im Testmodus. Dass ein Besucher eine Erfolgsadresse öffnet, belegt keine erfolgte Zahlung.
Ein konkretes Beispiel
Zur Veranschaulichung könnte das Produkt „Sample digital workshop“ mit einem einmaligen Testpreis von USD 5 heißen. Die Schaltfläche sollte sagen, dass sie einen Testcheckout öffnet. Weder Seite noch Lektion versprechen automatische Lieferung dieses Produkts.
Nutze die bereitgestellte öffentliche Seite für eine grundlegende Übung mit gehostetem Payment Link. Hilf mir, ein Testprodukt mit Preis in meiner eigenen Stripe-Sandbox anzulegen und nur dessen öffentliche Test-Checkout-URL in die Seitenkonfiguration einzutragen. Richte den optionalen Datenbank- und Webhookweg nicht ein und nutze keine Live-Zugangsdaten. Hilf mir, nur die vorgesehene Übungsseite zu veröffentlichen und eine Testzahlung im Anbieterdashboard zu prüfen. Die Rückkehrseite ist kein Zahlungsnachweis.Stripe: einen Payment Link erstellen · Stripe: Testen
Dateien für diesen Schritt
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Inspect individual files (optional)
How it works (optional)
Nimm eine Testzahlung mit einer gehosteten Kasse an
Beginne mit einer vom Anbieter gehosteten Testseite und einer klar definierten Erfolgsgrenze.
Ein gehosteter Payment Link lässt den Anbieter Zahlungsdaten erfassen, ohne Karteneingaben auf deiner eigenen Seite anzulegen. Diese Übung nutzt ausschließlich Stripes Sandbox-/Testumgebung und Testkartenwerte.
Die Website öffnet die Kasse; der Server empfängt signierte Zahlungsereignisse und speichert einen Beleg. Die Rückkehrseite dient nur der Navigation: Jeder kann eine URL öffnen, daher beweist ihre Anzeige keine Zahlung.
Ausgearbeitetes Beispiel
Direktes Öffnen von success.html darf keinen Beleg erzeugen. Eine verifizierte bezahlte Sitzung des konfigurierten Test-Payment-Links kann einen erzeugen, selbst wenn der Kunde nie zu deiner Website zurückkehrt.
Stripe: nach einer Payment-Link-Zahlung · Stripe: Testen
Extra implementation exercise
Ein Nutzer besucht /success.html?paid=true. Sollte dein System ein bezahltes Produkt freigeben?
Ausgearbeitete Lösung anzeigen
Nein. Ein Suchparameter steht unter Besucherkontrolle. Nutze ein verifiziertes Anbieterereignis oder eine serverseitige Anbieterprüfung mit Bezug zur vorgesehenen Transaktion.
- Lehnt vom Aufrufer kontrollierte URLs als Zahlungsbeleg ab.
- Verlangt verifizierten Zahlungszustand des Anbieters.
Häufiger Fehler
Einen Kauf freischalten, weil eine Erfolgsseite geöffnet wurde.
Schritt 2
Erstelle und verbinde den Testlink
Nutze das Anbieterdashboard und lass den Assistenten die Seite bearbeiten.
Erstelle in deinem eigenen Konto das Testprodukt mit Einmalpreis und den Payment Link. Öffne den öffentlichen Checkout ohne Anmeldung und gib diese Test-URL anschließend deinem Assistenten zum Einbinden in die bereitgestellte öffentliche Seite.
Prüfe vor dem Fortfahren Artikel, Betrag, Währung und Testumgebung. Nur die öffentliche Test-Checkout-URL gehört in diese Seite; für den einfachen Link ist kein privater Signier- oder API-Schlüssel nötig.
Ein konkretes Beispiel
Eine erfolgreiche Einrichtung öffnet den öffentlichen Testcheckout des Produkts ohne Anmeldung. Eine Stripe-Kontoeinstellungsseite oder der unveränderte Platzhalter test_REPLACE ist kein nutzbarer Checkoutlink.
Stripe: einen Payment Link erstellen
Selbst ausprobieren
Öffnet die Websiteschaltfläche den vorgesehenen Sandbox-Checkout mit richtigem Artikel und Preis?
Besprich deine Antwort mit dem Tutor
Ausgearbeitete Lösung anzeigen
Beispielprüfung: Der Websitelink öffnet ohne meinen Stripe-Kontologin den öffentlichen Testcheckout für „Sample digital workshop“, USD 5. Auf der Seite ist nur dieser öffentliche Testlink eingerichtet; für diesen einfachen Weg wird weder API-Schlüssel noch Webhookgeheimnis benötigt.
- Gleicht den gehosteten Checkout ohne Anmeldung mit vorgesehenem Produkt, Betrag, Währung und Testmodus ab.
- Verwendet in der mitgelieferten Seitenkonfiguration nur den öffentlichen Test-Payment-Link.
Dateien für diesen Schritt
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Inspect individual files (optional)
How it works (optional)
Konfiguriere die separate Testkasse
Trenne öffentliche Kassen-URLs von Serverzugangsdaten und Webhook-Geheimnissen.
Folge START-HERE.txt, um einen einmaligen Test-Payment-Link, die Datenbanktabelle und ein Webhook-Ziel einzurichten. Installiere die festgelegte Stripe-Abhängigkeit in diesem Übungsprojekt und bewahre die erzeugte Lockdatei auf.
Trage in config.js nur die öffentliche Testkassen-URL ein. Serverumgebungswerte umfassen geheimen Testschlüssel, Endpunkt-Signaturgeheimnis, erwartete Payment-Link-ID und privaten Datenbankschlüssel. Dieser Code weist Live-Zugangsdaten bewusst ab.
Öffne für die vollständige lokale Reihenfolge run-locally.txt: Bereite die private Umgebung im Stamm vor, verknüpfe ausschließlich das Übungsprojekt und starte den Netlify-Funktionsproxy. server-env.example.txt führt Variablennamen ohne echte Geheimnisse auf. Nur das HTML zu öffnen kann den Server nicht ausführen.
Ausgearbeitetes Beispiel
Das Webhook-Signaturgeheimnis belegt, die Ereignisse welchen Endpunkts du akzeptierst. Es ist weder der öffentliche Payment Link noch der API-Schlüssel; das falsche Geheimnis verursacht einen Signaturfehler.
Node.js: Status unterstützter Veröffentlichungen
Extra implementation exercise
Was gehört in public/config.js: die Testkassen-URL oder das whsec-Signaturgeheimnis?
Ausgearbeitete Lösung anzeigen
Nur die öffentliche Kassen-URL gehört dorthin. Halte Webhook-Geheimnis und geheime Anbieter-/Datenbankschlüssel in Serverumgebungsvariablen.
- Hält Signatur-/API-Geheimnisse serverseitig.
- Nutzt im Browsercode nur das öffentliche Kassenziel.
Häufiger Fehler
Das Geheimnis des lokalen Weiterleitungsendpunkts mit dem des gehosteten Endpunkts verwechseln.
Schritt 3
Schließe eine Testzahlung beim Anbieter ab
Nutze die offiziellen Testanweisungen und prüfe das Kontoergebnis.
Folge der verlinkten Stripe-Testanleitung ausschließlich innerhalb der Sandbox. Schließe einen entbehrlichen Testcheckout ab und finde anschließend seine tatsächliche Zahlung beziehungsweise Sitzung in deinem Konto.
Prüfe dort erwarteten Betrag, Währung und Bezahlstatus. Ein abgeschlossener Seitenablauf kann noch vom endgültigen Zahlungsstatus abweichen, besonders bei später abgerechneten Zahlungsmethoden.
Ein konkretes Beispiel
„Checkout abgeschlossen“ und „Zahlung als bezahlt bestätigt“ sind nicht immer dieselbe Beobachtung.
Selbst ausprobieren
Was meldete der Anbieterdatensatz tatsächlich für deine Testzahlung?
Besprich deine Antwort mit dem Tutor
Ausgearbeitete Lösung anzeigen
Beispielanbieterergebnis: Die passende Testzahlung ist für USD 5 als bezahlt markiert und stimmt mit dem gewählten Testpreis überein. Meldet der Anbieter stattdessen in Bearbeitung oder unbezahlt, halte ich das fest und erkläre die Bestellung nicht bloß wegen eines abgeschlossenen Seitenablaufs für bezahlt.
- Findet die passende Testzahlung und ihren tatsächlichen bezahlt-Status im Anbieterkonto.
- Vergleicht festgehaltenen Betrag und Währung mit dem gewählten Testpreis.
Dateien für diesen Schritt
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Inspect individual files (optional)
How it works (optional)
Prüfe das Ereignis und speichere den Bezahlzustand einmal
Authentifiziere die rohen Nutzdaten vor ihrer JSON-Auswertung.
Der Handler übergibt die unveränderten rohen Anfragebytes und Stripe-Signature ans offizielle SDK. JSON vor der Signaturprüfung zu parsen oder neu zu formatieren kann die Bytes verändern und die Prüfung brechen.
Er akzeptiert nur erwartete Ereignistypen, Testmodus, passendes payment_link und payment_status=paid. Verzögerte Methoden können den Checkout vor erfolgreicher Zahlung abschließen; Kassenabschluss allein reicht daher nicht. Eine eindeutige session_id macht wiederholtes Einfügen des Belegs unschädlich.
Zwei verschiedene Ereignis-IDs können dieselbe Kassensitzung beschreiben, etwa Kassenabschluss und anschließenden asynchronen Zahlungserfolg. Der session_id-Primärschlüssel mit on_conflict=session_id und resolution=ignore-duplicates macht das dauerhafte Einfügen wiederholbar. Fehlgeschlagenes Datenbankschreiben wird nicht verschluckt: Es liefert 503 für einen erneuten Zustellversuch.
Ausgearbeitetes Beispiel
Dieselbe zweimal zugestellte bezahlte Sitzung hat weiterhin nur einen Primärschlüsselwert. Datenbankfehler liefern 503 für erneute Zustellung, statt ein Ereignis mit verlorenem Ergebnis zu bestätigen.
Stripe: Webhook-Signaturprüfung und erneute Zustellung
Extra implementation exercise
Warum ist checkout.session.completed mit payment_status=unpaid noch keine bezahlte Bestellung?
Ausgearbeitete Lösung anzeigen
Einige Zahlungsmethoden bestätigen später. Warte vor dem Speichern eines bezahlten Belegs auf einen verifizierten Bezahlzustand, gegebenenfalls einschließlich asynchronem Erfolgsereignis.
- Trennt Kassenabschluss von abgeschlossenem Zahlungszustand.
- Wartet auf die passende Bezahlbestätigung.
Häufiger Fehler
Jeden abgeschlossenen Checkout unabhängig von payment_status als bezahlt markieren.
Schritt 4
Probiere Abbruch und direkten Aufruf der Rückkehrseite aus
Prüfe, dass Besucher durch Navigation kein bezahltes Ergebnis erzeugen können.
Beginne einen separaten Testcheckout und verlasse ihn ohne abgeschlossene Zahlung oder nutze einen tatsächlich angebotenen Stornoweg. Öffne die mitgelieferte Seite success.html separat direkt. Vergleiche beides mit den Testzahlungsdatensätzen des Anbieters.
Ein verlassener Checkout kann unvollständig oder offen bleiben, statt wörtlich „canceled“ zu heißen. Keine der beiden Aktionen darf als neuer bezahlter Kauf gemeldet werden. Die einfache Seite liefert kein Produkt automatisch aus.
Ein konkretes Beispiel
Das Öffnen von success.html oder Hinzufügen von paid=true zur URL erzeugt keine passende bezahlte Zahlung in Stripe. Zur Website zurückzukehren und Zahlung nachzuweisen sind getrennte Vorgänge.
Selbst ausprobieren
Was belegten Abbruch und direkter Besuch der Rückkehrseite, und was belegten sie nicht?
Besprich deine Antwort mit dem Tutor
Ausgearbeitete Lösung anzeigen
In dieser Beispielprüfung blieb der zweite Checkout unvollständig und hatte keine neue bezahlte Zahlung. Direktes Öffnen von success.html zeigte nur die Rückkehrmeldung. Keine der Aktionen belegt einen Kauf, und die einfache Seite gewährt keinen automatischen Produktzugang.
- Unterscheidet stornierten oder unvollständigen Checkout von einer passenden bezahlten Zahlung.
- Erkennt, dass direkter Zugriff auf die Rückkehrseite weder Zahlung belegt noch Lieferung gewährt.
Dateien für diesen Schritt
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
Inspect individual files (optional)
How it works (optional)
Verfolge eine Testzahlung durch den gesamten Ablauf
Ordne Kassensitzung, signiertes Ereignis und gespeicherten Beleg einander zu.
Nutze in deiner Sandboxkasse ausschließlich offizielle Testkartenwerte. Finde die resultierende Sitzung und Webhook-Zustellung in deinem Konto und prüfe dann die private Tabelle payment_receipts im Übungsprojekt.
Gleiche Betrag und Währung mit dieser Sitzung ab. Sende dasselbe echte Ereignis erneut und bestätige, dass weiterhin nur eine Zeile besteht. Teste eine unsignierte Anfrage und den direkten Erfolgsseitenbesuch; keines darf einen Zahlungsdatensatz erzeugen.
Ausgearbeitetes Beispiel
Eine 200-Webhook-Antwort beweist, dass der Handler etwas bestätigt hat. Prüfe passenden Beleg und Sitzung, statt anzunehmen, alle Ereignisse beträfen das vorgesehene Produkt.
Extra implementation exercise
Der Webhook liefert 200 für ein unabhängiges Ereignis. Bedeutet das, dass ein Beleg existieren sollte?
Ausgearbeitete Lösung anzeigen
Nein. Der Handler bestätigt ignorierte Ereignisse ohne Beleg. Nur eine passende bezahlte Testsitzung sollte den vorgesehenen Datensatz erzeugen.
- Versteht absichtlich ignorierte Ereignisse.
- Ordnet gespeicherten Zustand der konkreten bezahlten Sitzung zu.
Häufiger Fehler
Erwarten, jeder bestätigte Webhook entspreche einer neuen Bestellung.
Schritt 5
Übergib den grundlegenden Zahlungsweg
Stelle einen nützlichen Link fertig, ohne ein vollständiges Handelssystem zu behaupten.
Wiederhole nach jeder Korrektur die Website-Schaltflächen- und Sandbox-Zahlungsprüfungen. Speichere Übungsseite und Link sowie eine um vertrauliche Angaben bereinigte Aufzeichnung erfolgreicher und abgebrochener oder unvollständiger Versuche.
Bestätige vor echten Verkäufen dein berechtigtes Unternehmen und Konto, Preis, Währung, Bedingungen und Betriebsablauf. Automatischer Zugriff, signierte Ereignisse und Datenbankwiederherstellung gehören zum optionalen Vertiefungsmaterial unten.
Ein konkretes Beispiel
Eine funktionierende gehostete Checkoutschaltfläche ist ein gültiges kleines Ergebnis; sie belegt kein noch nicht erstelltes Bereitstellungsbackend.
Selbst ausprobieren
Material zum Einstieg
Dateien und Testinhalte sind vorhanden. Eine echte Dienstprüfung benötigt dein eigenes Konto, Postfach oder deine Domain gemäß den Voraussetzungen. Lokales Prüfen bleibt möglich; kennzeichne nicht ausgeführte Live-Schritte als ungetestet.
Lege den Testweg und tatsächliche Sandboxergebnisse sowie alles vor, was vor einem echten Start noch benötigt wird.
Dein Ergebnis Dein Testcheckoutlink mit Seite und tatsächliche Sandboxbeobachtungen zu Zahlung und Abbruch; keine echte Belastung.
Besprich deine Antwort mit dem Tutor
Ausgearbeitete Lösung anzeigen
Beispielübergabe: Die Seite öffnet den Workshop-Testcheckout für USD 5; eine passende Testzahlung ist für USD 5 bezahlt; der verlassene Versuch ist unbezahlt; direktes Öffnen der Rückkehrseite ändert keinen Datensatz. Weder echte Abbuchung noch automatische Produktlieferung wurden getestet. Vor echtem Start fehlen noch ein berechtigtes Konto, echte Bedingungen und ein verifizierter Lieferprozess.
- Liefert den eingerichteten öffentlichen Testweg mit bezahlten und unvollständigen beziehungsweise stornierten Ergebnissen.
- Stellt klar, dass echte Abbuchung und automatische Auslieferung nicht zum abgeschlossenen Basistest gehören.
Dateien für diesen Schritt
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Deine Aufgabe: übe Wiederherstellung ohne echte Abbuchungen
Ein Zahlungsablauf muss einen fehlgeschlagenen Datenbankschreibvorgang aufholen können.
Nutze im entbehrlichen Projekt vorübergehend eine ungültige Datenbankeinstellung und sende dein echtes bezahltes Testereignis erneut. Beobachte eine Nicht-Erfolgsantwort und keinen neuen Beleg. Stelle die Konfiguration wieder her, sende erneut und prüfe genau eine passende Zeile.
Erkläre, was vor echtem Verkauf fehlt: unterstützte Konto-/Geschäftseinrichtung, korrekter Preis und Währung sowie Bedingungen, dauerhafte Leistungserbringung, Abgleich, Erstattungen und Betriebsüberwachung. Dieser Workshop speichert nur Testbelege.
Ausgearbeitetes Beispiel
Scheitert die Speicherung, während der Endpunkt „Erfolg“ sagt, können automatische Wiederholungen enden, bevor dein Datensatz existiert. Ehrliches Scheitern gehört zu verlässlicher Zahlungsabwicklung.
Die vollständige exemplarische Anleitung findest du in reference/assignment-walkthrough.txt. Vergleiche ihre Schritte mit deinem Ergebnis und fülle das Testprotokoll mit Beobachtungen aus deinem eigenen Projekt aus.
Extra implementation exercise
Zeige einen fehlgeschlagenen Speicherversuch und erfolgreiche duplikatsichere Wiederherstellung.
Ausgearbeitete Lösung anzeigen
Installiere Abhängigkeiten im separaten Übungsprojekt mit npm install; das erzeugt package-lock.json, die du im Projekt aufbewahrst. Nutze nur einen Test-Payment-Link und sk_test_-Zugangsdaten. Der öffentliche Link ist nicht das Webhook-Signaturgeheimnis.
Finde deine passende bezahlte Testsitzung, ihre signierte Webhook-Zustellung und den privaten Beleg mit gleicher session_id, gleichem Betrag und gleicher Währung. Stelle das Ereignis erneut zu: Primärschlüssel und ignore-duplicates-Vorgabe müssen einen Beleg belassen. Eine unsignierte Anfrage oder ein direkter Erfolgsseitenbesuch darf keinen erzeugen.
Ändere für die Fehlerübung SUPABASE_URL nur in der entbehrlichen lokalen/Serverumgebung vorübergehend auf ein ungültiges Testziel. Stelle dasselbe echte Ereignis erneut zu und beobachte einen Fehler, bei dem die Zustellung erneut versucht werden kann. Stelle die Einstellung wieder her, sende erneut und prüfe einen dauerhaften Beleg. Ändere niemals Produktionseinstellungen und teste nie mit einer echten Karte.
- Fehlgeschlagene dauerhafte Speicherung bestätigt keine erfolgreiche Verarbeitung.
- Wiederherstellung erzeugt einen Beleg; es werden weder echte Zahlungsdaten noch echtes Geld verwendet.
Häufiger Fehler
Einen Belegspeicher als vollständiges produktives Handelssystem bezeichnen.
War diese Lektion hilfreich?
Hinterlasse ein Like oder teile sie mit jemandem, dem sie helfen könnte.
Weiterlernen
- So erstellst du deine erste persönliche Website
- So veröffentlichst du deine Website über GitHub
- So verbindest du eine eigene Domain mit deiner Website
- So richtest du E-Mail auf deiner eigenen Domain ein
- So machst du deine Website auf Telefonen benutzbar
- So laden Bilder deiner Website schneller
- So erhältst du Website-Feedback in deinem Postfach
- So ergänzt du deine Website um E-Mail-Abonnements
- So sendest du automatisierte E-Mails von deiner Website
- So speicherst du Formulareingaben in einer Datenbank
- So können sich Menschen auf deiner Website anmelden
- So hältst du eine Seite privat
- So können Nutzer ihre Profilinformationen bearbeiten
- So können Nutzer Bilder hochladen
- So hältst du API-Schlüssel aus deinem Frontend heraus
- So zeigst du Daten einer externen API auf deiner Website
- So ergänzt du deine Website um einen KI-Chatbot
- So beantwortet ein Chatbot Fragen anhand deiner eigenen Inhalte
- So ergänzt du deine Website um einen Blog
- So ergänzt du deine Website um eine Suche
- So ergänzt du deine Website um eine weitere Sprache
- So hilfst du Google, deine Website zu finden
- So reparierst du die Vorschau deiner Website beim Teilen eines Links
- So misst du Besuche und nützliche Aktionen auf deiner Website
- So können Besucher einen Termin buchen
- So prüfst du Website-Änderungen vor dem Veröffentlichen
- So machst du ein fehlerhaftes Website-Deployment rückgängig
- So sicherst du deine Website-Daten und stellst sie wieder her
- So findest und behebst du Fehler auf deiner veröffentlichten Website