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.

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

countries.preset¶

Type: int
Default: 1

Defines which country will be preselected.

plugin.tx_cart.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.

<country-code>.options.<n>¶

Type: array
Default: options.1

You can configure n different payment methods.

<country-code>.options.<n>.title¶

Type: string

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

<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.

<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.

-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.

<country-code>.options.<n>.status¶

Type: string

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

Country configuration¶

plugin.tx_cart.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.

<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.

<country-code>.options.<n>.fallBackId¶

Type: int

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

<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.

<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.

<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¶

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¶

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

<n>¶

Type: int

You can configure up to n different 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¶

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¶

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

See plugin.tx_cart.settings.showCartAction.showPartials.paymentMethodForm