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 custom tender labels to InStore receipts
Customer Credit instead of the generic processor-level type GiftCard. This helps colleagues and shoppers see the payment option name that matches the one shown on the POS button. For more information, see JSON data fields for receipt templates.tenderTypeLabel in the payment option request body, its value is exposed in the receipt data model. The default Sales receipt, Refund receipt, and Nullified Payment receipt templates include this value, represented by the type key. If the payment option does not include tenderTypeLabel, InStore uses the tender type associated with the payment processor. Existing custom templates are not updated automatically; include {{type}} to display the label.Introduced ability to replace Cart, Catalog, and Customer modules in InStore POS
You can assign an external module to the environment, a location, or a workstation.
Added a Cancel button to the InStore credit stepper
Added delegated refunds across sales channels in InStore
Delegated refunds support split tendering, partial refunds, and multiple payment methods. This includes refunds for orders paid with a different payment method than the one being refunded. You can also specify fallback alternatives for refunds that the original payment processor cannot process, for example a returned gift or a canceled credit card.
Deprecated the InStore device CLI
Locations and devices that were previously added using the InStore device CLI are unaffected.
Added QR codes on printed receipts in InStore
- a loyalty enrollment or survey URL
- an order or voucher number for fast, error-free returns
- a fiscally required signature string
- free text
Introduced Swedish rounding for cash transactions
Up, Down, Half-Up, Half-Down, and None. Use the Cash_Rounding_Mode administration parameter in the InStore Center to configure cash rounding settings.Added comments to cash management workflows
Comments can be shown on cash management receipts and reviewed in the InStore Center Cash Count Audit. This gives retailers more context for cash management activities and supports financial loss prevention processes.
To display comments on cash management receipts, include comments in your cash management receipt templates.
Added support for sharing a cash drawer across workstations
Previously, a workstation could open a cash drawer only through its default printer. This meant that the workstation default printer and the printer connected to the cash drawer had to be the same device.
InStore now triggers the cash drawer pulse through the printer assigned to the drawer instead of the workstation default printer. This lets multiple workstations share a single cash drawer located between them, even if each workstation uses a different default printer for receipts.
Introduced InStore POS with advanced frontend theming
InStore POS:
- Is hosted and maintained by commercetools.
- Offers export capabilities and sales reporting that support fiscal requirements in supported locales.
- Retains the same flexibility and composability as the modular, self-hosted approach to InStore, letting you focus on the component capabilities that set you apart from your competitors while using pre-composed capabilities out of the box.
Advanced frontend theming lets you align the InStore POS with your existing user experience, including color palette, typography, component styling, and responsive layout behavior. You can author a theme as a JSON payload and deliver it through the InStore Theming API without frontend code changes or redeployments.
To learn more about InStore POS, contact your Customer Success Manager.
InStore now supports delegated Payment creation
This allows you to pass Payment and Transaction data, including Custom Fields, directly from the payment processor so InStore payments can better align with your other checkout integrations. It also helps make the tender flow more resilient when connection issues occur during payment processing.
integrationConfiguration.delegatePaymentCreation to true when you create a Credit payment processor. Existing payment processors keep their current behavior unless you enable this configuration.Added fiscalization support for commercetools InStore in Germany
Through an integration with Fiscal Solutions, commercetools InStore provides fiscal signing and receipt data for sales from your connected retail stores in Germany.
Contact your commercetools representative for details about fiscalization support for Germany in commercetools InStore.
Added support for composable tender extension in InStore
This lets you support bespoke or non-standard payment methods, such as:
- Redeemed rebates and coupons.
- DTMF (Dual-Tone Multi-Frequency) payments.
- Customer-saved cards in an online account.
- Trade-ins.
- Empty-container-collection credit.
- Other tenders that you define.
success or cancel result to InStore. After the module task is complete, InStore persists the payment to your commercetools project as usual.Added the Detail_Count_Denomination_Sort_Order administration parameter
Detail_Count_Denomination_Sort_Order administration parameter. Use it to control the sort order of denominations displayed during cash counts, safe deposits, and bank deposits in the InStore colleague app.Ascending, bill and coin denominations are sorted with the lowest value at the top of the page. When the parameter is set to Descending, they are sorted with the highest value at the top. Denominations are only displayed in the InStore colleague app if the Summary_or_Detail_Count administration parameter is set to detail.Enhanced payment capabilities for InStore are now generally available
You can configure flexible in-store payment options to match your business processes. Supported payment options include cash, bank cards (credit and debit, including private-label and trade-account cards), stored-value cards, pay-on-account (account on file), region-specific benefits, custom payments, and digital wallets such as buy now, pay later (BNPL) services.
Introduced enhanced payment capabilities for InStore available in early access
You can configure flexible in-store payment options to match your business processes. Using new InStore APIs, you define processors and payment options, apply business rules including repeat tenders, and support multiple payment types at checkout. Supported payment options are cash, bank cards (credit and debit, including private-label cards), stored value, trade account (account on file), region-specific benefits, and third-party payment accounts such as buy now, pay later (BNPL) services and digital wallets.
To use the feature, create processor and payment option pairs with the provided APIs. Configure labels, icons, and the sequence of tender buttons, and choose whether options are available globally or restricted to specific locations and workstations.
Early access allows you to evaluate new features before they are released to the public beta or general availability. You can also provide feedback directly to our product teams. Please note that early access features are not intended for use in production projects.
If you’d like to try this feature and access the documentation, please reach out to your Customer Success Manager (CSM).
Introduced the Localization tab in the Environment settings of the InStore Center
After you set the environment currency, it remains fixed and you cannot change it. To change the default locale, choose one of the supported languages at the location level.
Supported_Languages administration parameter. As this setting is now managed on the Localization tab, the Supported_Languages administration parameter has been removed.Improved configuration checks for the InStore CLI
The InStore CLI now provides default values for some required fields and validates your configuration file to ensure all required data is present. This reduces setup errors and speeds up device configuration.
Introduced customization for payment stepper messages
Added the Maximum_QuickPay_Cash_Options administration parameter for InStore
Maximum_QuickPay_Cash_Options administration parameter so you can set how many auto-generated QuickPay cash buttons appear on the Cash payment screen.By default, up to six locale-specific denomination buttons are shown. You can change this to any value from 1 to 9 based on the cash amounts your store most frequently receives. QuickPay reduces typing and promotes speed and accuracy by letting the store associate tap the presented amount instead of entering it manually.
Added the Allow_Manage_Cash and Allow_Manage_Devices administration parameters for InStore
Allow_Manage_Cash and Allow_Manage_Devices administration parameters.As managing cash and devices are administrative tasks that are not optimized for mobile operations, this enhancement allows you to simplify mobile workstations by hiding areas irrelevant to users.
Added the moneyBoxInjection styling override for the Totals box
moneyBoxInjection styling override, for example, to display loyalty benefits or applied discounts. This improves the user experience for your in-store colleagues and customers as colleagues can use the displayed information to understand how the total amount was calculated.Enhanced theme options for Pay On Account payments
You can now control the theming of the company name, authorized purchaser, account IDs, payment amount, and purchase order number fields for Pay On Account payments in InStore. This lets you align these labels and input elements with your brand for a consistent checkout experience.
InStore is now available on GCP Belgium
Deprecation of the logo area of the InStore Center
The logo area in the Theme tab of the Environment page of the InStore Center is now deprecated. To print your logo on receipts, refer to the documentation provided by your printer manufacturer.
Added the `Pay_on_Account_Displayed_Info` administration parameter for InStore
Pay_on_Account_Displayed_Info administration parameter, you can now choose to hide or display business account fields when using Pay on Account as a tender type.By default, the following fields are displayed:
CustomerNumberExternalIDCompanyPaymentAccountIDs
Use this parameter to hide fields that aren't relevant or to prevent duplicating information already displayed in the InStore colleague app.
Updated the InStore Center UI to clarify which environments an administration user can manage
Introduced ability to prompt store colleagues for input during the payment process of custom payment integrations
We've introduced the ability for your external systems to request input from store colleagues by displaying customizable pop-up messages directly within the payment UI during a custom payment integration. This helps you resolve mid-payment issues, such as a printer running out of paper or the need to confirm a customer's ID, without interrupting the ongoing payment process.
You can tailor these prompts to deliver specific instructions to store associates, ensuring smoother operations and fewer interruptions.
Added versioning and search for parameter sets and receipt template sets
Added Prompt_for_Purchase_Order_POA administration parameter
Prompt_for_Purchase_Order_POA administration parameter. When Prompt_for_Purchase_Order_POA is set to true, the InStore colleague app prompts store associates to enter a purchase order (PO) number during Pay on Account checkouts.Added ability to format order numbers in the InStore Center
We've added two new fields to the InStore Center to give you greater control over how order numbers are generated for InStore carts:
- Cart Key Prefix: add an alphanumeric prefix to each order number.
- Cart Key Sequence Length: define the length of the numeric sequence portion of the order number.
Introduced bulk-loading devices for a predefined location
New custom URL access for the InStore colleague app
You now access the InStore colleague app using a custom URL based on the following format:
{host site}/{environment name}/{location ID}/{workstation ID}
You can configure a locked browser per workstation with its own direct URL for faster and more secure access.
Introduced ability to edit the button that displays the exact amount due on the Quick Pay by cash screen of the InStore colleague app
Relabel_QuickPay_ExactAmount.Introduced multi-select options for receipt delivery in InStore
inStoreCore-receiptChoice event and the Allow_Defaulted_Customer_Email_Override and Allow_Defaulted_Customer_Phone_Override administration parameters.Allowing multiple receipt delivery options can improve customer satisfaction and save costs by using existing communication modes.
Added support for the `inStoreCore-screenChange` event to monitor usage and alerts in the InStore colleague app
inStoreCore-screenChange event to record the paths that store associates take while using the InStore colleague app. You can also customize alert text and listen for alerts of varying severity.InStore is now available in GCP North America and Australia
Improved the templates for gift, sales, and refund receipts and introduced the `Prompt_for_Gift_Receipt` parameter
Prompt_for_Gift_Receipt parameter, which enables you to select a checkbox to generate a gift receipt during checkout or when reprinting a payment receipt. For more information about how to use this parameter, see Administration parameters.Introduced the ability to override the default styling of product modules in InStore
You can now override some default styles of InStore product modules. This helps minimize the training time of store associates and encourages adoption by retaining familiar terminology, action button layout, and branding that is consistent with your existing point-of-sale or checkout process.
Changed InStore payment processing to be asynchronous
We have changed the InStore payment processing method to asynchronous. With asynchronous payment processing, customers get more time to interact with the payment device. It also helps reduce server traffic and conserves memory.
Added `Simulate_Cashdrawer` to administration parameters
Simulate_Cashdrawer administration parameter to virtually mimic opening and closing a cash drawer during cash management and transaction activities. By using this feature, you can run test or demo transactions without having a physical cash drawer connected to your workstation.Simulate_Printer administration parameter. By separating them into two different parameters, we support more test environment and demo use cases where you can use a physical printer, but a simulated cash drawer.commercetools InStore achieved general availability status
commercetools InStore leverages your existing Composable Commerce Project to extend your online store into physical locations, such as bricks-and-mortar stores, pop-up shops, showrooms, and customer service desks.
By using commercetools InStore, your store associates can:
- Take in-person sales and place delivery orders in a single transaction.
- Accept payments and issue refunds according to your business rules using cash, credit or debit cards, stored-value cards, gift certificates, store credit, digital wallet, pay by link, and custom payment types such as benefits entitlement and pay on account.
- Accept in-person returns and exchanges for merchandise purchased in any channel, and convert unreceipted to receipted returns within the InStore colleague app with Composable Commerce as the single source of truth.
- Manage your payment ecosystem and devices, including mobile, tablet, and desktop workstations, printers, PEDs, cash drawers, scanners, and integrated or virtual store safes.
- Print and reprint physical receipts, provide gift receipts, and enable digital receipt options for your customers.
- Track and audit cash securely in the InStore colleague app.
- Apply item-, cart-, or customer-level promotions, discounts, and coupons—automatically or manually—to your customer's cart at checkout.
- Access shopping lists and wishlists across channels to let your customers browse online and purchase in store, or create shopping lists in store and purchase items online at a later time.
- Optimize product knowledge with in-app item catalog access, to ensure they have all the information they need for your customers.
- Move in-flight carts between workstations or store associates, such as from mobile assisted selling to fixed checkout, or for manager override.