Discover our combined Release Notes page and stay updated with the latest features and improvements! Get comprehensive details on all updates, quickly find specific updates and enhancements with our new search and filter options, and easily browse through different versions and sections.
Added payload to some payment Messages
paymentReference
property. This helps debugging and provides better tracking of payment transactions.Introduced gift card Messages
Added 'skipPaymentSuccessPage' and 'skipPaymentErrorPage' properties for the 'checkoutFlow' method
checkoutFlow
method, you can now skip showing the payment success and payment error pages that appear by default. To do so, you must pass the skipPaymentSuccessPage
and skipPaymentErrorPage
configuration properties and set them to true
. The properties are independent of each other, so you can pass just one of them, or both.Introduced removal of not applicable Discount Code from Cart for Payment Only mode
paymentFlow
method, Checkout now removes a Discount Code from the Cart if the code does not apply to the Cart. This prevents order creation errors when converting the Cart to an Order.Introduced ability to let any URL communicate with an Application
The toggle is designed to ease your testing of the Application. We recommend activating it only for test environments.
New payment methods available via Adyen
- Billie
- BLIK
- MobilePay
- Przelewy24
- Swish
- Vipps
You can now offer your customers a broader choice of payment methods and thus improve your checkout experience.
Introduced gift card Connectors in public beta
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.
Introduced 'reloadPaymentMethods' method and FailedToRefreshSession Message
paymentFlow
method, you must now call the reloadPaymentMethods
method to create a Checkout Session and display the new Cart's total price.Payment Only mode achieved general availability status
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.
Introduced 'merchantReference' field for Payment Intent Actions
merchantReference
field to communicate an identifier of your choice for the payment to the payment service provider (PSP), for example, to send an invoice number.Payment Only mode supports multiple Shipping Methods in public beta
Introduced Checkout Transactions API in public beta
Introduced custom Order numbers in Checkout Sessions in public beta
futureOrderNumber
field, and it is then stored in the Composable Commerce Order entity.Introduced 'correlationId' field in Messages
correlationId
field, which helps you with debugging and message traceability. To receive Messages containing this field, you must use the latest version of the Checkout Browser SDK.Checkout is now a built-in Merchant Center application
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.
Introduced drop-in Payment Integration Type in public beta
Introduced new locales and added a payment method for the sample payment Connector
Updated the Messages sent by commercetools Checkout
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
andNoPermissionsFound
Messages.
New payment methods available via Adyen
- 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.
Automated the activation of commercetools Checkout
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.
New payment methods available via Adyen
- Apple Pay
- Google Pay
- Klarna Pay now
- Klarna Pay later
- Klarna Pay over time
Introduced the customization of labels and descriptions for custom payment methods
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.
Introduced payment method predicates in public beta
For example, you can set a predicate to display PayPal among the available payment methods only if the amount of the cart is at least 10 Euro.
Introduced Payment Only mode in public beta
In fact, the mode lets you take advantage of Checkout's secure and seamless 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.
Payment Connectors from Connect supported and changes to the Checkout SDK
Introduced confirmation of permissions and subscription in public beta
commercetools Checkout is now available on Google Cloud Sydney
Introduced the customization of address forms and address summary
Additionally, you can customize the address summary to match your custom address forms.
This new feature helps you tailor the address forms and summary in your checkout experience to your business scenario.
Introduced Checkout Payments API in beta
Deprecated configuration fields and new messages
sellerId
, applicationId
, and callbackUrl
configuration fields are now deprecated. You now need to use the projectKey
, applicationKey
, and returnUrl
fields respectively. The new DeprecatedFields message will warn you if you use any of the deprecated fields.
Also, following the deprecation, the ProjectIsDeactivated message replaced the SellerIsDeactivated one, while a standard CORS error in the browser will replace the SellerNotFound message.
In addition, further new messages are available to receive feedback from more events.
Introduced invoice payment connector
To activate payment by invoice on your checkout page, configure the invoice payment connector and then set the payment method in your application.
Added the 'showTaxes' and 'currencyLocale' configuration properties
showTaxes
configuration property.currencyLocale
configuration property.Introduced inline rendering of the commercetools Checkout UI component
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.
Changed the formatting of dynamic parameters
{PARAMETER_NAME}
instead of {{PARAMETER_NAME}}
.Subscribing to PayPal notifications is now supported
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.
Added toggle to activate or deactivate the discount codes field
Introduced mock payment connector
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).
commercetools Checkout achieved general availability status
- 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.