Warenkorb Checkout

Die Shop-Erweiterung kommt mit 11 vordefinierten Checkout-Varianten. Diese sind:

• request Produkte werden über den Warenkorb lediglich angefragt. Es findet kein Warenversand o.ä. statt.
• onInvoice Produkte sollen auf Rechnung bezahlt werden. D.h. die Ware wird direkt versandt und später per Rechnung bezahlt.
• prePayment Produkte sollen per Vorauskasse bezahlt werden. D.h. es muss erst bezahlt werden, dann wird die Ware versandt.
• sepa (SEPA Lastschrift)
• payPal Die Produkte werden direkt via PayPal-Wallet bezahlt. (erfordert Pro-Version der Shop-Erweiterung)
• payPalCheckout Die Produkte werden direkt via PayPal-Checkout bezahlt. (erfordert Pro-Version der Shop-Erweiterung)
• stripe Die Produkte werden direkt via Stripe bezahlt. (erfordert Pro-Version der Shop-Erweiterung)
• klarna Die Produkte werden direkt via Klarna bezahlt. (erfordert Pro-Version der Shop-Erweiterung)
• manual (SEPA Lastschrift)
• storno Eine Bestellung wurde bestellt und es wurde eine Bestell- und Rechnungsnummer vergeben. Die Ware wurde noch nicht versandt und nicht bezahlt, und die Bestellung muss storniert werden – hieraus entsteht nun diese Storno-Bestellung. Diese Storno-Bestellung zeigt auf die ursprüngliche Bestellung und enthält alle Produkte und den gesamten Betrag.
• return Eine Bestellung wurde bestellt und es wurde eine Bestell- und Rechnungsnummer vergeben. Nun wurde die Ware geliefert und es soll ein oder mehrere Produkte zurückgeschickt werden – hieraus entsteht nun diese Retoure-Bestellung.

Achtung:

Die Bearbeitung und das Löschen eines Bestelldatensatzes ist nur im Status prepared möglich. Sobald die Bestellung den Status ordered erreicht hat und eine Rechnungsnummer erhalten hat, darf diese nicht mehr verändert werden!

Mögliche Zahlungsanbieter

Mit den oben aufgelisteten Zahlungsanbietern können folgende Zahlarten abgedeckt werden (stand 1. November 2025):

Hinweis:

Die Verfügbarkeit einzelner Zahlungsarten kann je nach Produktart, Verkaufsland oder Käuferkonto variieren. Nicht alle Zahlungsarten stehen in jedem Markt oder für jede Transaktion zur Verfügung.

Allgemeine Konfiguration

• checkoutPid Hier muss die Page-Uid für die Checkout-Seite angegeben werden.
• minimummOrderValue Hier kann der Mindestbestellwert (in Cents) angegeben werden.
• timeForPayment Hier können die verfügbaren Tage für die Zahlung angegeben werden.
• deliveryTime Hier kann ein optionaler Text für die Lieferzeit angegeben werden.
• orderOptions Hier werden die Checkout-Varianten definiert. Auf diese gehen wir in separaten Abschnitten genauer ein.
• fieldDefinition Hier werden Formular-Felder für den Checkout konfiguriert. Diese werden erst in den jeweiligen TypoScript-Knoten vorkonfiguriert und können dann in den verschiedenen Checkouts verwendet werden.

orderNumber = WS-###YEAR###-###MONTH###-%1$d

Weitere Checkout spezifische Konfigurationen findest Du auf den jeweiligen Dokumentationsseiten.

TypoScript Konfiguration Checkout Basis

