---
title: "Magento Plugin WawiPay"
canonical: "https://doc.wawi.ch/space/DOCPL/3703898311/Magento%20Plugin%20WawiPay"
format: markdown
---
---

# Funktionen

:check_mark: Mehrwährungsfähigkeit  
:cross_mark: Zahlungsmittel Logos im Checkout  
:check_mark: Warenkorb Übertragung  
:check_mark: Webhook Fähigkeit  
:cross_mark: Look & Feel Einstellung  
:check_mark: Individuelle Zahlungsmittel Konfiguration  
:cross_mark: Abonnement Support

# Voraussetzung

- Magento 2.2.x - 2.4.x

# Konfiguration WawiPay

Unter [login.wawipay.com](https://login.wawipay.com/) anmelden.

> ℹ️ Wenn WawiPay durch uns eingerichtet wurde, sind die Zugangsdaten im [KIS-Kundencenter](https://login.wawi.ch/) im Tab «Module» ersichtlich.

# Einrichten des Magento 2 Plugins

- In der WawiPay Administration zu ** «API & Integration»** navigieren. Anschliessend den Magento 2 Shop hinzufügen.

![image](media://2249b475-e05e-49ee-96e2-8d0af5866cdc)

- Nach dem Klick auf **«Hinzufügen»** öffnet sich die Konfiguration der API-Integration. Unter **«Shop Adresse eingeben» **(1) muss die URL zum Shop eintragen werden. In dieser Ansicht sind ebenfalls der** «API-Schlüssel»** (2) sowie der **«Instanznamen» **(3) welcher zur Konfiguration des Plugin Seitens Magento 2 benötigt wird ersichtlich.

![image](media://d6e6e061-ff58-4fb0-9d27-573ebdd7e3c2)


> ⚠️ **Bitte beachten:**
> ⚠️ 
> ⚠️ - Die Shop URL muss komplett und korrekt eingetragen werden. Unterschiede wie **https://www. **oder nur **https://** können bei Missachtung zu Webhook Fehler führen.
> ⚠️ - Der API-Schlüssel soll **geheim **gehalten werden. Bei Verlust oder ungewollter Veröffentlichung, kann dieser auf WawiPay in der Konfiguration der Integration neu generiert werden.

# Installation Magento 2

- WawiPay Payment Gateway als ZIP Datei herunterladen.
- Das Verzeichnis **/app/ **öffnen, welches sich unter der **Magento-Root-Installation **befindet.
- Die Ordnerstruktur **code/WawiPay/PaymentGateway/** im **app**-Ordner **erstellen**.
- Die heruntergeladene Zip-Datei in den gerade erstellten Ordner **PaymentGateway **entpacken.

![image](media://f487ee40-1be6-47da-a69e-b254b5bd119e)

## Vorbereitung

- Dieses Plugin benötigt die **«WawiPay API library for PHP»**.
- Sollte der Composer noch nicht genutzt werden, ist dieser gemäss Installationsanleitung zu installieren: [http://getcomposer.org/download/](http://getcomposer.org/download/)
- Folgenden Befehl im Magento Root Verzeichnis eingeben:

```
$ composer require WawiPay/WawiPay
```

> ℹ️ Sollte der Composer ein Login verlangen, ist folgendermassen vorzugehen: [https://elink.ch/keymag2](https://elink.ch/keymag2)

- Sollten während der Benutzung des Composers, Probleme mit dem einloggen bei [http://repo.magento.com](http://repo.magento.com) auftreten, ist die Datei **auth.json.sample **zu **auth.json **umzubenennen. Die Datei befindet sich im Magento Root Verzeichnis.

![image](media://845329be-2ab5-43cb-94da-48a0414c445e)

- Die Datei mit einem Editor öffnen, und den Public- sowie Private-Key in **auth.json** einfügen.
- So erhalten Sie die Keys:
  - Einloggen unter folgendem Link: [https://marketplace.magento.com/](https://marketplace.magento.com/)
  - Oben rechts auf den Konto-Namen klicken
  - **«My Profile»** anwählen
  - Auf **«Access Keys»** im Marketplace Tab klicken

## Magento 2 Setup

- Im Magento Administrations-Panel einloggen.
- Auf** «SYSTEM»** → **«Web Setup Wizard» **klicken.

![image](media://e5c36a53-a7e8-4737-bd4e-2852edd3efaa)

- Um fortzufahren, **«Module Manager»** auswählen

![image](media://6f201641-0521-44d0-a026-5f16424ab0bd)

- **«WawiPay_PaymentGateway»** suchen, und über Dropdown Menü auf **«Aktivieren/Enable»** setzen

![image](media://195d399f-9054-4778-9387-4a0425976db4)

- Folgende Schritte ausführen
  - Bereitschaftsprüfung
  - Erstellen der Sicherung
  - Modul aktivieren

> ⚠️ Warten bis der Prozess abgeschlossen ist.

#### Alternativ können die Erweiterung auch über die Command line aktiviert werden

- Ins Root Verzeichnis von Magento gehen, und folgende Befehle ausführen:

```
$ bin/magento setup:upgrade

$ bin/magento setup:di:compile

$ bin/magento cache:clean
```

> ⚠️ Warten bis der Prozess abgeschlossen ist.

## Konfiguration - Magento

- Im Magento Administrations-Panel anmelden.
- Zu **«Stores»** → **«Configuration» **→ **«Sales»** → **«Payment methods»**.

![image](media://0ab791b1-371d-403d-be5a-1200ebda1b75)

- Unter **«other payment methods»**,** «WawiPay» **auswählen.
- Zum Konfigurieren der WawiPay-Modulkonfiguration, den **«Instanznamen»** und die **«API Secret»**, welche beide in diesem Artikel im Schritt [Konfiguration WawiPay](https://photografix.atlassian.net/wiki/spaces/DOCPL/pages/3703898311/Magento+Plugin+WawiPay#Konfiguration-WawiPay) erstellt wurden.