Konfiguration

Machen Sie das Modul Stripe Payment für OXID für Ihren OXID eShop betriebsbereit.

Grundsätzliches Vorgehen

  1. Stellen Sie sicher, dass das Modul aktiviert ist.

  2. Ermöglichen Sie die Kommunikation mit Stripe:

    1. Generieren Sie Schlüssel, um Ihren OXID eShop mit Stripe zu verbinden.

    2. Optional: Ordnen Sie die von Stripe verwendeten Bestell-Status den Ordnen Ihrer Bestellungsverwaltung zu.

    3. Legen Sie Cronjobs an, um beispielsweise den Versandstatus an Stripe zu übermitteln oder unabgeschlossene Bestellungen abzuschließen.

    4. Legen Sie einen Webhook an, damit Stripe Statusmeldungen an Ihren OXID eShop senden kann.

  3. Konfigurieren Sie die von Stripe Payment für OXID bereitgestellten Zahlungsmethoden als Zahlungsarten in Ihrem eShop:

    • Aktivieren Sie die Länder, die Sie abdecken wollen.

    • Verknüpfen Sie die Zahlungsarten mit Ihren Versandarten und Versandkostenregeln.

  4. Machen Sie Testzahlungen und passen Sie die Konfiguration an, bis alle Zahlungsprozesse nach Ihren Vorstellungen funktionieren.

  5. Um Stripe Payment für OXID im Live-Modus zu betreiben, wiederholen Sie den Prozess analog.

Stripe Payment aktivieren

Stellen Sie sicher, dass Stripe Payment für OXID in jedem Subshop aktiviert ist, in dem Sie das Modul nutzen wollen.

Vorgehen

  1. Wählen Sie Erweiterungen ‣ Module.

  2. Wählen Sie das Modul Stripe Payment.

  3. Wenn das Modul noch nicht aktiviert ist, wählen Sie Stamm ‣ Aktivieren.

Stripe Payment konfigurieren

Starten Sie das Konfigurieren.

Voraussetzungen

  • Sie haben Stripe Payment aktiviert.

Vorgehen

Wählen Sie Erweiterungen ‣ Module ‣ Stripe Payment ‣ Einstell..

Note

Bei Bedarf Cache leeren

Wenn die Konfigurationseinstellungen nicht korrekt angezeigt werden, leeren Sie den Cache.

Weitere Informationen finden Sie unter Installation im Schritt Cache leeren.

Grundkonfiguration einrichten

Verbinden Sie Stripe Payment mit Stripe.

Voraussetzungen

Vorgehen

  1. Melden Sie sich im Stripe Dashboard an (unter dashboard.stripe.com/dashboard).

  2. Wählen Sie im OXID eShop Admin-Bereich Erweiterungen ‣ Module ‣ Stripe Payment.

  3. Wählen Sie unter Grundkonfiguration die Schaltfläche Connect with stripe.
    Sie werden aufgefordert, das Konto zu wählen oder anzulegen, mit dem Sie Ihren OXID eShop verbinden wollen (Abb.: Stripe-Konto wählen).

    Stripe-Konto wählen

    Abb.: Stripe-Konto wählen

  4. Wählen Sie Connect (Abb.: Stripe-Konto wählen, Pos. 1).
    Das System bestätigt das Onboarding (Abb.: Onboarding bestätigt).

    Onboarding bestätigt

    Abb.: Onboarding bestätigt

  5. Wählen Sie die Schaltfläche Zum Admin-Bereich (Abb.: Onboarding bestätigt, Pos. 1).

  6. Wählen Sie Erweiterungen ‣ Module ‣ Stripe Payment ‣ Einstell..
    Unter Grundkonfiguration wird angezeigt, dass die Verbindung hergestellt ist (Abb.: Verbindung verifizieren und privaten Schlüssel eingeben, Pos. 1).

  7. Geben Sie Ihren privaten API-Schlüssel ein.

    1. Wählen Sie im Strip-Dashboard Entwickler ‣ API-Schlüssel.

    2. Wählen Sie die Schaltfläche Geheimschlüssel erstellen

      Geheimschlüssel erstellen

      Abb.: Geheimschlüssel erstellen

      Der private API-Schlüssel wird angezeigt (Abb.: Privaten API-Schlüssel kopieren).

      Privaten API-Schlüssel kopieren

      Abb.: Privaten API-Schlüssel kopieren

    3. Folgen Sie den Anweisungen zum Sichern Ihres privaten API-Schlüssels und wechseln Sie zurück in den Administrator-Bereich Ihres OXID eShops.

    4. Geben Sie Ihren privaten API-Schlüssel im Eingabefeld Test API Private Key ein (Abb.: Verbindung verifizieren und privaten Schlüssel eingeben, Pos. 2).

    5. Speichern Sie Ihre Eingaben (Abb.: Verbindung verifizieren und privaten Schlüssel eingeben, Pos. 3).

      Verbindung verifizieren und privaten Schlüssel eingeben

      Abb.: Verbindung verifizieren und privaten Schlüssel eingeben

Status-Mapping vornehmen

Ordnen Sie die Stripe-Zahlungsvorgangs-Status den Ordnern in der Bestellungsverwaltung zu, die Sie unter Stammdaten ‣ Grundeinstellungen ‣ Einstell. ‣ Administrationsbereich konfiguriert haben.

Vorgehen

Optional: Ordnen Sie die folgenden von Stripe verwendeten Bestell-Status den Ordnen Ihrer Bestellungsverwaltung zu:

  • Stripe-Status Ausstehend: Bestell-Status, bevor der Kunde zum Zahlungs-Gateway umgeleitet wird

  • Stripe-Status in Bearbeitung: Bestell-Status für abgeschlossene Zahlungen

  • Stripe-Status Storniert: Bestell-Status für stornierte Bestellungen

Resultat

Die mit Stripe abgewickelten Bestellungen werden entsprechend ihrem Stripe-Status in die entsprechenden Ordner sortiert und klassifiziert (Abb.: Stripe-Bestellungen nach Status kategorisiert anzeigen.

Stripe-Bestellungen nach Status kategorisiert anzeigen

Abb.: Stripe-Bestellungen nach Status kategorisiert anzeigen

Cronjobs anlegen

Richten Sie einen Cronjobs ein, um beispielsweise täglich unabgeschlossene Bestellungen abzuschließen.

Wenn Sie den Cronjob über eine URL aufrufen, fügen Sie den GET-Parameter secureKey hinzu.

Vorgehen

  1. Richten Sie auf Ihrem Server einen Cronjob ein, der im Modulverzeichnis auf die Datei /source/modules/fc/stripe/Application/Model/Cronjob.php verweist und damit – beispielsweise ein Mal täglich – die Skripte im Verzeichnis /source/modules/fc/stripe/Application/Model/Cronjob ausführt.

  2. Aktivieren Sie unter Cronjobs die Skripte, damit sie tatsächlich ausgeführt werden.

    • Abschluss von bezahlten, aber nicht vollendeten Bestellungen (FinishOrders.php)

      Schließen Sie Bestellungen ab, bei denen der Kunde erfolgreich bezahlt hat, aber scheinbar für den Abschluss des Bestellvorgangs nicht wieder in den Shop zurückgekehrt ist.

      Der Cronjob finalisiert nur Bestellungen aus den letzten 24 Stunden, um keine Bestellungen zu verändern, die wahrscheinlich schon manuell bearbeitet wurden.

    • Versand einer Zahlungs-Erinnerungs-Email (SecondChance.php)

      Versenden Sie automatisch E-Mails mit Zahlungserinnerungen, wenn eine Bezahlung noch nicht erfolgt ist. Ihr Kunde gelangt zurück in den Zahlungsvorgang und kann die Bestellung abschließen.

      Ändern Sie bei Bedarf die Betreff-Zeile in der Datei modules/fc/stripe/Application/translations/en/stripe_lang.php.

      Ändern Sie bei Bedarf den Anschreiben-Text der E-Mail unter Kundeninformation ‣ CMS-Seiten ‣ Stamm im Baustein Stripe Second Chance Email (Abb.: E-Mail-Template für Stripe-Zahlungserinnerungen anpassen).

      E-Mail-Template für Stripe-Zahlungserinnerungen anpassen

      Abb.: E-Mail-Template für Stripe-Zahlungserinnerungen anpassen

      Als Absender-Email-Adresse nutzt das System die E-Mail-Adresse, die unter Stammdaten ‣ Grundeinstellungen ‣ Stamm ‣ E-Mail-Adresse für Bestellungen konfiguriert ist.

    • Übermittlung von Versandstatus an Stripe (OrderShipment.php)

      Wenn Sie den Versandstatus in Ihrem Shop über ein externes System setzen und nicht manuell über die Jetzt versenden-Schaltfläche in der Bestellverwaltung Ihres OXID eShops unter Bestellungen verwalten ‣ Bestellungen, dann übermitteln Sie den Versandstatus automatisch per Cronjob.

      Beispiel: Sie wickeln die Transaktionen über ein ERP-System ab.

  3. Wenn Sie das Skript Versand einer Zahlungs-Erinnerungs-Email aktivieren, geben Sie im Eingabefeld Zeitfenster nach dem Zahlungs-Erinnerungs-Email versendet wird den entsprechenden Wert ein.

  4. Wenn Sie den Cronjob per URL aufrufen müssen (statt über die PHP-Kommandozeile), tun Sie Folgendes:

    1. Fügen Sie dem Aufruf des Cronjobs den GET-Parameter secureKey an.

      Beispiel: https://YOUR-SHOP-URL-HERE/modules/fc/stripe/cron.php?secureKey=YOUR-SECURE-KEY

    2. Geben Sie den Wert des Parameters secureKey ins Feld Cronjob Sicherheits-Schlüssel ein.

  5. Speichern Sie Ihre Eingaben.

Webhook anlegen

Legen Sie einen Webhook an. Damit erlauben Sie es Stripe, Ihren OXID eShop zu kontaktieren und in Echtzeit Statusmeldungen beispielsweise über abgeschlossene Transaktionen zu liefern.

Voraussetzungen

  • Sie haben die Grundkonfiguration abgeschlossen (siehe Grundkonfiguration einrichten).

    Andernfalls erscheint die Fehlermeldung Ihr privater Stripe-Schlüssel wurde noch nicht konfiguriert.

Vorgehen

Wählen Sie unter Webhooks die Schaltfläche Webhooks erstellen.

Resultat

Das System zeigt an, dass der Webhook-Endpunkt konfiguriert ist (Abb.: Webhook-Endpunkt konfiguriert, Pos. 1).

Webhook-Endpunkt konfiguriert

Abb.: Webhook-Endpunkt konfiguriert

Testzahlungen ausführen

Um die Verbindung zu verifizieren, führen Sie Testzahlungen aus.

Testen Sie die mit Stripe Payment bereitgestellten Zahlungsarten.

Vorgehen

  1. Aktivieren Sie unter Schopeinstellungen ‣ Zahlungsarten die gewünschten Stripe-Zahlungsarten.

  2. Verifizieren Sie die Zuordnung der Zahlungsarten zu den Versandarten und Versandkostenregeln.

  3. Führen Sie eine Bestellung beispielsweise mit Stripe GiroPay als Zahlungsart aus und autorisieren Sie die Testzahlung (Abb.: Testzahlung autorisieren).

    Testzahlung autorisieren

    Abb.: Testzahlung autorisieren

  4. Um die Bestellung zu verifizieren, zeigen Sie unter Bestellungen verwalten ‣ Bestellungen ‣ <Bestellung> auf der Registerkarte Stripe die Zahlungsdetails an (Abb.: Testbestellung verifizieren, Pos. 1).

  5. Um die Cronjobs zu prüfen, machen Sie eine Bestellung, ohne sie abzuschließen.

    Testbestellung verifizieren

    Abb.: Testbestellung verifizieren

  6. Verifizieren Sie die Test-Bestellungen im Stripe-Dashboard unter Zahlungen (dashboard.stripe.com/test/payments, Abb.: Testbestellung im Stripe-Dashboard verifizieren).

    Testbestellung im Stripe-Dashboard verifizieren

    Abb.: Testbestellung im Stripe-Dashboard verifizieren

  7. Empfohlen: Prüfen Sie das Transaktionslog unter <Root-Verzeichnis Ihres OXID eShops>/log/StripeTransactions.log.

  8. Optional: Prüfen Sie, ob Sie Ihre Zahlungsarten und Währungseinstellungen wie gewünscht konfiguriert haben.
    Erzeugen Sie dazu mögliche Fehlerfälle, die das System standardmäßig automatisch unterdrückt.

    1. Um diese möglichen Fehlerfälle zu erzeugen, deaktivieren Sie vorübergehend unter Grundkonfiguration die folgenden Kontrollkästchen:

      • Für Rechnungsland nicht unterstützte Zahlarten entfernen

      • Für Währung nicht unterstützte Zahlarten entfernen

    2. Prüfen Sie mit Testzahlungen, ob Fehler auftreten, und passen Sie Ihre Konfiguration bei Bedarf an.

    3. Empfohlen: Stellen Sie nach Ihren Tests sicher, dass die Kontrollkästchen wieder aktiviert sind.

  9. Optional: Deaktivieren Sie das Aufzeichnen von Transaktionslogs, wenn Ihnen das beispielsweise aus Gründen der Sicherheit oder der Datensparsamkeit nötig erscheinen sollte.
    Dazu deaktivieren Sie das Kontrollkästchen Ergebnisse von Transaktions-Verarbeitung loggen.

Länderzuordnung von Stripe-Zahlungsmethoden konfigurieren

Stellen Sie sicher, dass bestimmte Stripe Payment für OXID-Zahlungsmethoden ausschließlich in den von Ihnen gewünschten Ländern zur Verfügung stehen.

Hintergrund

Die meisten Stripe-Zahlungsmethoden decken mehrere Länder ab. Die Zahlungsmethode Kreditkarte beispielsweise ist Kunden weltweit zugänglich, die Zahlungsmethode iDeal steht Ihren Kunden beispielsweise in den Niederlanden zur Verfügung.

Weitere Informationen über die Länderabdeckung der einzelnen Stripe-Zahlungsmethoden finden Sie unter Marktabdeckung nach Zahlungsmethoden.

Grundsätzlich gilt dabei: Die Rechnungsadresse und nicht die Lieferadresse eines Kunden bestimmt, ob eine Stripe-Zahlungsmethode dem Kunden zur Auswahl steht.
Beispiel: Nur Kunden mit einer Rechnungsadresse in Polen erhalten die Zahlungsmethode Stripe Przelewy24 angeboten.

Vorgehen

Um die Zugänglichkeit einer Stripe-Zahlungsmethode auf bestimmte Länder einzuschränken, wählen Sie Shopeinstellungen ‣ Zahlungsarten ‣ <Zahlungsart> ‣ Länder ‣ Länder zuordnen.