Skip to main content
This section describes the available actions in the checkout. With these actions, billing and shipping addresses can be selected, cached, and applied, for example.

Actions overview


Actions

CheckoutBillAddressSelect

With this action, the customer selects one of their already saved addresses as the billing address for the current order process. The selection is applied immediately; no further confirmation is needed. Usage example
Useful for displaying a dropdown of their saved addresses to logged-in customers in the checkout, so they can select a billing address with a single click without re-entering data.
Parameters Error codes Related modules, variables & methods Example showing how logged-in customers are presented with a dropdown of their saved addresses, through which they can select a billing address.

CheckoutShippingAddressSelect

With this action, the customer selects one of their already saved addresses as the shipping address for the current order process. The action is only relevant if the customer wants to specify a different shipping address. Usage example
Useful when a customer wants to ship an order to a different address.
Parameters Error codes Related modules, variables & methods Example showing how logged-in customers are presented with a dropdown of their saved addresses, through which they can select a shipping address.

CheckoutSetDraftAddress

With this action, an address entered by the customer is temporarily saved without the entries being immediately checked for completeness or correctness. The draft address already affects the available shipping and payment methods, which are adjusted based on the entries (relevant for the OnePage checkout). The address is initially considered a draft and is applied as the binding checkout address only by CheckoutCommitDraftAddress. The address type is specified directly in the action name (bill or shipping). Usage example
Useful in the OnePage checkout to continuously cache the entered address without immediately confronting the customer with validation errors. The actual check of the address only takes place when “Buy now” is clicked, via CheckoutCommitDraftAddress.
Parameters Related modules, variables & methods Example showing how a billing address is cached as a draft without being validated immediately.

CheckoutCommitDraftAddress

With this action, an address draft previously saved via CheckoutSetDraftAddress is validated and applied as the checkout address. The behavior differs depending on the order type:
  • Guest order - the entered address is checked and, if valid, applied directly for the checkout.
  • Order with customer account - the entered address is checked and, if valid, created as a new address in the customer account and selected for the current checkout at the same time.
If the data is incorrect or incomplete, validation fails and the draft is retained so the customer can correct their entries. The address type is specified directly in the action name (bill or shipping). Together with CheckoutSetDraftAddress, this action forms the typical address workflow in the OnePage checkout:
CheckoutSetDraftAddress continuously caches the entries (without validation); CheckoutCommitDraftAddress completes the process.
Usage example
Useful as the final step in the OnePage checkout. The customer has already entered their address, and only when “Buy now” is clicked is it checked whether all information is correct and complete.
Parameters Error codes Related modules, variables & methods Example showing how a billing address draft is validated and applied as the binding checkout address. In case of incorrect entries, the draft is retained and errors are output.

CheckoutUseSameShippingAddress

With this action, it is specified that delivery should be made to the same address as the billing address. A previously entered or selected different shipping address is not deleted but is no longer taken into account for the checkout. Usage example
Useful for giving the customer the option, e.g., via a checkbox, to equate billing and shipping addresses with a single click without re-entering data.
Related modules, variables & methods Example showing how the action is triggered via a hidden form that can be coupled to a checkbox via JavaScript.

CheckoutUseDifferentShippingAddress

With this action, a different shipping address is activated for the checkout. As soon as it has been triggered, the area for selecting or entering a separate shipping address becomes relevant. The action reverses the effect of CheckoutUseSameShippingAddress. Usage example
Useful when the customer wants an order to be delivered to a different address, e.g., directly to a branch.
Related modules, variables & methods Example showing how the action is triggered via a hidden form that can be coupled to a checkbox via JavaScript.

CheckoutAccountTypeSelect

With this action, the account type for the current order process is set. The selected type determines which steps are displayed in the checkout process. Usage example
Useful on the login page in the checkout context to give the customer the option of ordering as a guest without having to create an account.
Parameters Error codes Related modules, variables & methods Example showing how the account type is set to “guest” to enable a guest order.

CheckoutSetGuestEmail

With this action, the email address for a guest order is set. It is only relevant if the account type has been set to “guest”. Usage example
Useful in the checkout when a customer wants to order as a guest and needs to provide their email address for this.
Parameters Error codes Related modules, variables & methods Example showing how a guest customer enters their email address in the checkout, including error output on invalid input.

CheckoutShippingMethodUpdate

With this action, the shipping method for the current order process is set. Usage example
Useful in the checkout to display a list of available shipping methods to the customer, from which they can select one.
Parameters Error codes Related modules, variables & methods Example showing how all available shipping methods are displayed as a selection list, with unavailable options being disabled.

CheckoutConfirm

With this action, the order is submitted in a binding manner. It is the final step in the checkout process and requires that all required information — address, payment method, and shipping method — is complete and valid. Usage example
Useful as the “Buy now” button on the order overview page, through which the customer places the order in a binding manner.
Error codes Related modules, variables & methods Example showing how the order is submitted in a binding manner via a button, provided that the customer is logged in or identified as a guest.

CheckoutSetFreeFields

With this action, the free checkout fields are set, e.g., consent to the terms and conditions or a comment field. The action is typically used together with CheckoutConfirm on the order overview page. Usage example
Useful on the order overview page to display a checkbox to the customer for consent to the terms and conditions, which must be accepted before submitting the order.
Parameters Error codes Related modules, variables & methods Example showing how a terms and conditions checkbox is embedded as a free checkout field.

CheckoutSetCustomerData

With this action, additional customer data is set in the checkout. The fields are loaded dynamically from the configuration and can be grouped or ungrouped. Usage example
Useful in the checkout to query configured customer data fields (e.g., company name, phone) that go beyond the standard address.
Parameters Related modules, variables & methods Example showing how grouped customer data fields are rendered dynamically and errors are output field-specifically:

CheckoutPseudoCCSelect

With this action, the customer selects one of their saved pseudo credit cards for the current order process. The action is exclusively relevant for the Computop credit card integration. Usage example
Useful in the checkout when the customer wants to use a previously stored credit card without re-entering the card data. The value 0 stands for “do not use a saved card”.
Parameters Related modules, variables & methods Example showing how saved credit cards are displayed for selection, including the option to use no card.

CheckoutNewsletterSubscribe

With this action, a customer is subscribed to the newsletter during the order process. It works analogously to the NewsletterSubscribe action — parameters, error codes, and field-passing behavior are identical. Usage example
Useful in the checkout to give customers the option of subscribing to the newsletter during the order process, for example via a checkbox on the order overview page.
Parameters Error codes Related modules, variables & methods
Example showing how a customer in the checkout selects a target group and subscribes to the newsletter.

CheckoutStoreIdSelect

With this action, the customer selects a store as the pickup location for the current order process. The action is only relevant if a shipping method of type pickup has been selected. During selection, it is checked whether all products are available in the selected store. If this is not the case, the action is not executed and an error is returned.
If no store has been selected, the store from the general session selection is used by default.
Usage example
Useful when the customer wants to pick up an order directly in a store and should choose from the available Click & Collect stores in the checkout.
Error codes Related modules, variables & methods Example that shows, for each shipping method of type pickup, a dropdown with all Click & Collect-capable stores. It sets the selected store as the pickup location via CheckoutStoreIdSelect, including error handling for items not available in the selected store.