1. Einstellungen bei TWINT


1.1 Shop registrieren

Logge dich auf der folgenden Seite im TWINT-Portal ein: https://portal.twint.ch

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.

1.2 Zertifikat erstellen

Für die Anbindung des Shops wird ein gültiges Zertifikat benötigt. Dieses kann unter „Einstellungen -> Zertifikat bei SwissSign bestellen“ heruntergeladen werden. Danach muss dieses ins korrekte Format umgewandelt werden.

Das heruntergeladene Zertifikat muss vom Dateityp .p12 zu .pem umgewandelt werden. Dazu stehen die folgenden drei verschiedenen Möglichkeiten zur Verfügung (es muss nur eine ausgeführt werden):

1. Automatische Konvertierung (empfohlen)

Dies ist die einfachste Variante. Wenn bei deinem Webhosting die PHP-Erweiterung OpenSSL aktiviert ist wird das Zertifikat automatisch vom Plugin in das richtige Format umgewandelt. Lade das Zertifikat dazu mittels entsprechendem Button bei den TWINT-Einstellungen bei WooCommerce hoch nachdem du das Zertifikat-Passwort eingegeben und gespeichert hast.

2. Konvertierung via Command Line

Sollte OpenSSL bei deinem Webhosting nicht aktiviert sein oder die automatische Konvertierung aus einem anderen Grund fehlschlagen, können Zertifikat und Private Key per Command Line Tool (z.B. Terminal auf dem Mac) mit OpenSSL in das korrekte format (PEM) umgewandelt werden:

openssl pkcs12 -in twint.p12 -out twint.pem -passout pass:"PASSWORD"

Ersetze twint.p12 mit dem Namen des Zertifikats und PASSWORD mit einem Passwort, um den Private Key in der PEM-Datei zu verschlüsseln. Bei der Konvertierung wird das Passwort abgefragt, welches im TWINT-Portal für das Zertifikat gesetzt wurde.

Danach kann die Datei auf eine der folgenden zwei Arten auf dem Server abgelegt werden:

  • Die umgewandelte Datei kann in „twint.txt“ umbenannt werden und mittels Upload-Button bei den TWINT-Einstellungen bei WooCommerce hochgeladen werden.
  • Die umgewandelte PEM-Datei kann direkt im Ordner/wp-content/uploads/mame_twint deiner WordPress-Installation abgelegt werden. Wichtig ist, dass das Zertifikat „twint.pem“ benannt werden muss.

3. Konvertierung mit Online-Tool

Alternativ kann zur Konvertierung ein Online-Tool wie z.B. sslshopper verwendet werden:

https://www.sslshopper.com/ssl-converter.html

Danach kann die Datei auf eine der folgenden zwei Arten auf dem Server abgelegt werden:

  • Die umgewandelte Datei kann in „twint.txt“ umbenannt werden und mittels Upload-Button bei den TWINT-Einstellungen bei WooCommerce hochgeladen werden.
  • Die umgewandelte PEM-Datei kann direkt im Ordner/wp-content/uploads/mame_twint deiner WordPress-Installation abgelegt werden. Wichtig ist, dass das Zertifikat „twint.pem“ benannt werden muss.