Zum Inhalt

PostPay — Österreichische Post PostPay

Extension for Magento 2

Bedienungsanleitung

CopeX GmbH
Web: https://copex.io
Email: office@copex.io

Inhaltsverzeichnis

Abschnitt Seite
1 Voraussetzungen 2
2 Konfiguration 2
2.1 PostPay-Einstellungen 2
3 Funktionen 3
3.1 PostPay als Zahlungsmethode im Checkout 3
3.2 Zahlungsanweisungen für Kunden 4
3.3 PostPay Refund 4
4 Einschränkungen 5
5 Fehlerbehandlung 5

1 Voraussetzungen

  • Magento 2.3 oder höher (kompatibel mit 2.4)
  • PHP 8.1 oder höher
  • Aktiver PostPay-Vertrag mit der Österreichischen Post
  • Empfohlen: CopeX PLC-Modul für automatische PostPay-Rückerstattungen

2 Konfiguration

Die Konfiguration des Moduls finden Sie im Magento 2 Backend unter Shops > Konfiguration > Verkauf > Zahlungsmethoden > Post.at PostPay.

Konfiguration

2.1 PostPay-Einstellungen

Navigieren Sie zu Shops > Konfiguration > Verkauf > Zahlungsmethoden > Post.at PostPay.

  • Aktiviert — Schaltet PostPay als Zahlungsmethode im Checkout ein oder aus (Ja / Nein).
  • Titel — Name der Zahlungsmethode, der im Checkout und in der Bestellübersicht angezeigt wird. Standard: Post Pay.
  • Neuer Bestellstatus — Bestellstatus, der nach der Bestellaufgabe mit PostPay gesetzt wird (z.B. Ausstehend).
  • Sortierung — Reihenfolge der Zahlungsmethode im Checkout. Niedrigere Zahlen werden zuerst angezeigt.
  • PostPay Refund — Informationsblock zur PostPay Rückerstattungsfunktion. Die eigentliche Konfiguration der Rückerstattung erfolgt im CopeX PLC-Modul unter Shops > Konfiguration > Verkauf > Liefermethoden > PostPay Refund.

3 Funktionen

3.1 PostPay als Zahlungsmethode im Checkout

Nach der Aktivierung erscheint PostPay im Checkout als wählbare Zahlungsmethode. PostPay ist eine Offline-Zahlungsmethode — die eigentliche Zahlungsabwicklung erfolgt direkt zwischen dem Kunden und der Österreichischen Post, nicht über ein Online-Gateway.

Verfügbarkeit des PostPay-Payments:

PostPay ist ausschließlich unter folgenden Bedingungen verfügbar:

Bedingung Wert
Land Nur Österreich (AT)
Währung Nur Euro (EUR)
Maximaler Bestellwert 3.000 EUR
Virtuelle Produkte Nicht verfügbar (nur physische Produkte)

Diese Einschränkungen sind fest kodiert und können nicht über die Konfiguration geändert werden.

Ablauf:

  1. Kunde wählt PostPay im Checkout als Zahlungsmethode.
  2. Bestellung wird mit dem konfigurierten Anfangsstatus angelegt.
  3. Händler erstellt Versandlabel (empfohlen: CopeX PLC-Modul).
  4. Paket wird mit PostPay-Sendung verschickt.
  5. Österreichische Post zieht den Betrag beim Kunden nach Lieferung ein.
  6. Händler erhält die Zahlung von der Österreichischen Post.

3.2 Zahlungsanweisungen für Kunden

Das Modul zeigt dem Kunden abhängig vom Bestellstatus passende Zahlungsanweisungen:

Bestellstatus Angezeigte Information
Standardzustand Informationstext zu PostPay und Hinweis, dass die Zahlung nach Lieferung erfolgt
Storniert Hinweis, dass die Bestellung storniert wurde
Rechnung erstellt Hinweis auf die Zahlung nach Sendungserhalt
Gutschrift erstellt Hinweis auf die laufende Rückerstattung

3.3 PostPay Refund

Wenn sowohl das PostPay-Modul als auch das CopeX PLC-Modul installiert sind, können Rückerstattungen automatisch über die PostPay-API abgewickelt werden.

Voraussetzungen: - CopeX PLC-Modul installiert und konfiguriert - PostPay API Key und API Secret in den PLC-Einstellungen hinterlegt

Ablauf: 1. Händler erstellt eine Gutschrift (Kreditnotiz) in Magento für eine PostPay-Bestellung. 2. Das PLC-Modul sendet automatisch eine Rückerstattungsanfrage an die PostPay-API. 3. Bei Erfolg wird ein Bestellkommentar hinzugefügt. 4. Bei Fehler wird die Gutschrift nicht gespeichert und eine Fehlermeldung angezeigt.

Die Konfiguration von PostPay Refund (API Key, API Secret) erfolgt im CopeX PLC-Modul unter Shops > Konfiguration > Verkauf > Liefermethoden > PostPay Refund.

4 Einschränkungen

  • PostPay ist ausschließlich für österreichische Lieferadressen verfügbar.
  • Nur Euro-Bestellungen werden unterstützt.
  • Warenkörbe mit rein virtuellen Produkten sind nicht berechtigt.
  • Der maximale Bestellwert ist auf 3.000 EUR begrenzt.

5 Fehlerbehandlung

  • PostPay erscheint nicht im Checkout — Prüfen Sie, ob das Modul aktiviert ist. Stellen Sie sicher, dass die Lieferadresse in Österreich liegt und die Bestellwährung Euro ist. Virtuelle Produkte im Warenkorb verhindern die Anzeige.

  • PostPay Refund fehlgeschlagen — Prüfen Sie die PostPay API-Zugangsdaten im CopeX PLC-Modul unter Shops > Konfiguration > Verkauf > Liefermethoden > PostPay Refund. Stellen Sie sicher, dass die PLC-Bestellnummer für diese Bestellung vorhanden ist.

  • Admin-Benachrichtigung "CopeX PLC nicht installiert" — Wenn das PLC-Modul nicht installiert ist, erscheint täglich eine Admin-Benachrichtigung. Diese Benachrichtigung weist darauf hin, dass PostPay Refund nicht verfügbar ist. Installieren Sie das CopeX PLC-Modul, um die Benachrichtigung zu deaktivieren.

Lizenz

Proprietär — CopeX GmbH. Eine Lizenz pro produktiver Magento-Instanz. Test- und Entwicklungsumgebungen benötigen keine zusätzliche Lizenz.