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.

Interaktive Lektion startenLektionsnotizen lesen

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.

Workshop-Dateien

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

Start hereWorkshop-Dateien

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.

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

Dateien für diesen Schritt

Start hereWorkshop-Dateien

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.

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.

Stripe: Testen

Dateien für diesen Schritt

Start hereWorkshop-Dateien

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.

    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.

    Dateien für diesen Schritt

    Start hereWorkshop-Dateien

    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.

      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.

      Dateien für diesen Schritt

      Start hereWorkshop-Dateien

      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)

      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.

      War diese Lektion hilfreich?

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

      Weiterlernen

      Weitere Lektionen entdecken