plugin.tx_shop.settings.basketOrder {
    # Page-ID des Checkout
    checkoutPid = {$themes.configuration.pages.shop.checkout}
    # Minimum order value in cents
    minimumOrderValue = {$themes.configuration.extension.shop.basket.minimumOrderValue}
    # Time for payment in days default value
    timeForPayment = {$themes.configuration.extension.shop.basketOrder.timeForPayment}
    # Default string for delivery time notice in basket above the additional costs
    deliveryTime = {$themes.configuration.extension.shop.checkout.deliveryTime}
    creditorIdentifier = {$themes.configuration.extension.shop.checkout.creditorIdentifier}
    merchantName = {$themes.configuration.extension.shop.checkout.merchantName}
    orderNumber = {$themes.configuration.extension.shop.checkout.orderNumber}
    paymentSwitchInCheckout = {$themes.configuration.extension.shop.checkout.paymentSwitchInCheckout}
    defaultPayment = {$themes.configuration.extension.shop.checkout.defaultPayment}
    # VAT information depending on country and b2b/b2c
    vat {
        b2b {
            inland {
                notice = Es handelt sich um eine Inland-Lieferung an ein Unternehmen.<br />Ihre USt.-ID: %1$s
            }
            europeanUnion {
                # Parameter is VAT-ID in basket order
                notice = Es handelt sich um eine steuerbefreite innergemeinschaftliche Lieferung gem. §4 Nr. 1b UstG.<br />Unsere USt.-ID: DE 123 456 789<br />Ihre USt.-ID: %1$s
            }
            thirdCountry {
                notice = Es handelt sich um eine steuerbefreite Ausfuhrlieferung gem. §4 Nr. 1a UstG.
            }
        }
        b2c {
            inland {
                notice = Es handelt sich um eine Inland-Lieferung an eine Privatperson.
            }
            europeanUnion {
                notice = Es handelt sich um eine innergemeinschaftliche Lieferung an eine Privatperson.
            }
            thirdCountry {
                notice = Es handelt sich um eine steuerbefreite Ausfuhrlieferung gem. §4 Nr. 1a UstG.
            }
        }
    }
    orderOptions {
        # Different order options
    }
}

Zahlart-Auswahl im Checkout

Um die Zahlart noch im Checkout wechseln zu können, kann eine Zahlart-Auswahl darin aktiviert werden. Dies kann mit der TypoScript-Konstante themes.configuration.extension.shop.checkout.paymentSwitchInCheckout aktiviert werden. Hierbei werden aktuell die beiden Werte title und description aus der orderOptions Konfiguration im TypoScript genommen, um Auswahl-Beschriftung bereitzustellen. Zusätzlich kann in der TypoScript-Konstante themes.configuration.extension.shop.checkout.defaultPayment die Standard-Zahlart angegeben werden, welche zuerst ausgewählt ist wenn man den Checkout startet.

Frontend-Benutzer mit Login

Wenn ein Käufer beim Checkout bereits eingeloggt ist, so werden seine Daten aus dem Benutzer-Datensatz direkt in die Bestell-Form eingetragen. Diese sind dann readonly, da es nur eine zentrale Stelle zur Bearbeitung geben sollte.

Um dem Käufer jetzt die Möglichkeit zu geben seine Account-Daten anzupassen, kann ein Seite zum Profil-Bearbeitung mit Hilfe der EXT:modules Erweiterung integriert werden (wie man es auch aus großen Shops wie Amazon, Shopware, Shopify, Aimeos, Magento oder auch dem Presta-Shop kennt). Diese sollte bereits installiert sein, da diese eine Abhängigkeit des Shops ist. Sobald hierfür die entsprechende TypoScript-Konstante mit der Seiten-ID konfiguriert wurde, erscheit der Link. Der Konstanten-Eintrag könnte wie folgt aussehen: themes.configuration.pages.profile = 1947.

Wenn Du eine andere Erweiterung für die Profil-Bearbeitung nutzt, kein Problem. Dann setzt Du die Ziel-Seite trotzdem über die TypoScript-Konstante themes.configuration.pages.profile oder direkt über Setup-TypoScript mit bspw. plugin.tx_modules.settings.pages.profile = 1947.