Einrichtung des Plugins

Für die Einrichtung benötigst du neben dem Plugin ein kostenloses TWINT-Portal Konto: https://portal.twint.ch

 

1. Einrichtungsassistent starten

Logge dich ins WordPress-Backend deiner Website ein und starte auf der Seite „WooCommerce > Einstellungen > TWINT“ den Einrichtungsassistenten via Klick auf den entsprechenden Button.

 

2. Wahl der Integration

Für die Einrichtung stehen zwei verschiedene Integrationen zur Verfügung, die Integration via mame und die direkte Integration.

Wenn du dich später für eine andere Integration entscheidest kannst du die Einrichtung erneut starten und die folgenden Schritte erneut ausführen.

 

Integration via mame (empfohlen)

Bei der Integration via mame erfolgt die Anbindung zu TWINT über die Server von mame. Diese Anbindung bietet gegenüber der direkten Anbindung unter anderem folgende Vorteile:

  • Abo-Zahlungen via Woo Subscriptions.
  • Speicherung von TWINT als Zahlungsmittel für künftige Zahlungen ohne Mobilgerät.
  • Beste Performance: Performance hängt nicht vom Server oder deinem Webhosting ab. Der
  • Zahlungsprozess findet auf den sicheren Servern von mame statt.
  • Weniger Rechenlast auf dem eigenen Server/Onlineshop.
  • Zahlungsprozess unabhängig von der Server-Umgebung: Weniger Plugin- und Theme-Konflikte.
  • Hohe Sicherheitsstandards für die Kommunikation mit TWINT und die Speicherung von sensiblen Daten.
  • Einfache Einrichtung.

Für die Einrichtung über diese Integration kannst du mit Absatz 3.1 fortfahren.

 

Direkte Integration via eigenem Server

Bei der direkten Integration wird deine Website direkt mit TWINT verbunden. Folgende sind die wichtigsten Unterschiede zur Integration via mame:

  • Der Zahlungsprozess findet auf deinem Server statt. 
  • Die Performance des Zahlungsprozesses hängt von der Performance deines Servers ab.
  • Die Sicherheit hängt von deiner WordPress-Installation und dem Webhosting ab. Das TWINT-Sicherheitszertifikat wird in der WordPress-Installation gespeichert.
  • Abo-Zahlungen und die Speicherung von TWINT als Zahlungsmittel für künftige Zahlungen sind nicht möglich, da die Speicherung der entsprechenden Schlüssel erhöhte Sicherheitsstandards erfordern.

Für die Einrichtung über diese Integration kannst du mit Absatz 3.2 fortfahren.

 

3.1 Integration via mame

 

Schritt 1: Lizenz eingeben

Trage im ersten Schritt den Lizenzschlüssel ein, welchen du beim Kauf des Plugins via E-Mail erhalten hast. Du findest die Lizenz ausserdem in deinem Konto bei mamedev.ch.

 

Schritt 2: API-Parameter eingeben

Um das API-Token sowie den Webhook-Key zu erhalten, kannst du dich in dein Konto bei mamedev.app einloggen.

Wenn du noch kein Konto besitzt, kannst auf der Seite mamedev.app/register ein neues Konto erstellen. Dazu benötigst du den Lizenzschlüssel (siehe Schritt 1). Alternativ kannst du in deinem Konto bei mamedev.ch einen Benutzer für mamedev.app erstellen. 

Gehe nach dem Einloggen auf die Seite „Einstellungen > API-Einstellungen“. Auf dieser Seite kannst du mittels Klick auf den Button „Neuen Schlüssel generieren“ einen neuen Webhook-Key generieren.

Auf derselben Seite unter „Api-Tokens > Api-Token hinzufügen“ kannst du ein neues Token generieren. Gib einen beliebigen Namen ein (z.B. den Namen deines Shops) und wähle im Auswahlfeld „TWINT“.

Trage nun Webhook-Key und API-Token in die entsprechenden Felder im Einrichtungsassistenten ein.

 

Schritt 3: Store hinzufügen

 

Im TWINT-Portal:

In diesem Schritt muss im TWINT-Portal ein Store hinzugefügt und mit dem Konto bei mamedev.app verknüpft werden.

Logge dich in dein TWINT-Portal Konto ein und gehe zu „Einstellungen“. Falls unter „Konten“ noch kein Bankkonto vorhanden ist, kannst du ein neues hinzufügen. Auf dieses Konto werden die Einnahmen überwiesen.

Gehe zu „HOME“ und klicke dann unter „Online-Shop“ auf „TWINT integrieren“.

Gib im nächsten Bildschirm (Basisangaben) alle erforderlichen Angaben über deinen Online-Shop an und klicke auf „Weiter“.

Im nächsten Bildschirm (Anbindung) muss „PSP (Payment Service Provider)“ und „mame“ ausgewählt werden.

Nachdem der Store hinzugefügt wurde, wird die Store UUID angezeigt. Diese wird für die nächsten Schritte benötigt.

 

Im WordPress-Backend:

Gehe zurück zum Einrichtungsassistenten im WordPress-Backend und Klicke in Schritt 3 auf den Button „Neuen Store hinzufügen“. Es öffnet sich ein neues Fenster, um den Service bei mamedev.app zu aktivieren und den TWINT-Store zu verknüpfen.

