Checkout Releases

The following Messages have been deprecated. They will be supported until 31 October 2025:

• Payment Connector Error
• Payment Methods Received
• Multiple Payment Method Containers
• No Payment Methods
• Payment Method Not Available
• Payment Method Loading
• Payment Method Loading Error
• Payment Method Loaded
• Payment Method Selected
• Payment Method Selection Confirmation
• Payment Method Selection Confirmation Failed
• Payment Started

The following Messages have been introduced as replacements:

• ConnectorError
• PaymentIntegrationsReceived
• MultiplePaymentIntegrationContainers
• NoPaymentIntegrations
• PaymentIntegrationNotAvailable
• PaymentIntegrationLoading
• PaymentIntegrationLoadingError
• PaymentIntegrationLoaded
• PaymentIntegrationSelected
• PaymentIntegrationSelectionConfirmation
• PaymentIntegrationSelectionConfirmationFailed
• PaymentStarted

When there is an error with the selected payment method and the payment method is unavailable during the checkout process, the PaymentMethodNotAvailable Message is now generated. For example, an error can occur with the selected payment method due to locale restrictions or when an unsupported payment method is used, such as trying to use Apple Pay in a Chrome browser.

For example, if in the Cart a Shipping Method is defined but is not associated with any Line Items, you will receive the NonOrderableCartError Message.

• PaymentFailed
• PaymentCancelled
• PaymentValidationFailed

• GiftCardBalanceStarted
• GiftCardBalanceSuccess
• GiftCardBalanceError
• GiftCardBalanceRemoved
• GiftCardRedeemStarted
• GiftCardRedeemSuccess
• GiftCardRedeemError

The toggle is designed to ease your testing of the Application. We recommend activating it only for test environments.

• Billie
• BLIK
• MobilePay
• Przelewy24
• Swish
• Vipps

You can now offer your customers a broader choice of payment methods and thus improve your checkout experience.

A gift card Payment Integration should always be coupled with other Payment Integrations. This way, when your customers pay with a gift card and the balance on the card is lower than the cart's total, they can select other payment methods to pay the difference.

The Payment Only mode is ideal if you want to keep the existing checkout flow on your storefront and use Checkout's payment functionality to accept payments. In fact, the mode lets you take advantage of Checkout's secure payment capabilities without having to adjust other elements of your existing checkout experience, such as address forms or success and failure pages.

To use Checkout in Payment Only mode, you need to:

• Create at least one Application of the Payment Only type.
• Call the paymentFlow SDK method to initialize Checkout.

If required, you can create Applications of both the Payment Only type and the Complete Checkout type for the same Project but for different countries or URLs.

Checkout is now available as a built-in application in the Merchant Center. This provides easier access to the application and reduces the setup time. Previously, you had to manually install the application for each Project or Organization.

Changes:

• Added AddDiscountCodeError Message.
• Added RemoveDiscountCodeError Message.
• Added DiscountCodeNotApplicable Message.
• Added ShippingAddressMissingError Message.
• Added ShippingMethodDoesNotMatchCart Message.
• Added InvalidLocale Message.
• Added BadInputData Message.
• Added UpdatedFields Message.
• Replaced InvalidToken Message with ExpiredSession Message.
• Removed ApplicationNotFound and NoPermissionsFound Messages.

• Bancontact card
• Bancontact mobile
• Electronic Payment Standard (EPS)
• Single Euro Payments Area (SEPA)
• TWINT

You can now offer your customers a broader choice of payment methods and thus improve your checkout experience.

The activation of commercetools Checkout now happens automatically when adding Checkout to your Project as a Custom Application. This speeds up the setup process as you no longer need to contact the Checkout support team to activate Checkout.

• Apple Pay
• Google Pay
• Klarna Pay now
• Klarna Pay later
• Klarna Pay over time

By default, a custom payment method has no description and its label is the key provided by the payment Connector. Previously, you could not edit the label nor add a description. Now, you can customize the related properties like you can for standard payment methods. This helps you show your customers better text on the checkout page.

To use Checkout in Payment Only mode, you need to:

• Create at least one Application of the Payment Only type.
• Call the paymentFlow SDK method to initialize Checkout.

If required, you can create Applications of both the Payment Only type and the Complete checkout type for the same Project but for different countries or URLs.

This new feature helps you tailor the address forms and summary in your checkout experience to your business scenario.

In addition, further new messages are available to receive feedback from more events.

You can now display the commercetools Checkout UI component inline with your content, such as a custom header or footer. This gives you flexibility in managing the appearance of your checkout experience. Previously, the Checkout UI component appeared full screen and hid the content on your page, which is also the default behavior.

You can now subscribe to notifications for your PayPal payment connector. To provide notifications about the status of the payment process, PayPal uses webhooks to call back the commercetools Checkout application.

By adding a mock payment connector, you can now run your checkout flow from start to finish for test purposes or proofs of concept, with few configuration steps and without connecting to a payment service provider (PSP).

• Create a one-page checkout with minimal development effort.
• Reduce API calls; Checkout is powered by Composable Commerce for adaptability and efficiency.
• Free yourself from compliance concerns; Checkout is PCI DSS-compliant for secure payment handling.
• Integrate seamlessly with industry-leading payment service providers (PSPs).
• Customize and localize your checkout experience to display local currencies, automate regional tax calculations, and offer multi-language support.
• Create rule-based routing for personalized checkout experiences.
• Subscribe to real-time event messages for continuous improvement and enhanced customer experiences.