LektionenSo nimmst du eine Zahlung auf deiner Website an

Mini-Lektion 26 von 30 · Deine Website betreiben und pflegen

Wähle ein Sandbox-Zahlungsziel

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.

Beginne mit einem gehosteten Checkout, statt selbst Kartendaten zu erfassen.

Ziel dieser Lektion

  • 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.
Erklärung, ausgearbeitetes Beispiel und Übung

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.

Prüfe deine Vorkenntnisse

Diese Fähigkeiten sind hilfreich; ein Kursabschluss wird nicht erzwungen. Beherrschst du sie schon, starte hier. Sonst öffne die Vorbereitung. Eine eigene bestehende Website ist dank der Startdateien nicht nötig.

  1. So veröffentlichst du deine Website über GitHub

    Verbinde ein Übungsrepository mit einem Hostingdienst.

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.

Die Idee verstehen

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.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Einzelne Dateien ansehen (optional)

Selbst ausprobieren

Welchen Testartikel und Preis beschreibt deine Schaltfläche, und wo prüfst du die Zahlung?

Ausgearbeitete Lösung anzeigen

Mein Beispielprodukt ist „Sample digital workshop“ für USD 5 in der Stripe-Testumgebung. Die Schaltfläche öffnet seinen gehosteten Testcheckout. In meinem Stripe-Konto würde ich den bezahlt-Status, Betrag und Währung der passenden Zahlung prüfen. Ein Besuch von success.html würde keine Zahlung belegen.

Was eine gute Antwort enthält

  • Benennt ein erfundenes Testprodukt, Betrag und Währung.
  • Erkennt den Zahlungsdatensatz beim Anbieter als Stelle zur Zahlungsprüfung.
So funktioniert es (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

Zusätzliche technische Übung

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.

Schritt 1 · So nimmst du eine Zahlung auf deiner Website an

Erstelle und verbinde den Testlink

Nutze das Anbieterdashboard und lass den Assistenten die Seite bearbeiten.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

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.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Einzelne Dateien ansehen (optional)

Selbst ausprobieren

Öffnet die Websiteschaltfläche den vorgesehenen Sandbox-Checkout mit richtigem Artikel und Preis?

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.

Was eine gute Antwort enthält

  • 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.
So funktioniert es (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

Zusätzliche technische Übung

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.

Schritt 2 · So nimmst du eine Zahlung auf deiner Website an

Schließe eine Testzahlung beim Anbieter ab

Nutze die offiziellen Testanweisungen und prüfe das Kontoergebnis.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

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.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

    Einzelne Dateien ansehen (optional)

    Selbst ausprobieren

    Was meldete der Anbieterdatensatz tatsächlich für deine Testzahlung?

    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.

    Was eine gute Antwort enthält

    • Findet die passende Testzahlung und ihren tatsächlichen bezahlt-Status im Anbieterkonto.
    • Vergleicht festgehaltenen Betrag und Währung mit dem gewählten Testpreis.
    So funktioniert es (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

    Zusätzliche technische Übung

    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.

    Schritt 3 · So nimmst du eine Zahlung auf deiner Website an

    Probiere Abbruch und direkten Aufruf der Rückkehrseite aus

    Prüfe, dass Besucher durch Navigation kein bezahltes Ergebnis erzeugen können.

    Erklärung, ausgearbeitetes Beispiel und Übung

    Die Idee verstehen

    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.

    Dateien für diesen Schritt

    Hier beginnenWorkshop-Dateien

    Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

      Einzelne Dateien ansehen (optional)

      Selbst ausprobieren

      Was belegten Abbruch und direkter Besuch der Rückkehrseite, und was belegten sie nicht?

      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.

      Was eine gute Antwort enthält

      • 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.
      So funktioniert es (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.

      Zusätzliche technische Übung

      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.

      Schritt 4 · So nimmst du eine Zahlung auf deiner Website an

      Übergib den grundlegenden Zahlungsweg

      Stelle einen nützlichen Link fertig, ohne ein vollständiges Handelssystem zu behaupten.

      Erklärung, ausgearbeitetes Beispiel und Übung

      Die Idee verstehen

      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.

      Dateien für diesen Schritt

      Hier beginnenWorkshop-Dateien

      Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

      Einzelne Dateien ansehen (optional)

      Selbst ausprobieren

      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.

      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.

      Was eine gute Antwort enthält

      • 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.
      So funktioniert es (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.

      Zusätzliche technische Übung

      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.

      War diese Lektion hilfreich?

      Hinterlasse ein Like oder teile sie mit jemandem, dem sie helfen könnte.