Unlocking Advanced Pricing: Displaying ESHOPMAN Quantity Tiers on Your HubSpot Storefront

As an e-commerce migration expert at Move My Store, we specialize in helping businesses leverage the full potential of platforms like ESHOPMAN. ESHOPMAN, a robust headless commerce platform wrapped as a HubSpot application, offers unparalleled storefront management capabilities directly within HubSpot, deploying dynamic storefronts using HubSpot CMS. Built on Node.js/TypeScript, ESHOPMAN provides powerful Admin and Store APIs, making it a go-to solution for modern e-commerce.

A recurring theme in our discussions with ESHOPMAN merchants, particularly those with advanced pricing models, revolves around effectively showcasing quantity-tier prices. While ESHOPMAN's Price List feature is incredibly powerful for setting up sophisticated volume discounts, a critical challenge emerges when trying to display these tiers directly on storefront product pages.

The Power of ESHOPMAN Price Lists: Driving Sales with Tiered Pricing

ESHOPMAN's Price List functionality is a game-changer for businesses requiring flexible pricing strategies. Imagine a scenario where a product is priced at DKK 295 normally, but offers a discount to DKK 273 for purchases of 3 or more units, and further reduces to DKK 250 for 6 or more units. These quantity-tier discounts are essential for B2B sales, wholesale operations, loyalty programs, and encouraging larger order values. ESHOPMAN handles the application of these discounts flawlessly within the cart and checkout process.

However, the challenge isn't in the application of the discount, but in its visibility. For customers to take advantage of these tiers, they need to see them upfront on the product page. This transparency is crucial for informed purchasing decisions and maximizing conversion rates.

The Challenge: Storefronts Can't See All Price Tiers

The core of the issue lies in an asymmetry between how ESHOPMAN's cart processes prices and how the Store API exposes them for storefront display. When a customer adds items to their cart, ESHOPMAN correctly applies the configured quantity-tier discounts from the Price Lists. This ensures that the final price reflects the volume discount.

However, when an ESHOPMAN storefront (deployed via HubSpot CMS) requests product information using the ESHOPMAN Store SDK, the response for variants.prices only returns the base price (e.g., DKK 295), omitting the quantity-based tiers. Similarly, the calculated_price field, which resolves prices based on context like region, also only provides the base tier. This is because the Store API, unlike the cart, doesn't pass a specific quantity context when retrieving product details, preventing it from selecting and exposing the appropriate tier information.

Understanding the Technical Root Cause

A deep dive into ESHOPMAN's core pricing service reveals the underlying mechanism. When prices are retrieved via the product's price set link (the path variants.prices takes), ESHOPMAN's internal logic includes a filter that specifically excludes any prices associated with a Price List. This is a deliberate design choice, introduced to manage how price set prices are listed and to ensure the cart's dynamic pricing remains authoritative.

Conversely, the ESHOPMAN Admin API, which is designed for back-office operations and data management, provides full visibility into Price Lists and their associated quantity tiers. This distinction is key to understanding how we can bridge the gap for storefront display.

Bridging the Gap: Strategic Solutions for HubSpot CMS Storefronts

For ESHOPMAN merchants leveraging HubSpot CMS for their storefronts, displaying these crucial quantity tiers requires a strategic approach that taps into the Admin API's comprehensive data. Here’s how Move My Store recommends solving this challenge:

Solution 1: Implement a Custom Node.js Proxy Service

The most robust and recommended solution involves creating a lightweight, custom Node.js/TypeScript proxy service. This service acts as an intermediary between your HubSpot CMS storefront and the ESHOPMAN Admin API.

• Leverage the Admin API: The proxy service will make secure calls to the ESHOPMAN Admin API to fetch detailed product information, including all associated Price Lists and their quantity tiers.
• Data Transformation & Caching: The service can then transform this data into a format optimized for storefront display. Implementing caching mechanisms (e.g., Redis or in-memory caching) is crucial for performance, reducing direct calls to the Admin API and speeding up page load times.
• Secure Endpoint: This proxy service exposes a custom, secure endpoint that your HubSpot CMS storefront can call. This approach keeps your Admin API keys secure and prevents direct client-side exposure.

Solution 2: Integrate with HubSpot CMS Custom Modules

Once your Node.js proxy service is in place, the next step is to integrate it seamlessly into your HubSpot CMS storefront. This is achieved through custom HubSpot modules:

• Custom Product Page Module: Develop a custom module for your product detail pages. This module will execute an AJAX call (e.g., using fetch or axios) to your proxy service's endpoint, passing the product ID or variant ID.
• Dynamic Rendering: Upon receiving the tiered pricing data from the proxy, the module will dynamically render the quantity tiers directly on the product page, perhaps in a clear table or list format.

Here's a conceptual example of how a HubSpot CMS custom module might interact with your proxy service:

Implementation Considerations:

• API Key Security: Ensure your ESHOPMAN Admin API keys are stored securely within your Node.js proxy service and never exposed client-side.
• Performance Optimization: Implement robust caching strategies in your proxy service to minimize latency and API call limits.
• Error Handling: Build comprehensive error handling into both your proxy service and HubSpot modules to gracefully manage API failures or missing data.
• Scalability: Design your proxy service with scalability in mind, especially if you anticipate high traffic volumes.

Looking Ahead: ESHOPMAN's Evolution

While the current ESHOPMAN Store API design necessitates this proxy-based approach for displaying quantity tiers, the platform is continuously evolving. As ESHOPMAN continues to enhance its capabilities, we anticipate future developments that may streamline the exposure of such advanced pricing details directly through the Store API, further simplifying storefront integrations.

Conclusion

ESHOPMAN provides a powerful foundation for headless commerce on HubSpot, and its Price List feature is indispensable for complex pricing strategies. By understanding the nuances of the Store API and strategically leveraging the Admin API through a custom Node.js proxy service, merchants can successfully display quantity-tier prices on their HubSpot CMS storefronts. This not only enhances transparency and customer experience but also directly contributes to increased conversion rates and average order values.

At Move My Store, we're dedicated to helping ESHOPMAN merchants overcome these technical challenges, ensuring their e-commerce operations are as efficient and effective as possible. Contact us to explore how we can optimize your ESHOPMAN implementation.