Nachdem du den Service aktiviert hast, kann das Formular „Store hinzufügen“ wie folgt ausgefüllt und abgeschickt werden:

  • Store Name: Ein beliebiger Name für die Identifizierung bei mamedev.app und im WP-Backend. Der Name wird den Kunden nicht angezeigt.
  • Öffentlicher Name: Der Name des Stores wie er Kunden angezeigt werden soll.
  • Store UUID (TWINT): Füge hier die Store UUID des Stores ein, den du soeben im TWINT-Portal erstellt hast (siehe oben).
  • Store-Logo (optional): Ein Logo in der Grösse 800px x 400px. Dieses Feld ist optional.

Klicke auf „weiter“. Wenn der Store erfolgreich hinzugefügt werden konnte, kannst du das Fenster schliessen und mit dem Einrichtungsassistenten fortfahren. Dort sollte der Store nun als Auswahl erscheinen. Wenn dies nicht der Fall ist, kannst du den Button „Stores laden“ klicken, um die Liste zu aktualisieren.

Wähle den Store aus und Klicke auf „Weiter“.

 

Einrichtung abgeschlossen

Nun muss nur noch die WooCommerce-Zahlungsart aktiviert werden und TWINT ist fertig eingerichtet.

Am besten machst du gleich eine Testzahlung. Du kannst diese direkt von der Bestellbearbeitung im WordPress-Backend wieder zurückerstatten.

 

3.2 Direkte Integration via eigenem Server

Dieser Absatz kann ausgelassen werden, wenn bereits die Integration via mame ausgeführt wurde (Absatz 3.1).

 

Schritt 1: Lizenz eingeben

Trage im ersten Schritt den Lizenzschlüssel ein, welchen du beim Kauf des Plugins via E-Mail erhalten hast. Du findest die Lizenz ausserdem in deinem Konto bei mamedev.ch.

 

Schritt 2: TWINT-Parameter eingeben

 

TWINT-Portal:

Die für diesen Schritt erforderlichen Parameter erhältst du in deinem TWINT-Portal Konto: https://portal.twint.ch

Logge dich in dein TWINT-Portal Konto ein und gehe zu „Einstellungen“. Falls unter „Konten“ noch kein Bankkonto vorhanden ist, kannst du ein neues hinzufügen. Auf dieses Konto werden die Einnahmen überwiesen.

Gehe zu „HOME“ und klicke dann unter „Online-Shop“ auf „TWINT integrieren“.

Fülle die Basisangaben aus und wähle im zweiten Schritt (Anbindung) die Integration „Shop-Plugin“ und „WordPress WooCommerce“.

Beim Hinzufügen des ersten Stores muss ausserdem ein Zertifikat erstellt werden, welches für die Einrichtung bei WooCommerce benötigt wird. Wähle unter „Zertifikat bestellen“ ein Passwort und merke es dir oder speichere es irgendwo ab. Es wird später nochmals zwingend benötigt und kann nach dem Erstellen des Zertifikats nicht mehr eingesehen werden.

Falls Sonderzeichen für das Passwort verwendet werden, dürfen nur folgende vorkommen: ~!@#%^*_+-={}[]:,./

Unter „Gutschriften-Konto“ muss noch das zuvor hinzugefügte Bankkonto ausgewählt werden.

Nach Abschluss der Registrierung wird auf der Bestätigungsseite die UUID angezeigt. Speichere diesen Wert irgendwo ab, er wird später nochmals benötigt. Um die UUID später nochmals anzuzeigen, kannst du unter „Stores“ auf den entsprechenden Store klicken.

Auf derselben Seite kann ausserdem das Zertifikat heruntergeladen werden, welches später bei den Einstellungen bei WooCommerce benötigt wird.

 

WordPress-Backend:

Gehe zurück zum Einrichtungsassistenten im WordPress-Backend und trage die soeben erhalten Store UUID, das Zertifikat-Passwort, sowie eine beliebige Kassen-ID ein (z.B. den Namen des Shops).

 

Schritt 3: Zertifikat umwandeln

Das im vorherigen Schritt heruntergeladene Zertifikat kann nun über den Button „Datei hochladen“ hochgeladen werden.

Sollte das Hochladen des Zertifikats fehlschlagen ist entweder das Passwort nicht korrekt oder das Zertifikat konnte nicht automatisch umgewandelt werden. Auf der Seite „TWINT-Zertifikat umwandeln“ findest du weitere Möglichkeiten das Zertifikat ins korrekte Format umzuwandeln.

 

Schritt 4: Kasse anmelden

Im letzen Schritt muss die virtuelle Kasse einmalig bei TWINT angemeldet werden. Dazu kannst du den Button „Registrieren“ klicken.

 

Einrichtung abgeschlossen

Nun muss nur noch die WooCommerce-Zahlungsart aktiviert werden und TWINT ist fertig eingerichtet.

Am besten machst du gleich eine Testzahlung. Du kannst diese direkt von der Bestellbearbeitung im WordPress-Backend wieder zurückerstatten.