Magento Website verbinden¶
1. TWINT-Store vorbereiten¶
Melde dich im TWINT-Händlerportal an. Hinterlege bei Bedarf das Auszahlungskonto und erstelle einen Online-Store. Wähle im üblichen Integrationsablauf die PSP-Anbindung und mame als PSP. Erfasse die Shop-Angaben und bewahre die erzeugte Store UUID auf.
Der Portal-Store, der mame-Store und die Magento Website sind unterschiedliche Objekte. Eine TWINT Store UUID ist nicht die numerische mame-Store-ID. Verwende für jede Website den vorgesehenen Händler und das richtige Auszahlungskonto.
Abbildungen des Portals findest du in der Anleitung zur Einrichtung des TWINT-Stores. Die Portalbeschriftungen können sich ändern; folge dem entsprechenden aktuellen Online-Store-/PSP-Ablauf.
2. Verbindung in Magento öffnen¶
- Melde dich im Magento Admin an und öffne Stores > Configuration > Sales > Payment Methods > TWINT by mame.
- Wähle im Geltungsbereich der Konfiguration die betreffende Website aus. Verbindungsdaten gelten pro Website. Eine Verbindung im Store View oder in Default Config ersetzt diese Zuordnung nicht.
- Aktiviere TWINT und wähle im Bereich Easy setup die Schaltfläche Connect with mame. Erlaube das Popup für den Shop.
- Melde dich im Popup im mame-Konto des Lizenzinhabers an und wähle eine gültige Lizenz für TWINT for Magento 2.
Single erlaubt eine aktive Website, Multi bis zu fünf. Ist eine Lizenz vollständig belegt, trenne eine nicht mehr benötigte Website oder führe ein Upgrade durch. Verwende keine aus einem anderen Shop kopierte Verbindungs-ID.
3. mame-Store auswählen oder erstellen¶
Wähle im Einrichtungsassistenten einen vorhandenen TWINT-Store oder füge mit der Store UUID aus dem Portal einen neuen hinzu. Lege den internen Namen und den öffentlichen Store-Namen fest. Prüfe, dass der Store aktiv ist und zu deinem mame-Konto gehört.
Wähle oder erstelle die mame-Zahlungskonfiguration für die Abrechnung der Transaktionsgebühren und ordne den Store zu. Hinterlege die erforderliche Zahlungsmethode für diese Abrechnung und aktiviere die Konfiguration. Sie bezahlt die mame-Gebühren; das Auszahlungskonto bei TWINT bestimmt die Auszahlung der Kundenzahlungen.
Prüfe und akzeptiere die aktuellen TWINT-Servicebedingungen und den angezeigten Tarif im Aktivierungsablauf des Kontos. Der Kauf der Modul-Lizenz allein aktiviert weder den Händler-Store noch die Zahlungskonfiguration.
4. Verbindung abschliessen¶
Bestätige im Assistenten die vorgesehene Website, Lizenz und den Store. API-Client-Zugangsdaten, Modul-Lizenz, Webhook-Schlüssel und Store-Zuordnung werden an Magento übertragen. Warte auf die erfolgreiche Übergabe und den Verbindungsstatus. Speichere die Magento-Konfiguration, falls der Bildschirm dazu auffordert, und führe die verfügbare Verbindungsprüfung aus.
Der Onboarding-Nachweis wird vom Magento-Server ausgetauscht. Für diese Popup-Übergabe benötigt ein lokaler Shop keinen eingehenden Callback. Zahlungs-Webhooks sind davon getrennt: Richte im Produktivshop öffentlich erreichbares HTTPS für asynchrone Zahlungsbenachrichtigungen ein.
Wiederhole die Verbindung für jede weitere Magento Website in deren Geltungsbereich. Store Views innerhalb derselben Website übernehmen deren Verbindung. Verwende für einen Store-Wechsel die Store-Auswahl des Moduls; historische Zahlungszuordnungen bleiben erhalten.
Manuelle Verbindung¶
Verwende Show manual connection settings nur für die manuelle Einrichtung einer vorhandenen Integration oder gemeinsam mit dem Support:
- Erstelle in mame einen API-Client mit TWINT-Berechtigung. Ein API-Token oder Composer-Passwort ist ein anderer Zugang.
- Übernimm Client ID, einmal angezeigtes Client Secret, mame-Webhook-Schlüssel und die gültige Modul-Lizenz in die entsprechenden Website-Felder.
- Wähle den richtigen mame-TWINT-Store und schliesse Aktivierung und Verbindungsprüfung ab.
Verwende die unveränderten Geheimnisse aus dem Konto des Inhabers. Magento speichert geheime Felder verschlüsselt. Sende keine Geheimnisse, entschlüsselten Konfigurationen oder echten Zahlungsdaten in Support-Screenshots.
Test- und Produktivumgebung¶
Die mame-API-Umgebung und der Test-/Produktivbetrieb des TWINT-Stores sind getrennte Einstellungen. Ein TWINT-Teststore kann eine passende TWINT-Test-App benötigen. Verwende die zur Umgebung gehörende Wallet- und Händlerkonfiguration.
Der Produktivbetrieb ist die normale Händlereinrichtung. Der Zugriff auf mame Staging ist absichtlich durch die Serverkonfiguration beschränkt und wird nur für eine vereinbarte Testeinrichtung freigeschaltet. Eine Moduswahl erzeugt keinen produktiven Händlervertrag. Arbeite vor echten Kundenzahlungen die Testliste durch.