Einrichtung der TWINT-Integration


Die TWINT-Integration ermöglicht es, den QR-Code auf der Rechnung mit einer TWINT-App zu scannen un zu bezahlen. Zusätzlich kann oberhalb des Zahlungsteils ein Link angebracht werden, um TWINT-Zahlungen im Browser zu ermöglichen. Dies ist vor allem hilfreich, wenn der Benutzer die Rechnung auf dem Mobilgerät öffnet und dadurch nicht mit der TWINT-App scannen kann.

Für die TWINT-Integration wird folgendes benötigt:

  • Kostenloses Konto für das TWINT-Portal: https://portal.twint.ch
  • Gültige „QR-Bill for WooCommerce“ Plugin-Lizenz.

 

1. Einstellungen im TWINT-Portal

Logge dich in dein Konto im TWINT-Portal unter https://portal.twint.ch ein.

Für die Integration von TWINT können im Portal zwei Stores hinzugefügt werden:

  1. Ein Store für die Zahlung via QR-Code der Rechnung.
  2. Ein Store für die Zahlung via Link auf der Rechnung (optional).

 

1.1 Store für die Zahlung via QR-Code der Rechnung

Klicke im Home-Bildschirm unter „Kasse oder Zahlterminal“ auf den Button „TWINT integrieren“.

Wichtig: Für diesen Store darf nicht „Online-Shop“ ausgewählt werden.

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

Im nächsten Bildschirm (Anbindung) muss unter „Hersteller“ und „Vertrieb und Support“ jeweils „mame“ ausgewählt werden.

Nachdem der Store hinzugefügt wurde, wird die Store UUID angezeigt. Diese wird in Schritt 2 benötigt.

 

1.2 Store für die Zahlung via Link

Klicke im Home-Bildschirm unter „Online-Shop“ auf den Button „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 in der mame App benötigt wird.

 

2. Aktivierung des Services in der mame App

Logge dich in dein Konto bei mamedev.app ein. Den Benutzernamen und das Passwort für mamedev.app findest du in deinem Konto bei mamedev.ch. Alternativ kannst du das Registrierungsformular unter mamedev.app/register ausfüllen.

Gehe auf die Seite „Applikationen > QR-Rechnung > TWINT-Integration > Einstellungen“, um die Einrichtung zu starten.

2.1 Zahlungsart

Im ersten Schritt muss eine Zahlungsart hinzugefügt werden, um den Service zu aktivieren. Der Service kann jederzeit gestoppt werden.

2.2 Store hinzufügen

Im nächsten Schritt werden die Angaben für den Shop benötigt für welchen die Integration erfolgen soll.

  • Im Feld „QR-Bill Store UUID (TWINT)“ muss die UUID des Stores von Schritt 1.1 eingegeben werden.
  • Die Notification URL ist die URL für die JSON REST API der WordPress-Seite. Normalerweise ist diese zusammengesetzt aus Seiten-URL und der Endung „/wp-json“.

 

Optional: Wenn auf QR-Rechnungen ein Link erscheinen soll für Zahlungen via TWINT im Browser, kann das Toggle „TWINT-Zahlungslink zu QR-Rechnungen hinzufügen?“ aktiviert werden:

  • Unter „QR-Bill Zahlungslink Store UUID (TWINT)“ muss die UUID aus Schritt 1.2 eingefügt werden.
  • Die Zertifikat-Datei wurde ebenfalls in Schritt 1.2 heruntergeladen und kann danach im TWINT-Portal unter „Einstellungen“ heruntergeladen werden.
  • Das Zertifikat-Passwort wurde entweder in Schritt 1.2 gesetzt oder zu einem früheren Zeitpunkt, wenn im TWINT-Portal bereits zuvor ein Store hinzugefügt wurde.
  • Das Shop-Logo (optional) wird auf der Zahlungsseite angezeigt und muss die Abmessungen 800 (Breite) x 400 (Höhe) Pixel haben.

 

3. API-Zugangsdaten

Nun muss das Plugin mit deinem Account bei mamedev.app verbunden werden.

Gehe dazu auf die Seite „Einstellungen (Zahnrad oben rechts) > API-Einstellungen“. Auf dieser Seite kannst du über den Button „Neuen Schlüssel generieren“ einen neuen Webhook-Key generieren.

Auf der gleichen Seite kann unter „API-Tokens > API-Token hinzufügen“ ein neues Token generiert werden. Gib einen beliebigen Namen ein (z. B. den Namen deines Shops) und wähle im Auswahlfeld „TWINT“ aus. Bitte speichere das Token, da es nur einmal angezeigt wird und im Nachhinein nicht mehr abgerufen werden kann.

 

4. Einstellungen im WordPress-Backend

Logge dich ins WordPress-Backend deiner Website ein und rufe die Seite „QR-Rechnung > Einstellungen“ auf. Trage auf dieser Seite das API-Token und den Webhook-Key aus Schritt 3 ein und speichere anschliessend die Einstellungen.

Aktiviere anschliessen die Checkbox „TWINT aktivieren“ und klicke unter „TWINT > Store-ID“ auf „Synchronisieren“, um den Store zu laden, den du in deinem Account bei mamedev.app hinzugefügt hast. Wähle den Store aus und speichere die Einstellungen, um die Einrichtung abzuschliessen.