---
title: "Payment methods"
manual: "Cart"
version: "12.1"
permalink: "https://docs.typo3.org/permalink/extcode/cart:payment-methods@12.1"
source: "Administrator/Configuration/PaymentMethods/Index.rst"
rendered: "2026-11-14T23:50:30+00:00"
---

# 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 {#configuration-given-by-this-extension}

> [!IMPORTANT]
> The provided TypoScript of the extension provides the following
> configuration for the German-speaking area.

**EXT:cart/Configuration/TypoScript/setup.typoscript**

```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 {#plugin-tx-cart-settings}

-   **countries.preset**

    -   *Type:* int
    -   *Default:* 1

    Defines which country will be preselected.

### plugin.tx_cart.payments.countries {#plugin-tx-cart-payments-countries}

-   **payments.countries.\<country-code>.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.

-   **payments.countries.\<country-code>.options.\<n>**

    -   *Type:* array
    -   *Default:* options.1

    You can configure n different payment methods.

-   **payments.countries.\<country-code>.options.\<n>.title**

    -   *Type:* string

    Name of the payment method (e.g.: prepayment, cash on delivery).

-   **payments.countries.\<country-code>.options.\<n>.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.

-   **payments.countries.\<country-code>.options.\<n>.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. This is a feature
    which was introduced for the calculation of shipping costs. Nonetheless it
    can also be used for payments

    -   `-1` → The products within the shopping cart are taken. Of those products
        the tax class with the highest value is then taken as tax class for the
        calculation of the payment method costs.
    -   `-2` → The products within the shopping cart are taken. The tax for the
        payment method costs is calculated as a percentage of the tax of those
        products.

-   **payments.countries.\<country-code>.options.\<n>.status**

    -   *Type:* string

    The status that the order with this payment method should have by default.

## Country configuration {#country-configuration}

### plugin.tx_cart.payments.countries {#plugin-tx-cart-payments-countries-1}

-   **payments.countries.\<country-code>.options.\<n>.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.

-   **payments.countries.\<country-code>.options.\<n>.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.

-   **payments.countries.\<country-code>.options.\<n>.fallBackId**

    -   *Type:* int

    If the payment method is not available, the payment method with
    this ID is used.

-   **payments.countries.\<country-code>.options.\<n>.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.

-   **payments.countries.\<country-code>.options.\<n>.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.

-   **payments.countries.\<country-code>.options.\<n>.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 {#zone-configuration}

### plugin.tx_cart.payments.zones {#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.

**Can be set in e.g. EXT:sitepackage/Configuration/TypoScript/setup.typoscript**

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

-   **payments.zones.\<n>**

    -   *Type:* int

    You can configure up to n different zones.

-   **payments.zones.\<n>.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 {#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.

**Can be set in e.g. EXT:sitepackage/Configuration/TypoScript/setup.typoscript**

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

See [plugin.tx_cart.settings.showCartAction.showPartials.paymentMethodForm](https://docs.typo3.org/permalink/extcode/cart:plugin-tx-cart-settings-showcartaction-showpartials-paymentmethodform@12.1)
