> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# actions - Basket & checkout

> Shop actions during basket and checkout: messages and email templates for item updates, order completion and guest registrations.

export const TextbausteinHinweis = () => <>
    Dieser Text wird über einen Textbaustein realisiert.<br />
    Alles zu Textbausteinen in Konfigurationen finden Sie{" "}
    <a href="https://dokumentation.websale.de/konfiguration#verwendung-von-textbausteinen-in-konfigurationen">hier</a>.
  </>;

This page contains all actions executed during the ordering process in the shop.<br />Here you will find the associated messages and email templates used when adding, removing or updating items as well as when completing an order or during guest registration.

## Overview of actions

The actions listed here are **grouped thematically** to provide a clear overview of the associated error messages and email templates.

Actions that thematically belong to a different area can be found in the corresponding sections of this documentation or in the [alphabetical overview of actions](/en/konfiguration/actions-fehlertexte-e-mails/actions-alphabetische-ubersicht).

#### Excerpt of the basic `actions` structure

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
    "actions": {
      ...
      "basketItemAdd": {...},
      "basketItemDelete": {...},
      "basketItemUpdate": {...},
      "checkoutAccountTypeSelect": {...},
      "checkoutBillAddressSelect": {...},
      "checkoutConfirm": {...},
      "checkoutPaymentUpdate": {...},
      "checkoutPseudoCCSelect": {...},
      "checkoutSetFreeFields": {...},
      "checkoutSetGuestEmail": {...},
      "checkoutShippingAddressSelect": {...},
      "checkoutShippingMethodUpdate": {...},
      "checkoutUseDifferentShippingAddress": {...},
      "guestRegister": {...},
      "directOrder": {...},
      "voucherAdd": {...},
      "voucherDelete": {...},
      "inventoryReserve": {...},
      ...
    }
}
```

#### Action overview

| **Action**                      | **Description**                                                                        |
| ------------------------------- | -------------------------------------------------------------------------------------- |
| `basketItemAdd`                 | Defines error messages when adding an item to the basket.                              |
| `basketItemDelete`              | Defines error messages when removing an item from the basket.                          |
| `basketItemUpdate`              | Defines error messages when changing a basket line item.                               |
| `checkoutAccountTypeSelect`     | Defines error messages for the account type selection in the checkout.                 |
| `checkoutBillAddressSelect`     | Defines error messages when selecting the billing address in the checkout.             |
| `checkoutConfirm`               | Defines emails and error messages for order completion.                                |
| `checkoutPaymentUpdate`         | Defines error messages when changing the payment method in the checkout.               |
| `checkoutPseudoCCSelect`        | Defines error messages when selecting a saved (pseudo) credit card in the checkout.    |
| `checkoutSetFreeFields`         | Defines error messages when checking free-text fields in the checkout.                 |
| `checkoutSetGuestEmail`         | Defines error messages when entering the email address for a guest order.              |
| `checkoutShippingAddressSelect` | Defines the error messages when selecting the shipping address in the checkout.        |
| `checkoutShippingMethodUpdate`  | Defines error messages when changing the shipping method in the checkout.              |
| `guestRegister`                 | Defines emails and error messages for creating a customer account after a guest order. |
| `directOrder`                   | Defines error messages for direct orders.                                              |
| `voucherAdd`                    | Defines error messages when adding a voucher to the basket.                            |
| `voucherDelete`                 | Defines error messages when removing a voucher from the basket.                        |
| `inventoryReserve`              | Defines error messages when reserving inventory for basket line items.                 |

## `actions.basketItem*` - Basket line item

### `actions.basketItemAdd` - Add basket line item

The `basketItemAdd` action controls the error messages when adding an item to the basket.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "accountNotVerified": "<Textbaustein>",
    "basketLocked": "<Textbaustein>",
    "missingProductId": "<Textbaustein>",
    "missingQuantity": "<Textbaustein>",
    "invalidQuantity": "<Textbaustein>",
    "invalidProductId": "<Textbaustein>",
    "invalidVariantId": "<Textbaustein>",
    "insufficientAmount": "<Textbaustein>",
    "quantityExceeded": "<Textbaustein>",
    "childProductOnly": "<Textbaustein>",
    "expressCheckoutNotAllowed": "<Textbaustein>",
    "noVariantFound": "<Textbaustein>",
    "invalidStore": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**               | **Type** | **Description**                                                                                                                                                      |
| --------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `errorCodes`                | object   | Configures the error codes used for problems during the action.                                                                                                      |
| `accountNotVerified`        | string   | Error message output when the customer account has not yet been verified. <br /><br /><TextbausteinHinweis />                                                        |
| `basketLocked`              | string   | Error message output when the basket is locked and currently cannot be modified (for example during a running express checkout). <br /><br /><TextbausteinHinweis /> |
| `missingProductId`          | string   | Error message output when no product ID was supplied. <br /><br /><TextbausteinHinweis />                                                                            |
| `missingQuantity`           | string   | Error message output when no order quantity was supplied. <br /><br /><TextbausteinHinweis />                                                                        |
| `invalidQuantity`           | string   | Error message output when the supplied order quantity is invalid. <br /><br /><TextbausteinHinweis />                                                                |
| `invalidProductId`          | string   | Error message output when the supplied product ID is invalid. <br /><br /><TextbausteinHinweis />                                                                    |
| `invalidVariantId`          | string   | Error message output when the selected variant is invalid or unavailable. <br /><br /><TextbausteinHinweis />                                                        |
| `insufficientAmount`        | string   | Error message output when there is not enough stock for the requested quantity. <br /><br /><TextbausteinHinweis />                                                  |
| `quantityExceeded`          | string   | Error message output when a defined maximum order quantity is exceeded. <br /><br /><TextbausteinHinweis />                                                          |
| `childProductOnly`          | string   | Error message output when an attempt is made to directly order a product that is only configurable as a "child" product. <br /><br /><TextbausteinHinweis />         |
| `expressCheckoutNotAllowed` | string   | Error message output when the item may not be placed in the basket during an express checkout. <br /><br /><TextbausteinHinweis />                                   |
| `noVariantFound`            | string   | Error message output when no matching product variant is found for the selected options. <br /><br /><TextbausteinHinweis />                                         |
| `invalidStore`              | string   | Error message output when the selected pickup location is invalid or unavailable for the item. <br /><br /><TextbausteinHinweis />                                   |

### `actions.basketItemDelete` - Delete basket line item

The `basketItemDelete` action controls the error messages when removing an item from the basket.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "accountNotVerified": "<Textbaustein>",
    "basketLocked": "<Textbaustein>",
    "missingBasketItemId": "<Textbaustein>",
    "invalidBasketItemId": "<Textbaustein>",
    "basketItemIsSetChild": "<Textbaustein>",
    "itemNotRemovable": "<Textbaustein>",
    "internalError": "<Textbaustein>",
    "invalidChildItem": "<Textbaustein>",
    "expressCheckoutNotAllowed": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**               | **Type** | **Description**                                                                                                                                                      |
| --------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `errorCodes`                | object   | Configures the error codes used for problems during the action.                                                                                                      |
| `accountNotVerified`        | string   | Error message output when the customer account has not yet been verified. <br /><br /><TextbausteinHinweis />                                                        |
| `basketLocked`              | string   | Error message output when the basket is locked and currently cannot be modified (for example during a running express checkout). <br /><br /><TextbausteinHinweis /> |
| `missingBasketItemId`       | string   | Error message output when no basket-item ID was supplied. <br /><br /><TextbausteinHinweis />                                                                        |
| `invalidBasketItemId`       | string   | Error message output when the supplied basket line item is invalid or cannot be found. <br /><br /><TextbausteinHinweis />                                           |
| `basketItemIsSetChild`      | string   | Error message output when an attempt is made to remove a variant that may only be removed via the main product. <br /><br /><TextbausteinHinweis />                  |
| `itemNotRemovable`          | string   | Error message output when the corresponding line item may generally not be removed. <br /><br /><TextbausteinHinweis />                                              |
| `internalError`             | string   | Error message output when an unexpected system error occurs. <br /><br /><TextbausteinHinweis />                                                                     |
| `invalidChildItem`          | string   | Error message output when an invalid variant is referenced. <br /><br /><TextbausteinHinweis />                                                                      |
| `expressCheckoutNotAllowed` | string   | Error message output when removing the line item is not allowed during an express checkout. <br /><br /><TextbausteinHinweis />                                      |

### `actions.basketItemUpdate` - Change basket line item

The `basketItemUpdate` action controls the error messages when changing a basket line item.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "accountNotVerified": "<Textbaustein>",
    "basketLocked": "<Textbaustein>",
    "missingBasketItemId": "<Textbaustein>",
    "missingQuantity": "<Textbaustein>",
    "invalidBasketItemId": "<Textbaustein>",
    "invalidQuantity": "<Textbaustein>",
    "invalidProductId": "<Textbaustein>",
    "invalidVariantId": "<Textbaustein>",
    "insufficientAmount": "<Textbaustein>",
    "quantityExceeded": "<Textbaustein>",
    "childProductOnly": "<Textbaustein>",
    "itemNotChangeable": "<Textbaustein>",
    "internalError": "<Textbaustein>",
    "invalidChildItem": "<Textbaustein>",
    "expressCheckoutNotAllowed": "<Textbaustein>",
    "noVariantFound": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**               | **Type** | **Description**                                                                                                                                                      |
| --------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `errorCodes`                | object   | Configures the error codes used for problems during the action.                                                                                                      |
| `accountNotVerified`        | string   | Error message output when the customer account has not yet been verified. <br /><br /><TextbausteinHinweis />                                                        |
| `basketLocked`              | string   | Error message output when the basket is locked and currently cannot be modified (for example during a running express checkout). <br /><br /><TextbausteinHinweis /> |
| `missingBasketItemId`       | string   | Error message output when no basket-item ID was supplied. <br /><br /><TextbausteinHinweis />                                                                        |
| `missingQuantity`           | string   | Error message output when no order quantity was supplied. <br /><br /><TextbausteinHinweis />                                                                        |
| `invalidBasketItemId`       | string   | Error message output when the supplied basket line item is invalid or cannot be found. <br /><br /><TextbausteinHinweis />                                           |
| `invalidQuantity`           | string   | Error message output when the supplied order quantity is invalid. <br /><br /><TextbausteinHinweis />                                                                |
| `invalidProductId`          | string   | Error message output when the supplied product ID is invalid. <br /><br /><TextbausteinHinweis />                                                                    |
| `invalidVariantId`          | string   | Error message output when the selected variant is invalid or unavailable. <br /><br /><TextbausteinHinweis />                                                        |
| `insufficientAmount`        | string   | Error message output when there is not enough stock for the requested quantity. <br /><br /><TextbausteinHinweis />                                                  |
| `quantityExceeded`          | string   | Error message output when a defined maximum order quantity is exceeded. <br /><br /><TextbausteinHinweis />                                                          |
| `childProductOnly`          | string   | Error message output when an attempt is made to directly order a product that is only configurable as a "child" product. <br /><br /><TextbausteinHinweis />         |
| `itemNotChangeable`         | string   | Error message output when the corresponding basket line item may generally not be changed. <br /><br /><TextbausteinHinweis />                                       |
| `internalError`             | string   | Error message output when an unexpected system error occurs. <br /><br /><TextbausteinHinweis />                                                                     |
| `invalidChildItem`          | string   | Error message output when an invalid variant is referenced. <br /><br /><TextbausteinHinweis />                                                                      |
| `expressCheckoutNotAllowed` | string   | Error message output when the item may not be placed in the basket during an express checkout. <br /><br /><TextbausteinHinweis />                                   |
| `noVariantFound`            | string   | Error message output when no matching product variant is found for the selected options. <br /><br /><TextbausteinHinweis />                                         |

## `actions.checkout*` - Checkout

### `actions.checkoutAccountTypeSelect` - Select account type

Controls the selection between guest order, existing customer and new customer to start the order in the checkout.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "missingAccountType": "<Textbaustein>",
    "invalidAccountType": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**        | **Type** | **Description**                                                                                                    |
| -------------------- | -------- | ------------------------------------------------------------------------------------------------------------------ |
| `errorCodes`         | object   | Configures the error codes used for problems during the action.                                                    |
| `missingAccountType` | string   | Error message output when no account type was selected. <br /><br /><TextbausteinHinweis />                        |
| `invalidAccountType` | string   | Error message output when an invalid or unsupported account type was supplied. <br /><br /><TextbausteinHinweis /> |

### `actions.checkoutBillAddressSelect` - Select billing address

The `checkoutBillAddressSelect` action controls the error messages when selecting the billing address in the checkout.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "missingAddressId": "<Textbaustein>",
    "invalidAddressId": "<Textbaustein>",
    "invalidBillAddress": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**        | **Type** | **Description**                                                                                                                     |
| -------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `errorCodes`         | object   | Configures the error codes used for problems during the action.                                                                     |
| `missingAddressId`   | string   | Error message output when no address ID was supplied. <br /><br /><TextbausteinHinweis />                                           |
| `invalidAddressId`   | string   | Error message output when the supplied address ID is invalid or the address could not be found. <br /><br /><TextbausteinHinweis /> |
| `invalidBillAddress` | string   | Error message output when the address may not be used as a billing address. <br /><br /><TextbausteinHinweis />                     |

### `actions.checkoutConfirm` - Complete order

The `checkoutConfirm` action controls error messages and emails for order completion.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "customerEmail": {
    "template": "order_confirmation_customer.htm",
    "subject": "Ihre Bestellung bei Mein Onlineshop",
    "fromAddress": "noreply@meinshop.de",
    "fromName": "Mein Onlineshop",
    "merchantEmail": "bestellungen@meinshop.de",
    "attachments": [
      {
        "name": "AGB.pdf",
        "file": "/files/agb.pdf"
      }
    ]
  },
  "paymentFailedEmail": {
    "template": "order_payment_failed.htm",
    "subject": "Zahlung Ihrer Bestellung fehlgeschlagen",
    "fromAddress": "noreply@meinshop.de",
    "fromName": "Mein Onlineshop",
    "merchantEmail": "zahlung@meinshop.de"
  },
  "errorCodes": {
    "accountNotVerified": "<Textbaustein>",
    "invalid": "<Textbaustein>",
    "productsNotAvailableForOrder": "<Textbaustein>",
    "requiredCheckboxUnchecked": "<Textbaustein>",
    "requiredTextfieldEmpty": "<Textbaustein>",
    "itemsExpired": "<Textbaustein>",
    "expiredReservation": "<Textbaustein>",
    "guestAccountsDisabled": "<Textbaustein>",
    "inExpressCheckout": "<Textbaustein>",
    "paymentBlocked": "<Textbaustein>",
    "captchaFailed": "<Textbaustein>",
    "clearingFailed": "<Textbaustein>",
    "orderCreationFailed": "<Textbaustein>",
    "checkoutCompletedError": "<Textbaustein>",
    "simulateFailedPayment": "<Textbaustein>",
    "noPermission": "<Textbaustein>",
    "personalLimitExceeded": "<Textbaustein>",
    "paymentLimitExceeded": "<Textbaustein>",
    "basketNotVerified": "<Textbaustein>",
    "voucherGenerateError": "<Textbaustein>",
    "invalidVoucherId": "<Textbaustein>",
    "voucherDeactivated": "<Textbaustein>",
    "voucherExpired": "<Textbaustein>",
    "voucherNotYetValid": "<Textbaustein>",
    "voucherValueSpent": "<Textbaustein>",
    "voucherInsuffientAmount": "<Textbaustein>",
    "voucherCurrencyMismatch": "<Textbaustein>",
    "voucherInvalidCustomer": "<Textbaustein>",
    "voucherInvalidSubshop": "<Textbaustein>",
    "voucherIneffective": "<Textbaustein>",
    "voucherRepoUpdateFailed": "<Textbaustein>",
    "voucherInvalidVoucherConfiguration": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**                        | **Type**       | **Description**                                                                                                                                                                                                                                                                            |
| ------------------------------------ | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `customerEmail`                      | object         | Configures the order confirmation email sent to the customer (incl. optional copy to the merchant and attachments). <br />Subject, sender and template are controlled via the general email parameters, see here:   [Email settings](/en/konfiguration/e-mails-e-mail-einstellungen)       |
| `customerEmail.attachments`          | array (object) | List of file attachments included in the order confirmation email (for example terms & conditions as PDF). For each attachment, provide `name` (displayed file name) and `file` (path to the file in the shop). See also [Email settings](/en/konfiguration/e-mails-e-mail-einstellungen). |
| `paymentFailedEmail`                 | object         | Configures the email that can be sent when payment fails. <br />Subject, sender and template are controlled via the general email parameters, see here:   [Email settings](/en/konfiguration/e-mails-e-mail-einstellungen)                                                                 |
| `errorCodes`                         | object         | Configures the error codes used for problems during the action.                                                                                                                                                                                                                            |
| `accountNotVerified`                 | string         | Error message output when the customer account has not yet been verified. <br /><br /><TextbausteinHinweis />                                                                                                                                                                              |
| `invalid`                            | string         | Error message output when the order cannot be confirmed. <br /><br /><TextbausteinHinweis />                                                                                                                                                                                               |
| `productsNotAvailableForOrder`       | string         | Error message output when at least one item in the basket is no longer orderable. <br /><br /><TextbausteinHinweis />                                                                                                                                                                      |
| `requiredCheckboxUnchecked`          | string         | Error message output when a required checkbox was not ticked. <br /><br /><TextbausteinHinweis />                                                                                                                                                                                          |
| `requiredTextfieldEmpty`             | string         | Error message output when an input field marked as required is empty. <br /><br /><TextbausteinHinweis />                                                                                                                                                                                  |
| `itemsExpired`                       | string         | Error message output when items in the basket are no longer available in the meantime. <br /><br /><TextbausteinHinweis />                                                                                                                                                                 |
| `expiredReservation`                 | string         | Error message output when a previously created basket reservation has expired. <br /><br /><TextbausteinHinweis />                                                                                                                                                                         |
| `guestAccountsDisabled`              | string         | Error message output when guest orders are disabled and a customer without an account tries to order. <br /><br /><TextbausteinHinweis />                                                                                                                                                  |
| `inExpressCheckout`                  | string         | Error message output when the regular order completion is not allowed during a running express checkout. <br /><br /><TextbausteinHinweis />                                                                                                                                               |
| `paymentBlocked`                     | string         | Error message output when the payment is blocked due to a lock (for example IP or session block). <br /><br /><TextbausteinHinweis />                                                                                                                                                      |
| `captchaFailed`                      | string         | Error message output when the captcha check during order completion fails. <br /><br /><TextbausteinHinweis />                                                                                                                                                                             |
| `clearingFailed`                     | string         | Error message output when payment authorization by the payment service provider fails. <br /><br /><TextbausteinHinweis />                                                                                                                                                                 |
| `orderCreationFailed`                | string         | Error message output when the order could not be created technically. <br /><br /><TextbausteinHinweis />                                                                                                                                                                                  |
| `checkoutCompletedError`             | string         | Error message output when the checkout has already been completed and cannot be executed again. <br /><br /><TextbausteinHinweis />                                                                                                                                                        |
| `simulateFailedPayment`              | string         | Error message output when a failed payment is simulated in test mode. <br /><br /><TextbausteinHinweis />                                                                                                                                                                                  |
| `noPermission`                       | string         | Error message output when the (sub-)account is not authorised to place orders. <br /><br /><TextbausteinHinweis />                                                                                                                                                                         |
| `personalLimitExceeded`              | string         | Error message output when the personal payment limit per order would be exceeded. <br /><br /><TextbausteinHinweis />                                                                                                                                                                      |
| `paymentLimitExceeded`               | string         | Error message output when the total payment limit stored for the account would be exceeded by the order. <br /><br /><TextbausteinHinweis />                                                                                                                                               |
| `basketNotVerified`                  | string         | Error message output when the basket (in a B2B context) has not yet been approved/verified and therefore cannot be ordered. <br /><br /><TextbausteinHinweis />                                                                                                                            |
| `voucherGenerateError`               | string         | Error message output when an error occurs while generating a voucher. <br /><br /><TextbausteinHinweis />                                                                                                                                                                                  |
| `invalidVoucherId`                   | string         | Error message output when the entered voucher code does not exist or is not recognised. <br /><br /><TextbausteinHinweis />                                                                                                                                                                |
| `voucherDeactivated`                 | string         | Error message output when the voucher is deactivated and can no longer be redeemed. <br /><br /><TextbausteinHinweis />                                                                                                                                                                    |
| `voucherExpired`                     | string         | Error message output when the voucher has expired. <br /><br /><TextbausteinHinweis />                                                                                                                                                                                                     |
| `voucherNotYetValid`                 | string         | Error message output when the voucher is only valid from a later date. <br /><br /><TextbausteinHinweis />                                                                                                                                                                                 |
| `voucherValueSpent`                  | string         | Error message output when the voucher has already been fully used. <br /><br /><TextbausteinHinweis />                                                                                                                                                                                     |
| `voucherInsuffientAmount`            | string         | Error message output when the voucher amount is not sufficient for this order. <br /><br /><TextbausteinHinweis />                                                                                                                                                                         |
| `voucherCurrencyMismatch`            | string         | Error message output when the voucher was issued in a different currency than the one currently used in the basket. <br /><br /><TextbausteinHinweis />                                                                                                                                    |
| `voucherInvalidCustomer`             | string         | Error message output when the voucher is bound to a different customer. <br /><br /><TextbausteinHinweis />                                                                                                                                                                                |
| `voucherInvalidSubshop`              | string         | Error message output when the voucher is not valid in the current subshop. <br /><br /><TextbausteinHinweis />                                                                                                                                                                             |
| `voucherIneffective`                 | string         | Error message output when a stored voucher has no effect on this order and therefore blocks the order. <br /><br /><TextbausteinHinweis />                                                                                                                                                 |
| `voucherRepoUpdateFailed`            | string         | Error message output when the voucher status could not be updated technically upon redemption. <br /><br /><TextbausteinHinweis />                                                                                                                                                         |
| `voucherInvalidVoucherConfiguration` | string         | Error message output when the configuration of the voucher is invalid. <br /><br /><TextbausteinHinweis />                                                                                                                                                                                 |

### `actions.checkoutPaymentUpdate` - Change payment method

The `checkoutPaymentUpdate` action controls the error messages when changing the payment method in the checkout.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "missingPaymentId": "<Textbaustein>",
    "inactivePayment": "<Textbaustein>",
    "invalidPaymentId": "<Textbaustein>",
    "expressCheckoutNotAllowed": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**               | **Type** | **Description**                                                                                                                       |
| --------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `errorCodes`                | object   | Configures the error codes used for problems during the action.                                                                       |
| `missingPaymentId`          | string   | Error message output when no payment method was selected. <br /><br /><TextbausteinHinweis />                                         |
| `inactivePayment`           | string   | Error message output when the selected payment method is disabled in the shop. <br /><br /><TextbausteinHinweis />                    |
| `invalidPaymentId`          | string   | Error message output when the supplied payment ID is invalid or the payment method was not found. <br /><br /><TextbausteinHinweis /> |
| `expressCheckoutNotAllowed` | string   | Error message output when changing the payment method is not allowed during an express checkout. <br /><br /><TextbausteinHinweis />  |

### `actions.checkoutPseudoCCSelect` - Select credit card

The `checkoutPseudoCCSelect` action controls the error messages when selecting a saved credit card in the checkout.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "notLoggedIn": "<Textbaustein>",
    "missingPseudoId": "<Textbaustein>",
    "notAllowed": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**     | **Type** | **Description**                                                                                                                |
| ----------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `errorCodes`      | object   | Configures the error codes used for problems during the action.                                                                |
| `notLoggedIn`     | string   | Error message output when a user who is not signed in tries to use a saved credit card. <br /><br /><TextbausteinHinweis />    |
| `missingPseudoId` | string   | Error message output when no card reference (pseudo ID) was supplied. <br /><br /><TextbausteinHinweis />                      |
| `notAllowed`      | string   | Error message output when the selected credit card may not be used in the current context. <br /><br /><TextbausteinHinweis /> |

### `actions.checkoutSetFreeFields` - Free-text fields in the checkout

The `checkoutSetFreeFields` action controls the error messages for the check of free-text fields in the checkout.

#### Example configuration `actions.checkoutSetFreeFields`

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "textfieldCheckFailed": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**          | **Type** | **Description**                                                                                                                                         |
| ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `errorCodes`           | object   | Configures the error codes used for problems during the action.                                                                                         |
| `textfieldCheckFailed` | string   | Error message output when the validation of one or more free-text fields fails (for example, required field empty). <br /><br /><TextbausteinHinweis /> |

### `actions.checkoutSetGuestEmail` - Guest order

The `checkoutSetGuestEmail` action controls the error messages when entering the email address for a guest order.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "missingGuestEmail": "<Textbaustein>",
    "invalidGuestEmail": "<Textbaustein>",
    "guestEmailAlreadyUsed": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**           | **Type** | **Description**                                                                                                                           |
| ----------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `errorCodes`            | object   | Configures the error codes used for problems during the action.                                                                           |
| `missingGuestEmail`     | string   | Error message output when no email address was entered. <br /><br /><TextbausteinHinweis />                                               |
| `invalidGuestEmail`     | string   | Error message output when the supplied email address does not match the expected format. <br /><br /><TextbausteinHinweis />              |
| `guestEmailAlreadyUsed` | string   | Error message output when the email address is already associated with a registered customer account. <br /><br /><TextbausteinHinweis /> |

### `actions.checkoutShippingAddressSelect` - Select shipping address

The `checkoutShippingAddressSelect` action controls the error messages when selecting the shipping address in the checkout.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "missingAddressId": "<Textbaustein>",
    "invalidAddressId": "<Textbaustein>",
    "expressCheckoutNotAllowed": "<Textbaustein>",
    "invalidShippingAddress": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**               | **Type** | **Description**                                                                                                                                  |
| --------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `errorCodes`                | object   | Configures the error codes used for problems during the action.                                                                                  |
| `missingAddressId`          | string   | Error message output when no address ID was supplied. <br /><br /><TextbausteinHinweis />                                                        |
| `invalidAddressId`          | string   | Error message output when the supplied address ID is invalid or the address cannot be found. <br /><br /><TextbausteinHinweis />                 |
| `expressCheckoutNotAllowed` | string   | Error message output when selecting/changing the shipping address is not allowed during an express checkout. <br /><br /><TextbausteinHinweis /> |
| `invalidShippingAddress`    | string   | Error message output when the selected address may not be used as a shipping address. <br /><br /><TextbausteinHinweis />                        |

### `actions.checkoutShippingMethodUpdate` - Select / change shipping method

The `checkoutShippingMethodUpdate` action controls the error messages when changing the shipping method in the checkout.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "missingShippingMethodId": "<Textbaustein>",
    "inactiveShippingMethodId": "<Textbaustein>",
    "invalidShippingMethodId": "<Textbaustein>",
    "reservationFailed": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**              | **Type** | **Description**                                                                                                                                  |
| -------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `errorCodes`               | object   | Configures the error codes used for problems during the action.                                                                                  |
| `missingShippingMethodId`  | string   | Error message output when no shipping method was selected or no shipping method ID was supplied. <br /><br /><TextbausteinHinweis />             |
| `inactiveShippingMethodId` | string   | Error message output when the selected shipping method is disabled in the shop or temporarily unavailable. <br /><br /><TextbausteinHinweis />   |
| `invalidShippingMethodId`  | string   | Error message output when the supplied shipping method ID is invalid or the shipping method cannot be found. <br /><br /><TextbausteinHinweis /> |
| `reservationFailed`        | string   | Error message output when a required reservation for the shipping method fails. <br /><br /><TextbausteinHinweis />                              |

## `actions.guestRegister` - Registration after a guest order

The `guestRegister` action controls the error messages and emails when creating a full customer account from a guest order.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "verifyEmail": {
    "template": "guest_register_verify.htm",
    "subject": "Bitte bestätigen Sie Ihre Registrierung",
    "fromAddress": "noreply@meinshop.de",
    "fromName": "Mein Onlineshop"
  },
  "errorCodes": {
    "nonGuestAccount": "<Textbaustein>",
    "duplicateEmail": "<Textbaustein>",
    "missingEmail": "<Textbaustein>",
    "missingPassword": "<Textbaustein>",
    "passwordMismatch": "<Textbaustein>",
    "passwordCheckFailed": "<Textbaustein>",
    "createError": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**         | **Type** | **Description**                                                                                                                                                                                                                                                                |
| --------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `verifyEmail`         | object   | Configures the email through which the former guest customer can confirm their registration or email address. <br />Subject, sender and template are controlled via the general email parameters, see here:   [Email settings](/en/konfiguration/e-mails-e-mail-einstellungen) |
| `errorCodes`          | object   | Configures the error codes used for problems during the action.                                                                                                                                                                                                                |
| `nonGuestAccount`     | string   | Error message output when an attempt is made to register an account that is not a guest account. <br /><br /><TextbausteinHinweis />                                                                                                                                           |
| `duplicateEmail`      | string   | Error message output when a customer account already exists under the supplied email address. <br /><br /><TextbausteinHinweis />                                                                                                                                              |
| `missingEmail`        | string   | Error message output when no email address is supplied. <br /><br /><TextbausteinHinweis />                                                                                                                                                                                    |
| `missingPassword`     | string   | Error message output when no password was supplied for the new customer account. <br /><br /><TextbausteinHinweis />                                                                                                                                                           |
| `passwordMismatch`    | string   | Error message output when the password and password confirmation do not match. <br /><br /><TextbausteinHinweis />                                                                                                                                                             |
| `passwordCheckFailed` | string   | Error message output when the chosen password does not meet the password rules. <br /><br /><TextbausteinHinweis />                                                                                                                                                            |
| `createError`         | string   | Error message output when the customer account could not be created technically. <br /><br /><TextbausteinHinweis />                                                                                                                                                           |

### `actions.directOrder` - Direct order

The `directOrder` action controls the error messages for direct orders by item number.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "invalidId": "<Textbaustein>",
    "missingId": "<Textbaustein>",
    "invalidQuantity": "<Textbaustein>",
    "missingQuantity": "<Textbaustein>",
    "productHasNoVariants": "<Textbaustein>",
    "variantDoesNotExist": "<Textbaustein>",
    "baseProductCanNotBeChosen": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**               | **Type** | **Description**                                                                                                                                    |
| --------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `errorCodes`                | object   | Configures the error codes used for problems during the action.                                                                                    |
| `invalidId`                 | string   | Error message output when the entered item/order number is invalid or no matching item can be found. <br /><br /><TextbausteinHinweis />           |
| `missingId`                 | string   | Error message output when no item/order number was entered. <br /><br /><TextbausteinHinweis />                                                    |
| `invalidQuantity`           | string   | Error message output when the supplied quantity is invalid. <br /><br /><TextbausteinHinweis />                                                    |
| `missingQuantity`           | string   | Error message output when no order quantity was supplied. <br /><br /><TextbausteinHinweis />                                                      |
| `productHasNoVariants`      | string   | Error message output when no variants exist for the selected item although a variant was expected. <br /><br /><TextbausteinHinweis />             |
| `variantDoesNotExist`       | string   | Error message output when the supplied variant does not exist. <br /><br /><TextbausteinHinweis />                                                 |
| `baseProductCanNotBeChosen` | string   | Error message output when the base product cannot be selected directly and a variant must be selected instead. <br /><br /><TextbausteinHinweis /> |

## `actions.voucher*` - Voucher

### `actions.voucherAdd` - Redeem / add voucher

The `voucherAdd` action controls the error messages when adding a voucher to the basket.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "missingId": "<Textbaustein>",
    "duplicateId": "<Textbaustein>",
    "invalidVoucherId": "<Textbaustein>",
    "deactivated": "<Textbaustein>",
    "expired": "<Textbaustein>",
    "notYetValid": "<Textbaustein>",
    "maxCountExceeded": "<Textbaustein>",
    "valueSpent": "<Textbaustein>",
    "insuffientAmount": "<Textbaustein>",
    "currencyMismatch": "<Textbaustein>",
    "invalidCustomer": "<Textbaustein>",
    "invalidSubshop": "<Textbaustein>",
    "repoUpdateFailed": "<Textbaustein>",
    "invalidVoucherConfiguration": "<Textbaustein>",
    "insufficientMinOrderValue": "<Textbaustein>",
    "expressCheckoutNotAllowed": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**                 | **Type** | **Description**                                                                                                                                         |
| ----------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `errorCodes`                  | object   | Configures the error codes used for problems during the action.                                                                                         |
| `missingId`                   | string   | Error message output when no voucher code was entered. <br /><br /><TextbausteinHinweis />                                                              |
| `duplicateId`                 | string   | Error message output when the same voucher code is already stored in the basket. <br /><br /><TextbausteinHinweis />                                    |
| `invalidVoucherId`            | string   | Error message output when the voucher code is invalid or no voucher can be found. <br /><br /><TextbausteinHinweis />                                   |
| `deactivated`                 | string   | Error message output when the voucher has been disabled in the system. <br /><br /><TextbausteinHinweis />                                              |
| `expired`                     | string   | Error message output when the validity period of the voucher has expired. <br /><br /><TextbausteinHinweis />                                           |
| `notYetValid`                 | string   | Error message output when the voucher is only valid from a later date. <br /><br /><TextbausteinHinweis />                                              |
| `maxCountExceeded`            | string   | Error message output when the maximum number of allowed redemptions has been exceeded. <br /><br /><TextbausteinHinweis />                              |
| `valueSpent`                  | string   | Error message output when the voucher has already been fully redeemed and no residual value remains. <br /><br /><TextbausteinHinweis />                |
| `insuffientAmount`            | string   | Error message output when the voucher value is not sufficient for the current order. <br /><br /><TextbausteinHinweis />                                |
| `currencyMismatch`            | string   | Error message output when the voucher was issued in a different currency than the one currently used in the basket. <br /><br /><TextbausteinHinweis /> |
| `invalidCustomer`             | string   | Error message output when the voucher is bound to a different customer than the one currently signed in. <br /><br /><TextbausteinHinweis />            |
| `invalidSubshop`              | string   | Error message output when the voucher may not be redeemed in the current subshop/shop. <br /><br /><TextbausteinHinweis />                              |
| `repoUpdateFailed`            | string   | Error message output when the voucher status could not be updated technically upon redemption. <br /><br /><TextbausteinHinweis />                      |
| `invalidVoucherConfiguration` | string   | Error message output when the configuration of the voucher is invalid. <br /><br /><TextbausteinHinweis />                                              |
| `insufficientMinOrderValue`   | string   | Error message output when the minimum order value for redeeming the voucher is not reached. <br /><br /><TextbausteinHinweis />                         |
| `expressCheckoutNotAllowed`   | string   | Error message output when redeeming a voucher is not allowed during an express checkout. <br /><br /><TextbausteinHinweis />                            |

### `actions.voucherDelete` - Delete voucher

The `voucherDelete` action controls the error messages when removing a voucher from the basket.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "invalidVoucherId": "<Textbaustein>",
    "expressCheckoutNotAllowed": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**               | **Type** | **Description**                                                                                                                         |
| --------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `errorCodes`                | object   | Configures the error codes used for problems during the action.                                                                         |
| `invalidVoucherId`          | string   | Error message output when the supplied voucher cannot be found in the basket or cannot be assigned. <br /><br /><TextbausteinHinweis /> |
| `expressCheckoutNotAllowed` | string   | Error message output when removing a voucher is not allowed during an express checkout. <br /><br /><TextbausteinHinweis />             |

## `actions.inventoryReserve` - Reservation in the basket

The `inventoryReserve` action controls the error messages when reserving inventory for basket line items.

#### Example configuration

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "errorCodes": {
    "missingBasketItemId": "<Textbaustein>",
    "invalidBasketItemId": "<Textbaustein>",
    "noReservationFound": "<Textbaustein>",
    "insufficientAmount": "<Textbaustein>",
    "inventoryInactive": "<Textbaustein>",
    "setChildReserveActionInvalid": "<Textbaustein>"
  }
}
```

#### Parameter overview

| **Parameter**                  | **Type** | **Description**                                                                                                                             |
| ------------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `errorCodes`                   | object   | Configures the error codes used for problems during the action.                                                                             |
| `missingBasketItemId`          | string   | Error message output when no basket-item ID was supplied. <br /><br /><TextbausteinHinweis />                                               |
| `invalidBasketItemId`          | string   | Error message output when the supplied basket line item is invalid or cannot be found. <br /><br /><TextbausteinHinweis />                  |
| `noReservationFound`           | string   | Error message output when no matching reservation can be found or created. <br /><br /><TextbausteinHinweis />                              |
| `insufficientAmount`           | string   | Error message output when there is not enough stock available for the requested quantity. <br /><br /><TextbausteinHinweis />               |
| `inventoryInactive`            | string   | Error message output when the inventory management or reservation function is disabled in the system. <br /><br /><TextbausteinHinweis />   |
| `setChildReserveActionInvalid` | string   | Error message output when a reservation of the requested form is not allowed for a set/child line item. <br /><br /><TextbausteinHinweis /> |