Checkout, Danke-Seite und E-Mail-Flow testen

Vier Lektionen hast du jetzt aufgebaut, ohne den Kauf-Button einmal anzuklicken. Das ist Absicht — hätten wir dich nach Lektion 03 in den Testkauf geschickt, wären fehlender Webhook, falsch kopierte Price ID und leere Mailstrecke alle gleichzeitig aufgeschlagen und die Fehlersuche hätte dich zwei Stunden gekostet. Jetzt ziehen wir den kompletten Flow einmal durch.

Die Danke-Seite vorbereiten

Stripe leitet nach einer erfolgreichen Zahlung automatisch auf eine Seite deines Blogs weiter — und die muss existieren, sonst landet deine Käuferin bei einem 404.

In WordPress auf Seiten → Erstellen, neue Seite mit Titel „Danke" anlegen, Permalink auf /danke/ setzen. Im Inhalt steht genau ein Block:

[bap_download_thank_you]

Speichern und veröffentlichen, fertig. Der Shortcode rendert die komplette Danke-Seite inklusive „Vielen Dank für deinen Kauf"-Text und dem Hinweis, dass die Datei gleich per Mail kommt. Du brauchst dort keinen eigenen Text, keinen Download-Button, keine Session-Logik.

Wichtig: Das Theme erwartet die Seite fest unter /danke/. Legst du sie unter /thank-you/ oder /kauf-erfolgreich/ an, zeigt Stripe nach der Zahlung eine 404-Seite. Einmal einrichten, dann stimmt der Pfad für alle Produkte.

Testmail vor dem ersten Kauf

Der häufigste Punkt, an dem ein Testkauf am Ende hängt: Zahlung geht durch, Webhook kommt sauber an, Theme speichert den Kauf — und die E-Mail kommt trotzdem nie bei der Käuferin an. In neun von zehn Fällen liegt das nicht am Theme, sondern an der WordPress-Mailstrecke.

Geh vor dem echten Testkauf auf Design → Downloads → Einrichtung, runter zu „Schritt 4: E-Mail-Test". Trag deine eigene E-Mail-Adresse ein, klick Test-Mail senden. Innerhalb weniger Sekunden soll die Testmail im Posteingang liegen.

Kommt nichts an, ist die Ursache fast immer eine von drei:

• Kein SMTP-Plugin aktiv. WordPress versucht dann, über die mail()-Funktion des Hosters zu senden, die bei vielen Shared-Hostern gar nicht aktiv ist. Abhilfe: WP Mail SMTP oder Fluent SMTP installieren und den Versand auf SendGrid, Brevo oder Mailgun umleiten.
• SMTP-Plugin installiert, aber nicht verbunden. API-Key falsch, oder „Von"-Feld zeigt auf eine nicht verifizierte Domain. Jedes SMTP-Plugin hat einen eigenen Testversand-Button — den zuerst klicken.
• Mail landet im Spam. Bei den ersten Versandversuchen eines neuen Blogs möglich. Im Spam-Ordner nachschauen und als „kein Spam" markieren.

Erst wenn die Testmail im Posteingang liegt, klickst du den Buy-Button. Sonst ersparst du dir später die Frage, ob der Webhook oder die Mail schuld ist.

Den ersten Testkauf durchspielen

Öffne den Blog-Post, in den du in Lektion 03 den Shortcode [bap_buy product="feierabendrezepte-30"] eingebaut hast. Der Button sollte dort mit Name und Preis-Anzeige stehen.

Klick drauf. Zwei Dinge passieren:

1. Kurzes Laden — das Theme ruft die Stripe-Checkout-API und bekommt eine Session-URL zurück.
2. Weiterleitung auf https://checkout.stripe.com/…. Du landest auf der gehosteten Stripe-Zahlungsseite mit deinem Produktnamen, dem Betrag aus der Price ID und einem Kartenfeld.

Gib die Testkarte aus Lektion 02 ein:

• Kartennummer: 4242 4242 4242 4242
• Ablauf: beliebiges Datum in der Zukunft (z. B. 12/30)
• CVC: drei beliebige Ziffern
• PLZ: fünfstellig, beliebig
• E-Mail: eine Adresse, an die du die Kauf-Mail erwartest — am besten dieselbe wie beim Testmail-Versand

