When you add an extra field with select or toggleButtonGroup type, you can add a surcharge to their options — the cart total will be increased when an option is chosen.
Extra field attributes for a surcharge
Field
Type
Description
surchargeType
string
This attribute allows setting surcharge as a fixed sum to the cart total or a percentage sum depending on the cart total. Accepts ABSOLUTE and PERCENT values.
surchargeShortName
<surchargeShortName>
Surcharge name in the cart details section (where subtotal, discount, total, etc values are shown). If this attribute is not specified, the default !Surcharge.default_text! name will be shown on the cart details section
Surcharge attribute can be specified in each object inside options array. If the extra field surchargeType is ABSOLUTE, Ecwid will add a fixed sum to the order total specified in the surcharge attribute. If the extra field surchargeType is PERCENT, Ecwid will calculate the sum for a surcharge based on the order total and percentage value specified in the surcharge attribute.
showZeroSurchargeInTotal
boolean
If not specified, the default value is true. If true, the surcharge name and its 0 value will be shown on the cart details section (if the surcharge attribute is set to 0 or not specified inside the options array). If false, 0 surcharge name and its value won't be shown on the cart details section.
surchargeTaxable
boolean
Defines if taxes should be applied to the surcharge.
surchargeShortName
Field
Type
Description
name
string
Surcharge's names shown on the cart details section
showSurchargePercentValue
boolean
Applicable to the extra fields with the PERCENT surchargeType. If true, the surcharge percentage value (e.g. 50%) will be shown next to the name in the cart details. If false, nothing will be shown
nameTranslated
obj
Keeps the translations for the surcharge name on the cart details section. More on translations here: Translate extra fields