Added Postfinance Checkout

Author: aschempp

docs/payment-pfc/_index.de.md

@@ -0,0 +1,34 @@
+---
+title: "Postfinance Checkout für Isotope eCommerce"
+---
+
+# PostFinance Checkout
+
+[PostFinance Checkout][website] ist eine Online-Zahlungslösung der Schweizerischen PostFinance.
+
+> Mit PostFinance Checkout erhalten Sie eine flexible und funktionsstarke Payment Service Providing Lösung für Ihren
+> Onlineshop erweiterbar mit einem Zahlungsterminal für den stationären Verkauf. Zahlungsarten, Funktionen und Terminals 
+> können gemäss Ihren Bedürfnissen konfiguriert werden.
+
+Die Lösung bietet verschiedene Zahlungsmöglichkeiten, darunter Kreditkarten (VISA, MasterCard), PostFinance Card, 
+PostFinance E-Finance und TWINT. Die Erweiterung für Isotope eCommerce unterstützt sowohl [_Checkout All-in-One_][all-in-one] als auch [_Checkout Flex_][flex].
+
+
+## Einrichtung
+
+Nach der Installation gemäss [Extension Store](https://extensions.terminal42.ch) steht die neue Zahlungsmethode im 
+Isotope Backend zur Verfügung.
+
+![Zahlungsmodul auswählen](modul.png)
+
+
+PostFinance Checkout bietet eine kostenlose Testversion, für welche man sich auf dem [Portal][portal] frei registrieren
+kann. Mit dem Testkonto kann die volle Funktionalität in Isotope eCommerce getestet werden, erst nach Vertragsabschluss
+werden tatsächliche Kosten berechnet und können echte Transaktionen durchgeführt werden.
+
+[Weiterlesen](./einrichtung/)
+
+[website]: https://www.postfinance.ch/de/unternehmen/produkte/einkassieren/onlineshop.html
+[all-in-one]: https://www.postfinance.ch/de/unternehmen/produkte/einkassieren/onlineshop/e-payment-all-in-one.html
+[flex]: https://www.postfinance.ch/de/unternehmen/produkte/einkassieren/onlineshop/e-payment-flex.html
+[portal]: https://checkout.postfinance.ch

docs/payment-pfc/configuration/_index.de.md

@@ -0,0 +1,49 @@
+---
+title: "Einrichtung"
+description: "Einrichtung von PostFinance Checkout"
+url: "einrichtung"
+weight: 100
+---
+
+PostFinance Checkout bietet eine kostenlose Testversion, für welche man sich auf der [Webseite][website] frei registrieren
+kann. Mit dem Testkonto kann die volle Funktionalität in Isotope eCommerce getestet werden, erst nach Vertragsabschluss
+werden tatsächliche Kosten berechnet und können echte Transaktionen durchgeführt werden.
+
+
+## Zahlungsmethode konfigurieren
+
+Für die Einrichtung im Isotope Backend werden folgende Zugangsdaten benötigt:
+1. Space ID
+2. User ID
+3. Api Secret (Authentication Key)
+
+![Isotope Modulkonfiguration](zugangsdaten.png)
+
+
+### Space anlegen
+
+Das PostFinance Checkout System ist so ausgelegt, dass mit demselben Benutzerkonto mehrere Shops oder andere
+Zahlungssysteme bedient werden können. Diese werden jeweils über eigene sogenannte _Spaces_ konfiguriert.
+
+Nach der Einrichtung eines Spaces ist dessen ID im Dashboards ersichtlich.
+
+![Space-ID](space-id.png)
+
+
+### Applikationsbenutzer anlegen
+
+Ausserdem benötigen wir einen Applikationsbenutzer, um Isotope Zugang zur PostFinance API zu geben.
+
+![Applikationsbenutzer anlegen](api-benutzer.png)
+
+Geben Sie dem Benutzer einen Namen der sich auf den Shop bezieht, z.B. die verwendete Domain. Danach erhalten Sie die
+Zugriffsdetails, welche im Isotope Zahlungsmodul konfiguriert werden müssen. Notieren Sie sich die **Benutzer-ID** sowie
+den **Authentication Key**.
+
+Ausserdem muss der Applikationsbenutzer eine Rolle für den Zugriff auf den entsprechenden Space erhalten. Fügen Sie
+dazu eine neue Space-Rolle hinzu.
+![Applikationsbenutzer-Rollen zuweisen](api-rollen.png)
+
+
+
+[website]: https://checkout.postfinance.ch/

docs/payment-pfc/configuration/api-benutzer.png

@@ -0,0 +1,57 @@
+---
+title: "Webhooks"
+description: "Webhooks für PostFinance Checkout"
+url: "webhooks"
+weight: 200
+---
+
+Um die Zuverlässigkeit der Zahlungsschnittstelle zu verbessern, sollten Webhooks für die 
+Verarbeitung des Zahlungsstatus konfiguriert werden.
+
+{{% notice note %}}
+**Für die Nutzung von Webhooks benötigtst du mindestens Version 1.0.0 der Erweiterung.**  
+Beachte das Webhooks nicht auf lokalen Testsystemen funktionieren, oder wenn du 
+deinen Shop mittels Passwort geschützt hast.
+{{% /notice %}}
+
+Webhooks bestehen bei Postfinance Checkout aus einer **URL** uns einem oder mehreren **Listeners**.
+Um diese einzurichten, navigiere im Portal in deinen Space und danach Links unten auf _Einstellungen_ und dann
+in den Tabs auf _Generell_. Hier findest du die beiden nötigen Punkte.
+
+![](navigation.png)
+
+
+## Webhook-URLs
+
+Als Erstes musst du die URL deines Shops konfigurieren. Gehe dazu auf _Webhook-URLs_ und lege
+einen neuen Datensatz an. Gibt einen Namen für deinen Shop und die URL zur Postsale-Schnittstelle von Isotope ein.
+Die URL beginnt mit deiner Domain, die Zahl am Ende bezieht sich auf die Datenbank-ID der Zahlungsart.
+
+{{% notice tip %}}
+Die korrekte URL wird in deinem Shop-Backend angezeigt, wenn du die Zahlungsmethode bearbeitest.
+{{% /notice %}}
+
+![](url.png)
+
+
+## Webhook-Listeners
+
+Mit der _Webhook-URL_ weis Postfinance Checkout, unter welcher URL dein Shop informiert werden kann.
+Nun müssen wir noch mitteilen, welche Informationen uns interessieren. Lege dazu einen **Webhook-Listener** an.
+
+Wähle im ersten Schritt **Transaktion** als Entität. Im nächsten Schritt musst du dann die entsprechenden Felder 
+ausfüllen. Gib dem Listener einen Namen, wähle die neue angelegte URL aus und selektiere mindestens 
+die folgende vier _Entity States_:
+- Bestätigt
+- Autorisiert
+- Abgeschlossen
+- Liefern
+
+![](listener.png)
+
+
+## Testing
+
+Leider lassen sich die Webhooks nicht direkt aus Postfinance testen. Du siehst aber, ob alles korrekt eingerichtet ist,
+wenn du eine Testbestellung durchführst. Sobald diese abgeschlossen ist, sollte im Backend-Log von Contao ein Eintrag
+beginnend mit `New post-sale request: …` zu sehen sein.