Klick Bezahlen. Nach zwei bis drei Sekunden landest du zurück auf deinem Blog unter https://deineblog.de/danke/?session_id=cs_test_a1b2c3….

Was die Danke-Seite dir verrät

Die Danke-Seite zeigt eine Bestätigung „Vielen Dank für deinen Kauf" mit dem Produktnamen und dem Hinweis, dass die Datei gleich per Mail kommt. Unter der Haube passiert dabei mehr: Der Shortcode liest die session_id aus dem URL-Parameter und prüft zuerst lokal in der Datenbank, ob das Theme den Kauf schon hat — der Webhook ist bei Kartenzahlungen meist zwei, drei Sekunden schneller als die Browser-Weiterleitung.

Ist der Kauf noch nicht lokal gefunden (Webhook hinterherhinkt oder bei SEPA erst in Tagen), fragt die Seite als Fallback direkt bei Stripe nach. Ergebnis: Die Käuferin sieht immer eine sinnvolle Bestätigung.

Der eigentliche Download-Link wird auf der Danke-Seite nicht angezeigt. Das ist bewusst so — das Theme liefert die Datei ausschließlich als E-Mail-Anhang aus, damit die Käuferin einen echten Posteingangs-Beleg hat und die Datei nicht verliert, wenn sie den Browser-Tab versehentlich schließt.

Die Kauf-E-Mail prüfen

Wechsel ins Postfach der Test-Adresse. Innerhalb von ein bis zwei Minuten sollte eine Mail mit Absender deines Blogs und dem Produktnamen im Betreff liegen. Im Anhang findest du dein PDF.

Öffne die Datei einmal kurz. Manchmal passiert hier der peinliche Fehler, dass versehentlich eine Vor-Vor-Version hochgeladen wurde, die noch einen Tippfehler oder ein nicht freigegebenes Bild enthält. Lies die Datei einmal so, als wärst du die Käuferin.

Wenn die Mail ankommt und das PDF korrekt ist, ist dein Flow technisch vollständig funktional. Du hast gerade deinen ersten digitalen Verkauf durchgespielt.

Wenn etwas nicht durchläuft

Kurze Diagnose-Reihenfolge, bevor du in Lektion 06 in die ausführliche Fehlerbilder-Sammlung gehst:

• Button lädt endlos oder zeigt Fehler. Stripe-Keys im Einrichtungs-Tab prüfen. Meist sitzt der Secret Key nicht oder ist aus dem Live-Modus, während das Produkt im Test-Modus liegt.
• Stripe-Checkout funktioniert, aber Danke-Seite zeigt 404. Die Seite /danke/ existiert nicht oder liegt unter einem anderen Slug. Neu anlegen mit exakt dem Slug danke.
• Alles bis zur Danke-Seite läuft, aber keine Mail kommt an. Testmail aus dem Einrichtungs-Tab durchspielen. Wenn die schon scheitert, scheitert die Kauf-Mail immer.
• Testmail geht raus, Kauf-Mail nicht. Webhook-Detailseite in Stripe öffnen. Aktueller 200 OK-Eintrag? Wenn nicht, Signing Secret zurück in den Fokus. Wenn 200 OK erscheint, steckt der Fehler zwischen Webhook-Empfang und Mailversand — dafür hat Lektion 06 den Käufe-Tab als Diagnose-Werkzeug.

Was jetzt steht und was Lektion 06 bringt

Dein Theme verkauft tatsächlich. Ein Klick auf den Button erzeugt eine echte Stripe-Session, die Testkarte zieht die Zahlung durch, der Webhook speichert den Kauf, die E-Mail liefert die Datei aus. Bei jedem weiteren Produkt läuft das identisch ab — du musst nie wieder eine Seite anlegen oder einen Webhook bauen, nur im Tab Produkte ergänzen.

In Lektion 06 gehen wir in den Käufe-Tab: Wer hat was gekauft, wurde die Mail zugestellt, wie sendest du sie im Bedarfsfall erneut, und welche Fehlerbilder sehen wir aus zehn Jahren Agenturpraxis am häufigsten.