Eine Magento Website verbinden¶
Saferpay über mame vorbereiten¶
Melde dich bei mame an. Richte die Saferpay-Anbindung und die erforderlichen Worldline-/Acquiring-Verträge über mame ein. Weitere Zahlungsarten können separate Akzeptanzverträge benötigen. Schliesse die Händleraktivierung ab, bevor du Live-Zahlungen erwartest.
Bereite eine aktive Saferpay-Zahlungskonfiguration, einen Shop und ein Terminal im selben mame-Konto wie die Modul-Lizenz vor. Folge den Aktivierungsschritten und prüfe die dort angezeigten Gebühren und Bedingungen. Verwende für Testzahlungen ein Testterminal. Die mame-Staging-Umgebung und der Test-/Live-Modus des Provider-Terminals sind getrennte Einstellungen.
Aus Magento verbinden¶
- Öffne Stores > Configuration > Sales > Saferpay im Magento Admin.
- Wähle die gewünschte Website im Scope-Wähler. Store Views teilen die Website-Verbindung; weitere Websites werden separat eingerichtet.
- Klicke auf Connect with mame und erlaube das Popup für den Shop.
- Melde dich im Konto des Lizenzinhabers an. Wähle die Saferpay for Magento 2-Lizenz, den passenden Saferpay-Shop und dessen Zahlungskonfiguration/Terminal. Prüfe vor der Freigabe die Website-URL. Der Assistent bietet bei Bedarf auch die unterstützten Schritte zum Erstellen eines Shops und einer Konfiguration an.
- Bestätige die Verbindung und warte, bis Magento die Übernahme der Einstellungen bestätigt. Halte beide Fenster bis zum Abschluss offen.
- Speichere die Konfiguration und aktiviere die Verbindung. Prüfe den Verbindungsstatus und die synchronisierten Zahlungsarten.
- Aktiviere die gewünschten Optionen unter Sales > Payment Methods, wie unter Checkout-Einstellungen beschrieben.
Der Assistent überträgt API-Client-Zugangsdaten, Lizenz, Webhook-Schlüssel und die numerische mame-Saferpay-Shop-ID. Diese ist nicht die Worldline-Kundennummer oder Terminal-ID. Ersetze sie nicht durch diese Nummern und kopiere keine Verbindung einer anderen Website.
Single erlaubt eine Aktivierung, Multi bis zu fünf. Ist die Kapazität ausgeschöpft, prüfe nicht mehr verwendete Aktivierungen in der Lizenzverwaltung oder führe ein Upgrade durch. Passende URLs im Assistenten sind Vorschläge; prüfe Shop und Terminal vor der Freigabe.
Manuelle Verbindung¶
Nutze die aufklappbaren manuellen Einstellungen, falls das Popup nicht abgeschlossen werden kann. Öffne den Magento-Einrichtungsassistenten für Saferpay bei mame, wähle Website-URL, Lizenz, Shop und Zahlungskonfiguration und erstelle den vorgesehenen Magento-API-Client. Dieser Zugang ist vom Composer-Downloadzugang getrennt.
Übertrage nur die angeforderte Client-ID, das Secret, den Lizenzschlüssel, den Webhook-Schlüssel und die mame-Shop-ID in die passenden Website-Felder. Speichere, prüfe/synchronisiere die Verbindung und kontrolliere die aufgeführten Zahlungsarten. Halte Zugangsdaten aus Screenshots, E-Mails, Browser-URLs und Git fern. Ist der Assistent im Konto nicht verfügbar, kontaktiere den Support; verwende keinen Assistenten einer anderen Shop-Plattform.
Test- und Produktivumgebung¶
Standardmässig wird die produktive mame-Umgebung verwendet. Der Zugang zu stage.mamedev.ch ist eine Entwickleroption. Dafür muss der Serveradministrator folgenden Eintrag in das von app/etc/env.php zurückgegebene Array aufnehmen:
'mame_saferpay' => [
'allow_staging' => true,
],
Ergänze das vorhandene PHP-Array und erhalte alle anderen Einstellungen samt Verschlüsselungsschlüssel. Bearbeite die Datei auf dem Host oder über dein Deployment. Führe sie nicht als Shell-Befehl aus. Leere den Konfigurationscache und wähle in der Saferpay-Website-Konfiguration die gewünschte mame-Umgebung. Verwende getrennte Zugangsdaten und ein Provider-Testterminal.
Verbinde vor dem Livegang die Produktivumgebung mit dem freigegebenen Live-Terminal und prüfe Zahlungsarten, Währung und Rückmeldungen erneut. Bestehende Zahlungsreferenzen behalten ihre ursprüngliche Umgebung. Wechsle nicht die Umgebung, um einen ungeklärten Zahlungsvorgang zu wiederholen.
Webhooks und Cron¶
Der Website-spezifische Endpunkt lautet:
https://shop.example/saferpay/webhook/receive/website/WEBSITE_ID
Ersetze Host, Basispfad und Website-ID durch die tatsächlichen Shop-Werte. Der Endpunkt muss über HTTPS ohne Login oder vorgeschaltete Wartungsseite erreichbar sein. Die Verbindung verwendet den passenden Webhook-Schlüssel; deaktiviere zur Fehlerbehebung niemals die Signaturprüfung.
Magento-Cron muss laufen. Benachrichtigungen und Wiederherstellung lösen authentifizierte Statusabfragen aus; eine erfolgreiche Browser-Rückleitung allein bestätigt keine Zahlung. Prüfe vor Kundenfreigabe mit einer echten Testzahlung den Magento-Status, die Rechnung und die Rückmeldung.