DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Bezahlmethoden

Die Bezahlmethoden werden über TypoScript für jeden Warenkorb definiert. Das Standard-Template bringt bereits eine Bezahlmethode (Vorkasse) mit.

Mit der Definition plugin.tx_cart.settings.allowedCountries wird die Ausgabe des Selektors im Warenkorb definiert. Durch einen eigenen SelectViewhelper können die Optionen auch übersetzt werden.

Important

Das mitgelieferte TypoScript der Erweiterung bringt eine Konfiguration und Übersetzung für den deutschsprachigen Raum mit.

Der Parameter plugin.tx_cart.settings.defaultCountry definiert welches Land vorausgewählt werden soll.

Important

Sollten für verschiedene Länder verschiedene Bezahlmethoden definiert sein, wird die Auswahl der Rechnungsadresse für die erlaubten Bezahlmethoden genutzt. Das Land der Versandadresse, auch wenn eine abweichende Lieferadresse angegeben wurde, wird nicht genutzt.

Länderkonfiguration

plugin.tx_cart {
    settings {
        allowedCountries {
            de = Deutschland
            at = Österreich
            ch = Schweiz
        }
        defaultCountry = de
    }

    payments {
        countries {
            de {
                preset = 1
                options {
                    1 {
                        title = Vorkasse
                        extra = 0.00
                        taxClassId = 1
                        status = open
                    }
                }
            }
            at < .de
            ch < .de
        }
    }
}

Property

plugin.tx_cart.payments.countries.de.preset

Data type

int

Description

Definiert welche Bezahlmethode standardmäßig gewählt wird, sofern der Nutzer noch keine ander Bezahlmethode ausgewählt hat. Sollte beim Wechsel des Rechnungslands die Bezahlmethode nicht definiert sein, wird ebenfalls die hier für das Rechnungsland definierte Zahlart ausgewählt.

Property

plugin.tx_cart.payments.countries.de.options.n

Data type

array

Description

Man kann bis zu n verschiedene Bezahlmethoden konfigurieren.

Default

options.1

Property

plugin.tx_cart.payments.countries.de.options.n.title

Data type

Text

Description

Name der Bezahlmethode (z.B.: Nachnahme).

Property

plugin.tx_cart.payments.countries.de.options.n.extra

Data type

Text

Description

Kosten für die Bezahlmethode, die dem Kunden in Rechnung gestellt werden sollen (z.B.: 1.50).

Default

0.00

Property

plugin.tx_cart.payments.countries.de.options.n.free.from

Data type

Text

Description

Wenn der Bruttopreis der Produkte größer oder gleich dem angegebenen Wert ist, ist der Preis für die Bezahlmethode 0.00.

Property

plugin.tx_cart.payments.countries.de.options.n.free.until

Data type

Text

Description

Wenn der Bruttopreis der Produkte kleiner oder gleich dem angegebenen Wert ist, ist der Preis für die Bezahlmethode 0.00.

Property

plugin.tx_cart.payments.countries.de.options.n.available.from

Data type

Text

Description

Nur wenn der Bruttopreis der Produkte größer oder gleich dem angegebenen Wert ist, ist diese Bezahlmethode verfügbar, anderfalls wird die Rückfall-Zahlmethode verwendet.

Property

plugin.tx_cart.payments.countries.de.options.n.available.until

Data type

Text

Description

Nur wenn der Bruttopreis der Produkte kleiner oder gleich dem angegebenen Wert ist, ist diese Bezahlmethode verfügbar, anderfalls wird die Rückfall-Zahlmethode verwendet.

Property

plugin.tx_cart.payments.countries.de.options.n.available.fallBackId

Data type

Text

Description

Ist die Bezahlmethode nicht verfügbar, wird die Zahlmethode mit dieser ID verwendet.

Property

plugin.tx_cart.payments.countries.de.options.n.redirects.success.url

Data type

Text

Description

Ist für die genutzte Bezahlmethode einer Bestellung die Weiterleitungs-URL konfiguriert, wird nach erfolgreicher Bestellung auf die angegebene URL weitergeleitet statt die Bestätigungsseite anzuzeigen.

Zonenkonfiguration

Sollte keine individuelle Landeskonfiguration gefunden werden, kann auch mit Zonen (zones) im TypoScript gearbeitet werden. Dies erspart jede Menge Konfigurationsarbeit, wenn in viele Länder geliefert werden soll.

plugin.tx_cart {
    payments {
        zones {
            1 {
                preset = 1
                countries = de,at,ch
                options {
                    1 {
                        title = Vorkasse
                        extra = 0.00
                        taxClassId = 1
                        status = open
                    }
                }
            }
        }
    }
}

Property

plugin.tx_cart.payments.zones.n

Data type

int

Description

Man kann bis zu n verschiedene Zonen konfigurieren.

Property

plugin.tx_cart.payments.zones.n.countries

Data type

int

Description

Liste der Länder, für die diese Konfiguration gültig ist.

Note

  • Es wird erst in der Liste der Länderkonfiguration nach einer passenden Konfiguration gesucht.
  • Es wird dann die Liste der Zonenkonfigurationen durchgesehen. Die erste passende Konfiguration wird genutzt.

Bezahlmethoden deaktivieren

Im Moment erlaubt es die Verarbeitung nicht ganz auf die Bezahlmethoden zu verzichten. Eine Bezahlmethoden muss immer angegeben sein. Wenn es lediglich eine Bezahlmethode gibt, kann der Auswahlblock ausblendet werden.

plugin.tx_cart {
     settings {
         showCartAction {
             showPartials {
                paymentMethodForm = false
             }
         }
     }
}

Property

plugin.tx_cart.settings.showCartAction.showPartials.paymentMethodForm

Data type

boolean

Description

Aktiviert/Deaktiviert die Darstellung und Auswahl der konfigurierten Bezahlmethoden im Warenkorb.

Default

true