Skip to content

Commit 7d23eee

Browse files
aschemppaschempp
committed
Added Postfinance Checkout
1 parent 1e374b9 commit 7d23eee

File tree

15 files changed

+158
-0
lines changed

15 files changed

+158
-0
lines changed

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

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
title: "Postfinance Checkout für Isotope eCommerce"
3+
---
4+
5+
# PostFinance Checkout
6+
7+
[PostFinance Checkout][website] ist eine Online-Zahlungslösung der Schweizerischen PostFinance.
8+
9+
> Mit PostFinance Checkout erhalten Sie eine flexible und funktionsstarke Payment Service Providing Lösung für Ihren
10+
> Onlineshop erweiterbar mit einem Zahlungsterminal für den stationären Verkauf. Zahlungsarten, Funktionen und Terminals
11+
> können gemäss Ihren Bedürfnissen konfiguriert werden.
12+
13+
Die Lösung bietet verschiedene Zahlungsmöglichkeiten, darunter Kreditkarten (VISA, MasterCard), PostFinance Card,
14+
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].
15+
16+
17+
## Einrichtung
18+
19+
Nach der Installation gemäss [Extension Store](https://extensions.terminal42.ch) steht die neue Zahlungsmethode im
20+
Isotope Backend zur Verfügung.
21+
22+
![Zahlungsmodul auswählen](modul.png)
23+
24+
25+
PostFinance Checkout bietet eine kostenlose Testversion, für welche man sich auf dem [Portal][portal] frei registrieren
26+
kann. Mit dem Testkonto kann die volle Funktionalität in Isotope eCommerce getestet werden, erst nach Vertragsabschluss
27+
werden tatsächliche Kosten berechnet und können echte Transaktionen durchgeführt werden.
28+
29+
[Weiterlesen](./einrichtung/)
30+
31+
[website]: https://www.postfinance.ch/de/unternehmen/produkte/einkassieren/onlineshop.html
32+
[all-in-one]: https://www.postfinance.ch/de/unternehmen/produkte/einkassieren/onlineshop/e-payment-all-in-one.html
33+
[flex]: https://www.postfinance.ch/de/unternehmen/produkte/einkassieren/onlineshop/e-payment-flex.html
34+
[portal]: https://checkout.postfinance.ch

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

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
---
2+
title: "Einrichtung"
3+
description: "Einrichtung von PostFinance Checkout"
4+
url: "einrichtung"
5+
weight: 100
6+
---
7+
8+
PostFinance Checkout bietet eine kostenlose Testversion, für welche man sich auf der [Webseite][website] frei registrieren
9+
kann. Mit dem Testkonto kann die volle Funktionalität in Isotope eCommerce getestet werden, erst nach Vertragsabschluss
10+
werden tatsächliche Kosten berechnet und können echte Transaktionen durchgeführt werden.
11+
12+
13+
## Zahlungsmethode konfigurieren
14+
15+
Für die Einrichtung im Isotope Backend werden folgende Zugangsdaten benötigt:
16+
1. Space ID
17+
2. User ID
18+
3. Api Secret (Authentication Key)
19+
20+
![Isotope Modulkonfiguration](zugangsdaten.png)
21+
22+
23+
### Space anlegen
24+
25+
Das PostFinance Checkout System ist so ausgelegt, dass mit demselben Benutzerkonto mehrere Shops oder andere
26+
Zahlungssysteme bedient werden können. Diese werden jeweils über eigene sogenannte _Spaces_ konfiguriert.
27+
28+
Nach der Einrichtung eines Spaces ist dessen ID im Dashboards ersichtlich.
29+
30+
![Space-ID](space-id.png)
31+
32+
33+
### Applikationsbenutzer anlegen
34+
35+
Ausserdem benötigen wir einen Applikationsbenutzer, um Isotope Zugang zur PostFinance API zu geben.
36+
37+
![Applikationsbenutzer anlegen](api-benutzer.png)
38+
39+
Geben Sie dem Benutzer einen Namen der sich auf den Shop bezieht, z.B. die verwendete Domain. Danach erhalten Sie die
40+
Zugriffsdetails, welche im Isotope Zahlungsmodul konfiguriert werden müssen. Notieren Sie sich die **Benutzer-ID** sowie
41+
den **Authentication Key**.
42+
43+
Ausserdem muss der Applikationsbenutzer eine Rolle für den Zugriff auf den entsprechenden Space erhalten. Fügen Sie
44+
dazu eine neue Space-Rolle hinzu.
45+
![Applikationsbenutzer-Rollen zuweisen](api-rollen.png)
46+
47+
48+
49+
[website]: https://checkout.postfinance.ch/

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

154 KB
Loading

‎docs/payment-pfc/configuration/api-rollen.png

44.2 KB
Loading

‎docs/payment-pfc/configuration/space-id.png

84.6 KB
Loading

‎docs/payment-pfc/configuration/zugangsdaten.png

58.8 KB
Loading

‎docs/payment-pfc/modul.png

162 KB
Loading

‎docs/payment-pfc/webhooks/_index.de.md

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
---
2+
title: "Webhooks"
3+
description: "Webhooks für PostFinance Checkout"
4+
url: "webhooks"
5+
weight: 200
6+
---
7+
8+
Um die Zuverlässigkeit der Zahlungsschnittstelle zu verbessern, sollten Webhooks für die
9+
Verarbeitung des Zahlungsstatus konfiguriert werden.
10+
11+
{{% notice note %}}
12+
Beachte das Webhooks nicht auf lokalen Testsystemen funktionieren, oder wenn du
13+
deinen Shop mittels .htaccess-Passwort geschützt hast.
14+
{{% /notice %}}
15+
16+
Webhooks bestehen bei Postfinance Checkout aus einer **URL** uns einem oder mehreren **Listeners**.
17+
Um diese einzurichten, navigiere im Portal in deinen Space und danach Links unten auf _Einstellungen_ und dann
18+
in den Tabs auf _Generell_. Hier findest du die beiden nötigen Punkte.
19+
20+
![](navigation.png)
21+
22+
23+
## Webhook-URLs
24+
25+
Als Erstes musst du die URL deines Shops konfigurieren. Gehe dazu auf _Webhook-URLs_ und lege
26+
einen neuen Datensatz an. Gibt einen Namen für deinen Shop und die URL zur Postsale-Schnittstelle von Isotope ein.
27+
Die URL beginnt mit deiner Domain, die Zahl am Ende bezieht sich auf die Datenbank-ID der Zahlungsart.
28+
29+
{{% notice tip %}}
30+
Die korrekte URL wird in deinem Shop-Backend angezeigt, wenn du die Zahlungsmethode bearbeitest.
31+
{{% /notice %}}
32+
33+
![](url.png)
34+
35+
36+
## Webhook-Listeners
37+
38+
Mit der _Webhook-URL_ weis Postfinance Checkout, unter welcher URL dein Shop informiert werden kann.
39+
Nun müssen wir noch mitteilen, welche Informationen uns interessieren. Lege dazu einen **Webhook-Listener** an.
40+
41+
Wähle im ersten Schritt **Transaktion** als Entität. Im nächsten Schritt musst du dann die entsprechenden Felder
42+
ausfüllen. Gib dem Listener einen Namen, wähle die neue angelegte URL aus und selektiere mindestens
43+
die folgende vier _Entity States_:
44+
- Bestätigt
45+
- Autorisiert
46+
- Abgeschlossen
47+
- Liefern
48+
49+
![](listener.png)
50+
51+
52+
## Testing
53+
54+
Leider lassen sich die Webhooks nicht direkt aus Postfinance testen. Du siehst aber, ob alles korrekt eingerichtet ist,
55+
wenn du eine Testbestellung durchführst. Sobald diese abgeschlossen ist, sollte im Backend-Log von Contao ein Eintrag
56+
beginnend mit `New post-sale request: …` zu sehen sein.

‎docs/payment-pfc/webhooks/listener.png

57.3 KB
Loading

‎docs/payment-pfc/webhooks/navigation.png

54 KB
Loading

‎docs/payment-pfc/webhooks/url.png

20.1 KB
Loading

‎page/config/payment-pfc/config.yml

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
contentDir: '../docs/payment-pfc'
2+
title: 'PostFinance Checkout'
3+
defaultContentLanguageInSubdir: true
4+
DefaultContentLanguage: de
5+
6+
menu:
7+
shortcuts:
8+
-
9+
name: "<i class='fas fa-shopping-cart'></i> Extension Store"
10+
identifier: "ds"
11+
url: "https://extensions.terminal42.ch/p/payment-pfc"
12+
weight: 10

‎page/config/payment-pfc/languages.yml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
de:
2+
languageName: Deutsch
3+
weight: 1

‎page/config/payment-pfc/params.yml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
DocumentationTitleDe: PostFinance Checkout
2+
extensionPermalink: https://extensions.terminal42.ch/p/payment-pfc
3+
extensionIcon: payment-pfc.svg

‎page/static/images/logos/payment-pfc.svg

Lines changed: 1 addition & 0 deletions
Loading

0 commit comments

Comments
 (0)