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.
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.
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.
plugin.tx_cart {
settings {
showCartAction {
showPartials {
paymentMethodForm = false
}
}
}
}
See plugin.tx_cart.settings.showCartAction.showPartials.paymentMethodForm