Skip to main content
Version: 2023.3

Basic Configuration

The configuration takes place in the pimcore_ecommerce_framework.checkout_manager configuration section and is tenant aware.

pimcore_ecommerce_config:
checkout_manager:
tenants:
_defaults:
# the following two values are default values an can be omitted
# service ID of a checkout manager factory which builds cart specific checkout managers
factory_id: Pimcore\Bundle\EcommerceFrameworkBundle\CheckoutManager\CheckoutManagerFactory

# options passed to the factory - available options vary by implementation
factory_options:
class: \Pimcore\Bundle\EcommerceFrameworkBundle\CheckoutManager\V7\CheckoutManager
handle_pending_payments_strategy: Pimcore\Bundle\EcommerceFrameworkBundle\CheckoutManager\V7\HandlePendingPayments\CancelPaymentOrRecreateOrderStrategy

# commit order processor
commit_order_processor:
# order processor service ID
id: Pimcore\Bundle\EcommerceFrameworkBundle\CheckoutManager\V7\CommitOrderProcessor

# options passed to the commit order processor - available options vary by implementation
options:
confirmation_mail: /en/emails/order-confirmation

# define different checkout steps which need to be committed before commit of order is possible
steps:
deliveryaddress:
class: \Pimcore\Bundle\EcommerceFrameworkBundle\CheckoutManager\DeliveryAddress

# example step from the Ecommerce demo, which extends AbstractStep
confirm:
class: \App\Ecommerce\Checkout\Confirm

default:
# define payment provider which should be used for payment.
# payment providers are defined in payment_manager section.
payment:
provider: qpay

paypal:
payment:
provider: paypal

Following elements are configured:

  • Service ID and options of the checkout manager factory: The Checkout Manager is a central player of the checkout process. It checks the state of single checkout steps, is responsible for the payment integration and also calls the commit order processor in the end. As the a checkout manager is specific to a cart instance, checkout manager factory takes care of creating checkout managers on demand.
    • Optional configuration option handle_pending_payments_strategy defines strategy how to handle pending payments. See Integrating Payment for details.
  • Checkout steps and their implementation: Each checkout step (e.g. Delivery address, delivery date, ...) needs a concrete checkout step implementation. The implementation is responsible for storing and validating the necessary data, is project dependent and has to be implemented for each project.
  • Service ID and options of the commit order processor: When finalization of the order is done by the commit order processor. This is the places, where custom ERP integrations and other project dependent order finishing stuff should be placed.
  • Additional stuff like: