.. include:: ../../../Includes.txt .. _payment_methods: =============== Payment methods =============== The payment methods are defined via TypoScript for each shopping cart. The standard template already includes a payment method (prepayment) as shown below. With the definition `plugin.tx_cart.settings.allowedCountries` the output of the selector in the shopping cart is defined. The options can also be translated by an own `SelectViewhelper`. .. important:: If different payment methods are defined for different countries, the selection of the invoice address is used for the permitted payment methods. The country of the shipping address, even if a different shipping address was specified, is not used. Configuration given by this extension ===================================== .. important:: The provided TypoScript of the extension provides the following configuration for the German-speaking area. .. code-block:: typoscript :caption: EXT:cart/Configuration/TypoScript/setup.typoscript plugin.tx_cart { settings { countries { preset = 1 options { 1 { code = de label = Deutschland } 2 { code = at label = Österreich } 3 { code = ch label = Schweiz } } } } payments { countries { de { preset = 1 options { 1 { title = Vorkasse extra = 0.00 taxClassId = 1 status = open } } } at < .de ch < .de } } } plugin.tx_cart.settings ----------------------- The parameter `plugin.tx_cart.settings.countries.preset` .. confval:: countries.preset :Type: int :Default: 1 Defines which country will be preselected. plugin.tx_cart.payments.countries --------------------------------- .. confval:: .preset :Type: int Defines which payment method is selected by default if the user has not yet selected a different payment method. If the payment method is not defined when changing the country of account, the payment method defined here for the country of invoice will also be selected. .. confval:: .options. :Type: array :Default: options.1 You can configure n different payment methods. .. confval:: .options..title :Type: string Name of the payment method (e.g.: prepayment, cash on delivery). .. confval:: .options..extra :Type: float :Default: 0.00 Costs for the payment method to be billed to the customer (for example, 1.50). The currency depends on the standard configuration. .. confval:: .options..taxClassId :Type: int ID of the tax class for this payment method. The taxClassId must either be assignable to a defined tax class. However, the values `-1` and `-2` are also allowed here. * `-1` → The tax class for the calculation is based on the largest tax class of the products in the shopping cart. * `-2` → The taxes are calculated as a percentage of the tax of the products in the shopping cart. .. confval:: .options..status :Type: string The status that the order with this payment method should have by default. Country configuration ===================== plugin.tx_cart.payments.countries --------------------------------- .. confval:: .options..free.from :Type: float If the gross price of the products is greater than or equal to the specified value, the price for the payment method is 0.00. .. confval:: .options..free.until :Type: float If the gross price of the products is less than or equal to the specified value, the price for the payment method is 0.00. .. confval:: .options..fallBackId :Type: int If the payment method is not available, the payment method with this ID is used. .. confval:: .options..available.from :Type: float This payment method is only available if the gross price of the products is greater than or equal to the specified value, otherwise the fallback payment method is used. .. confval:: .options..available.until :Type: float This payment method is only available if the gross price of the products is less than or equal to the specified value, otherwise the fallback payment method is used. .. confval:: .options..redirects.success.url :Type: string If the redirect URL is configured for the payment method used for an order, the system redirects to the specified URL after a successful order instead of displaying the confirmation page. Zone configuration ================== plugin.tx_cart.payments.zones ----------------------------- If no individual country configuration can be found, it is also possible to work with zones in the TypoScript. This saves a lot of configuration work if you want to deliver to many countries. .. code-block:: typoscript :caption: Can be set in e.g. EXT:sitepackage/Configuration/TypoScript/setup.typoscript plugin.tx_cart { payments { zones { 1 { preset = 1 countries = de,at,ch options { 1 { title = Vorkasse extra = 0.00 taxClassId = 1 status = open } } } } } } .. confval:: :Type: int You can configure up to n different zones. .. confval:: .countries :Type: int List of countries for which this configuration is valid. .. NOTE:: * The system first searches for a suitable configuration in the list of country configurations. * The list of zone configurations is then looked through. The first matching configuration is used. Deactivate payment methods ========================== At the moment, the existence of a payment method is required for the processing of an order. That means that at least one payment method must be specified. In this case the selection block for the payment can be hidden. .. code-block:: typoscript :caption: Can be set in e.g. EXT:sitepackage/Configuration/TypoScript/setup.typoscript plugin.tx_cart { settings { showCartAction { showPartials { paymentMethodForm = false } } } } See :ref:`plugin.tx_cart.settings.showCartAction.showPartials.paymentMethodForm `