Modul installieren und verbinden

Über Mit mame verbinden verknüpfst du deinen Shop, wählst seine Zahlungskonfiguration aus und aktivierst die Modullizenz, ohne Verbindungs-Zugangsdaten manuell zu kopieren.

Voraussetzungen

• Ein PrestaShop-Backoffice-Zugang mit Berechtigung zur Installation und Konfiguration von Modulen.
• Die ZIP-Datei von Saferpay for PrestaShop und eine gültige Lizenz für diesen Shop.
• Ein mame-Konto mit aktiver Saferpay-Zahlungskonfiguration und Store mit aktivem Terminal oder die Berechtigung, deren Einrichtung abzuschliessen.
• HTTPS für den Shop, ausgehender HTTPS-Zugriff auf mame und eingehende Erreichbarkeit für Zahlungsbenachrichtigungen.
• Eine von deiner PrestaShop-Version unterstützte PHP-Version mit cURL und OpenSSL. Die automatische Verbindung benötigt mindestens PHP 7.1; neuere PrestaShop-Versionen benötigen neuere PHP-Versionen.

Das Modul deklariert Unterstützung ab PrestaShop 1.7. Prüfe vor der Installation die Anforderungen des gelieferten Releases und deines Shops. Sichere zuerst Shop-Dateien und Datenbank.

1. Saferpay installieren

1. Öffne im Backoffice Module → Modulmanager.
2. Wähle Modul hochladen und lade die von mame gelieferte ZIP-Datei hoch.
3. Schliesse die Installation ab, suche nach Saferpay und wähle Konfigurieren.
4. Wähle bei Multishop den einzelnen Shop aus, den du einrichten möchtest. Der Verbindungsassistent lässt sich im Kontext Alle Shops oder einer Shop-Gruppe nicht starten.

Screenshot ergänzen — SP01

Hier den lokalen Modulmanager mit Saferpay, Versionsnummer und Konfigurieren einfügen. Mitarbeiterprofil und fremde Module wegschneiden. Vorgeschlagener Dateiname: installation-de.png.

2. Verbindungsassistent starten

1. Klicke in den Moduleinstellungen auf Mit mame verbinden.
2. Erlaube das Popup und melde dich in deinem mame-Konto an.
3. Lass die ursprüngliche PrestaShop-Einstellungsseite während der Einrichtung geöffnet.

Der Link Saferpay bei mame auf derselben Seite öffnet deine Saferpay-Applikation separat. Starte die Verbindung über Mit mame verbinden, damit der Assistent die gewählte Verbindung an diesen Shop zurückgeben kann.

Screenshot ergänzen — SP02

Hier den oberen Bereich der Moduleinstellungen mit Nicht verbunden, Mit mame verbinden und eingeklappten Manuellen Verbindungseinstellungen einfügen. Einen Testshop verwenden und Zugangsdaten-Felder geschlossen lassen. Vorgeschlagener Dateiname: connect-de.png.

3. Zahlungskonfiguration und Store wählen

Wähle im mame-Fenster die aktive Saferpay-Zahlungskonfiguration und danach den für diesen Shop vorgesehenen Store. Falls der Assistent die Erstellung anbietet, fülle das Konfigurations-/Store-Formular aus und prüfe vor der Zustimmung die angezeigten Bedingungen und Gebühren.

Vergleiche Shop-URL, Zahlungskonfiguration und Terminal des Stores statt nur seinen Namen. Der Assistent zeigt deine eigenen Stores und schlägt passende URLs zuerst vor. Ein inaktiver oder unvollständig eingerichteter Store lässt sich nicht auswählen.

Wählst du einen bestehenden Store einer anderen Zahlungskonfiguration, wird dessen vorhandene Konfiguration verwendet; der Store wird nicht verschoben. Lies den Hinweis vor dem Fortfahren. Ein Store ist der Händler-/Shop-Eintrag bei mame; sein Terminal bezeichnet die zugehörige Saferpay-Anbindung.

Screenshot ergänzen — SP03

Hier die Store-Auswahl im Assistenten mit fiktiver Shop-URL sowie Konfigurations- und Terminal-Bezeichnung einfügen. Einen auswählbaren und bei Bedarf einen nicht verfügbaren Store zeigen. Keine Zugangsdaten oder Setup-Tokens aus der Adressleiste aufnehmen. Vorgeschlagener Dateiname: select-store-de.png.

4. Lizenz wählen und abschliessen

Wähle die gültige Saferpay-for-PrestaShop-Lizenz für den Shop und bestätige die Verbindung. Kehre zu PrestaShop zurück und warte auf die Meldung zur gespeicherten Verbindung. Nutze Verbindung und Zahlungsarten aktualisieren, wenn diese Aktion angeboten wird.

Das Modul speichert die Verbindung und synchronisiert die Zahlungsarten des gewählten Stores. Weiter mit Zahlungsarten und Checkout-Einstellungen: Die Synchronisierung allein aktiviert nicht jede separate Checkout-Option.

Schliesst sich das Popup vor dem Abschluss, öffne es erneut über das Modul. Ist die Einrichtung abgelaufen oder wurden Einstellungen in einem anderen Tab geändert, starte die Verbindung von der aktuellen Einstellungsseite neu.

Screenshot ergänzen — SP04

Hier die Lizenz-Auswahl und Bestätigung mit maskierter Demo-Lizenz einfügen, danach das Modul mit Mit mame verbunden. Keine Lizenzschlüssel, Client Secrets, Webhook-Schlüssel oder Setup-URLs zeigen. Vorgeschlagene Dateinamen: license-de.png, connected-de.png.

Manuelle Verbindung

Nutze Manuelle Verbindungseinstellungen, falls die geführte Verbindung nicht verfügbar ist oder der Support dich dazu auffordert.

Feld	Was du einträgst
Saferpay-Lizenzschlüssel	Deine Saferpay-for-PrestaShop-Lizenz; Lizenz aktivieren verwenden
API Client ID / API Client Secret	Der Saferpay-API-Client aus deinem mame-Konto
Webhook-Schlüssel	Der Benachrichtigungsschlüssel der passenden mame-Verbindung
Saferpay Store	Stores synchronisieren und danach den vorgesehenen Store wählen

Das sind mame-Verbindungsdaten, nicht dein Worldline-/Saferpay-Backoffice-Passwort oder die API-Zugangsdaten des Zahlungsanbieters. Halte die Geheimnisse vertraulich. Gespeicherte Secret-Felder bleiben leer; lässt du sie leer, bleibt der gespeicherte Wert erhalten.

Trage die Verbindungsdaten ein und speichere, aktiviere die Lizenz, wähle Stores synchronisieren, wähle den vorgesehenen Store und speichere erneut. Prüfe dessen Verfügbarkeit und aktiviere die gewünschten Zahlungsarten. Werden keine Stores angezeigt, hilft die Fehlerbehebung.

Multishop und erneute Verbindung

Wiederhole die Einrichtung im jeweiligen einzelnen Shop-Kontext mit passender URL, Store und Lizenzberechtigung. Gehe nicht davon aus, dass die Verbindung eines Shops für alle Shops gilt. Mit Erneut mit mame verbinden ersetzt oder reparierst du eine Verbindung. Kontrolliere danach die synchronisierten Zahlungsarten und den Checkout dieses Shops.

Schliesse vor der Annahme von Kundenzahlungen die Test-Checkliste ab.