Zum Inhalt springen
QR code to Stripe paymentsQR2Stripe-Dokumentation

← Alle Anleitungen

Das WordPress-Plugin einrichten

Das Plugin QR2Stripe Pay erstellt die Zahlungen, zeigt den QR-Code und markiert eine Zahlung als bezahlt, sobald Stripe sie bestätigt.

Temporary Stripe key Schlüssel A. Wird von der automatischen Stripe-Einrichtung einmal verwendet und nicht gespeichert.
Location name, Street, City, Postal code, Country (2 letters) Die Adresse der Terminal Location. Das Land muss mit dem Land Ihres Stripe-Kontos übereinstimmen.
Terminal Location ID Die ID der Terminal Location, sie beginnt mit tml_. Wird von der automatischen Einrichtung ausgefüllt.
Webhook signing secret Das Signaturgeheimnis des Stripe-Webhooks, es beginnt mit whsec_. Ohne es werden Zahlungen nie als bezahlt markiert.
QR mode API (empfohlen) oder Inline. Siehe den Artikel zu API-Modus und Inline-Modus.
Website Stripe key (API mode) Schlüssel B. Statt ihn hier zu speichern, können Sie QR2STRIPE_API_KEY in wp-config.php definieren, dann liegt der Schlüssel nicht in der Datenbank.
QR validity (minutes) Wie lange ein QR-Code bezahlt werden kann. Der Standardwert ist 10 Minuten.
Default currency, Merchant name Die Währung neuer Zahlungen und der Händlername, der auf dem Telefon angezeigt wird.

Plugin installieren: Öffnen Sie in WordPress Plugins → Installieren → Plugin hochladen, laden Sie qr2stripe-pay-VERSION.zip hoch und klicken Sie auf Aktivieren. Eine Seite namens Payment mit dem Shortcode [qr2stripe_payment] wird automatisch erstellt.

Automatische Stripe-Einrichtung: Öffnen Sie QR2Stripe → Settings → Automatic Stripe setup, fügen Sie Schlüssel A ein, tragen Sie Name und Adresse der Location ein und klicken Sie auf Set up Stripe. Das Plugin erstellt die Terminal Location und den Webhook und speichert die Location-ID und das Webhook-Signaturgeheimnis. Schlüssel A wird einmal verwendet und nicht gespeichert. Löschen Sie Schlüssel A danach sofort in Stripe.

Wählen Sie den QR-Modus. Fügen Sie im API-Modus Schlüssel B in Website Stripe key (API mode) ein oder definieren Sie ihn in wp-config.php (siehe das erste Beispiel). Speichern Sie die Einstellungen.

Die gelben Hinweise oben auf den QR2Stripe-Seiten zeigen, was noch fehlt. Wenn sie verschwunden sind, ist die Website bereit.

Um den Stripe-Teil von Hand zu erledigen, erstellen Sie die Location in Stripe (Terminal → Locations, kopieren Sie die tml_-ID) und einen Webhook (Developers → Webhooks → Add endpoint oder Add destination) für Ereignisse aus Your account, das einzige Ereignis payment_intent.succeeded und die Endpoint-URL aus dem zweiten Beispiel. Zeigen Sie das Signaturgeheimnis an und fügen Sie Location-ID und Geheimnis in die Plugin-Einstellungen ein. Ein Webhook benötigt keine Berechtigungen. Er muss über öffentliches HTTPS erreichbar sein, localhost funktioniert nicht.

Die Website-Adresse muss HTTPS verwenden und die Permalinks müssen aktiviert sein (Einstellungen → Permalinks, alles außer „Einfach“). Sonst enthält die QR-Adresse ?rest_route= und die App lehnt sie ab.

define('QR2STRIPE_API_KEY', 'rk_...');
https://YOUR-SITE/wp-json/qr2stripe/v1/stripe-webhook