✦ Case Study, Magento 2 Upgrade & Custom Modules

Luxury Jewellery eCommerce — UK
Magento 2 Upgrade with Live Metals Pricing
BNPL Integration & Custom Modules

Modernizing a legacy luxury jewellery platform with real-time precious metals pricing intelligence, seamless Humm BNPL financing, professional Stripe document rendering, and a fully optimized Magento 2.4.6-p2 experience for a UK brand established in 1977.

2.4.6
Magento Upgrade
Live
Metals Pricing API
Humm
BNPL Integration
Custom
Pricing Modules
Scroll to explore

Overview

A UK-based luxury jewellery manufacturer and retailer, established in 1977, offering premium men's and women's collections — heavy gold chains, diamond necklaces, engagement rings, bracelets, pendants, and iced-out pieces. All products carry UK hallmark stamps, insurance valuations, and authenticity certificates, serving a discerning clientele through both a physical retail presence and a Magento-powered eCommerce platform.

eSparks led the full Magento 2.4.6-p2 upgrade and platform enhancement — stabilizing the platform, restoring design integrity, and introducing advanced pricing and checkout capabilities that the legacy setup could not support. Key deliverables included:

  • Full Magento 2.4.6-p2 upgrade — all third-party extensions updated for compatibility, custom code refactored to align with new framework APIs, zero breaking changes to existing functionality
  • Live metals pricing module — custom integration with a third-party REST API delivering real-time gold, silver, and platinum prices to a dedicated front-end page
  • Customer-facing price calculator — interactive weight- and quantity-based calculator with admin-configurable business margin, no developer dependency for pricing updates
  • Humm BNPL integration — instalment-based payment method added to checkout with a custom product-page widget surfacing payment plan options at the point of decision
  • Stripe PDF rendering fix — unescaped HTML identified and resolved across invoice, credit memo, and shipment PDF templates for clean, professional customer documentation
  • Luxury packaging module — consistent packaging fee application across all products — including those priced via external third-party systems — enforced at cart and checkout

The Challenges

Complex Magento Upgrade

Upgrading to Magento 2.4.6-p2 on a production luxury eCommerce platform required preserving all existing custom logic, third-party integrations, and design fidelity — while eliminating technical debt accumulated in the legacy version.

  • All third-party extensions required compatibility auditing and updates
  • Custom code needed refactoring to align with revised Magento framework APIs
  • Full frontend design restoration required to prevent visual regression post-upgrade

Dynamic Precious Metals Pricing

Gold, silver, and platinum prices fluctuate continuously. The platform needed to surface live market rates directly to customers with a configurable business margin applied — without requiring developer involvement every time pricing strategy changes.

  • No existing mechanism for real-time metals price feeds on the platform
  • Business margin overlay needed to be admin-configurable, not hardcoded
  • Customer-facing calculator required for weight- and quantity-based price estimation

Payment & Document Quality Issues

Stripe-generated PDFs for invoices, credit memos, and shipments were rendering raw HTML tags as plain text — producing unprofessional customer-facing documents incompatible with the brand's luxury positioning. Additionally, the platform lacked any instalment-based payment option for high-value purchases.

  • PDF templates passing unescaped HTML strings through to rendered output
  • No BNPL payment method for customers purchasing high-ticket jewellery
  • Missing instalment visibility at the product page before checkout

Inconsistent Packaging Cost Application

Luxury packaging is a non-negotiable cost component for a premium jewellery brand. However, the existing system could not apply packaging fees consistently across products priced via Magento's native pricing and those priced through external third-party systems — creating cart and checkout discrepancies.

  • Packaging fees not applied to externally priced products at cart
  • No unified module managing packaging costs across all pricing sources
  • Risk of checkout inconsistencies affecting order totals and customer trust

The core challenge was upgrading and stabilizing a live luxury eCommerce platform without disruption — while simultaneously introducing real-time pricing intelligence, a BNPL payment method, professional PDF documents, and consistent packaging cost logic across all product types.

Our Solution

We upgraded the platform to Magento 2.4.6-p2 — refactoring custom code, updating all extensions, and restoring full design fidelity — then delivered a suite of custom modules that introduced live metals pricing, admin-controlled margin management, Humm BNPL financing, professional Stripe PDF documents, and consistent luxury packaging cost enforcement across the entire catalog.

Magento Upgrade & Platform Stability

The full platform was upgraded from the legacy version to Magento 2.4.6-p2 — addressing security patches, framework improvements, and extension compatibility across the entire stack. Post-upgrade, all third-party modules were audited, updated, and verified, and the complete frontend design was restored to a pixel-accurate match of the pre-upgrade state.

01
Full Version Upgrade to 2.4.6-p2

The Magento core, all included modules, and the PHP environment were upgraded to the target version. Security advisories and breaking changes across the upgrade path were reviewed and addressed before any work proceeded on extensions or custom code.

02
Extension Compatibility & Custom Code Refactoring

Every third-party extension was assessed for 2.4.6-p2 compatibility, updated or replaced where necessary, and re-tested against the upgraded core. All custom code was refactored to align with revised service contracts, plugin interfaces, and deprecated API replacements introduced in the target version.

03
Frontend Design Restoration

The frontend was restored to a precise match of the pre-upgrade design — resolving any layout regressions, CSS conflicts, or template changes introduced by the framework update. All pages were visually verified across device breakpoints before go-live.

Outcome: Fully stable Magento 2.4.6-p2 platform with all extensions and custom features intact, zero visual regression, and a codebase aligned with current Magento framework standards.

Live Metals Pricing Module & Customer Calculator

A custom Magento module was built to integrate a third-party REST API delivering real-time gold, silver, and platinum market prices. A dedicated “Metals Price” page surfaces live rates to customers, and an interactive calculator allows buyers to estimate product pricing by entering weight or quantity — with a business margin applied automatically from the admin panel.

01
Real-Time Metals API Integration

The custom module polls a third-party metals pricing REST API and caches current gold, silver, and platinum spot prices. Rates are refreshed on a configurable schedule, ensuring the displayed prices remain current without performance impact from every page load hitting the external API directly.

02
Dedicated “Metals Price” Page

A purpose-built front-end page displays live gold, silver, and platinum prices in customer-friendly format — increasing transparency around precious metal valuations and building buying confidence for high-value purchases.

03
Admin-Controlled Price Calculator

An interactive customer calculator accepts weight and quantity inputs and automatically calculates an estimated product price using the live metals rate plus a configurable business margin set in the Magento admin panel. Margin adjustments require no developer involvement — the admin team controls pricing strategy independently.

Outcome: Real-time precious metals pricing visible to customers at all times — improving transparency, building purchase confidence, and giving the admin team full control over pricing strategy without developer dependency.

Humm Finance BNPL Integration

Humm Finance was integrated as a fully functional BNPL (Buy Now, Pay Later) payment method within the Magento checkout — appropriate for a luxury jewellery catalog where items regularly exceed values where instalment purchasing meaningfully improves conversion. A custom product-page widget surfaces Humm instalment plan options before the customer reaches checkout.

01
Humm as Checkout Payment Method

Humm Finance was integrated into the Magento payment flow as a selectable method at checkout — with the full payment handoff, order confirmation, and return flow tested and functioning cleanly across the complete purchase journey.

02
Product Page Instalment Widget

A custom widget was built and placed on product pages to display Humm instalment plan options — showing customers their monthly payment amount at the point of purchase decision, before they reach the cart or checkout, to reduce friction around high-value items.

03
Payment Flow Issue Resolution

Existing issues in the payment flow were identified and resolved — ensuring the Humm checkout experience completes smoothly with correct order data, without payment failures or redirect errors that would result in abandoned orders.

Outcome: Instalment-based purchasing fully available at product pages and checkout — reducing the financial barrier for high-value jewellery purchases and increasing purchase flexibility for customers.

Stripe PDF Rendering Fix

Invoices, credit memos, and shipment PDFs generated via the Stripe integration were rendering raw HTML tags as visible text — producing documents unsuitable for a luxury brand. The root cause was identified as unescaped HTML strings in Magento's PDF template layer, and the fix was applied across all affected document types.

01
Root Cause Identification

The issue was traced to Stripe data containing HTML-encoded strings being passed directly into Magento PDF templates without escaping — causing raw HTML markup to appear as visible text in the rendered documents customers received.

02
Template Fix Across All Document Types

The PDF templates for invoices, credit memos, and shipment documents were updated to correctly escape and render the Stripe data fields — producing clean, professional output across all three document types without affecting any other template functionality.

Outcome: Clean, professional PDF documents for all Stripe transactions — invoices, credit memos, and shipments now render correctly, consistent with the brand's luxury positioning.

Premium Packaging Module

A custom Magento module was built to apply luxury packaging fees consistently across all products at cart and checkout — regardless of whether a product is priced via Magento's native pricing engine or through an external third-party pricing system. This eliminated the cart-total discrepancies that had previously affected externally priced items.

01
Universal Packaging Fee Application

The module applies the configured packaging fee to all qualifying products — intercepting the cart total calculation at the correct point in Magento's pricing pipeline to ensure both natively priced and externally priced products are handled consistently.

02
Cart & Checkout Consistency

Packaging costs are correctly reflected in the cart summary and carried through to the full checkout order total — ensuring the amount the customer sees in the cart matches exactly what is charged at payment, with no surprise discrepancies at the final step.

Outcome: Consistent packaging cost enforcement across all product types — accurate cart totals at all stages, eliminated checkout discrepancies, and pricing integrity maintained regardless of pricing source.

System Architecture

The platform's architecture centres on an upgraded Magento 2.4.6-p2 core with a modular custom extension layer — an API-driven metals pricing engine, a Humm BNPL payment integration, a packaging fee module spanning all pricing sources, and a corrected PDF rendering layer for all Stripe-generated documents.

Frontend — Custom Theme
Magento 2 Theme Humm Widget Metals Calculator HTML CSS / LESS JavaScript PHTML Templates
Custom Modules
Metals Price Engine Price Calculator Packaging Module PDF Template Fix Admin Margin Config
Integrations & Payments
Stripe Humm Finance (BNPL) Metals Pricing REST API PDF Generation Instalment Plans
Backend — Magento 2.4.6-p2 + PHP
Magento 2.4.6-p2 PHP MySQL Service Contracts Plugin Framework Pricing Pipeline

Metals Price Engine

Custom module integrating a third-party REST API for real-time gold, silver, and platinum spot prices — cached and refreshed on a configurable schedule for performance, surfaced on a dedicated customer-facing Metals Price page.

Admin-Controlled Price Calculator

Interactive front-end calculator accepting weight and quantity inputs, automatically applying a configurable business margin from the admin panel to the live metals rate — no developer dependency for pricing strategy changes.

Humm BNPL Integration

Full Humm Finance BNPL payment method at checkout plus a custom product-page instalment widget — surfacing monthly payment options at the point of purchase decision to reduce friction on high-value orders.

Stripe PDF Rendering Fix

Unescaped HTML identified and resolved in PDF templates for invoices, credit memos, and shipments — ensuring all Stripe-generated customer documents render cleanly and professionally.

Luxury Packaging Module

Universal packaging fee application across natively and externally priced products — intercepting the Magento pricing pipeline at the correct stage to ensure consistent cart and checkout totals regardless of pricing source.

Magento 2.4.6-p2 Upgrade

Full core upgrade with extension compatibility audit, custom code refactoring to current framework APIs, and complete frontend design restoration — delivering a stable, secure, and fully functional platform.

Results & Impact

Stable

Platform on Magento 2.4.6-p2

Live

Real-time metals pricing for customers

Humm

BNPL live at product & checkout

Clean

Professional Stripe PDFs

Consistent

Packaging costs across all product types

Business Impact

Platform fully stable on Magento 2.4.6-p2 — all extensions updated, custom code refactored, and the frontend restored to pixel-accurate match of the pre-upgrade design with zero visual regression

Real-time gold, silver, and platinum prices visible to customers at all times via the dedicated Metals Price page and interactive calculator — improving pricing transparency and buying confidence for high-value purchases

Humm BNPL live on product pages and at checkout — increasing purchase flexibility for high-ticket jewellery and reducing the financial barrier to high-value conversions through instalment-based payment option visibility

Stripe-generated customer documents now render cleanly — invoices, credit memos, and shipment PDFs free of raw HTML artifacts, consistent with the professional presentation expected of a luxury brand

Admin team controls pricing margins independently — the configurable business margin interface eliminates developer dependency for pricing strategy adjustments, with packaging costs applied consistently across all product and pricing types

Technology Stack

Magento 2.4.6-p2
PHP
MySQL
JavaScript
HTML / LESS
Stripe
Humm Finance
Metals Pricing API

Final Outcome

Before

  • Legacy Magento version with extension compatibility risk and accumulated technical debt
  • No real-time metals pricing — customers unable to see live gold, silver, or platinum rates
  • No BNPL option — customers purchasing high-ticket jewellery had no instalment payment alternative
  • Stripe PDFs rendering raw HTML — unprofessional customer documents incompatible with luxury brand expectations
  • Packaging costs not applied to externally priced products — cart total discrepancies at checkout

After

  • Fully stable Magento 2.4.6-p2 platform — all extensions compatible, custom code modernized, design fully restored
  • Live metals pricing page and interactive calculator — real-time gold, silver, and platinum rates with admin-controlled margin
  • Humm BNPL live on product pages and checkout — instalment options visible at the point of decision
  • Professional Stripe PDFs across all document types — clean invoices, credit memos, and shipments consistent with brand quality
  • Packaging fees applied consistently across all product types — accurate cart totals and zero checkout discrepancies

This project demonstrates how a luxury eCommerce platform can evolve without compromising brand identity or operational complexity. By combining advanced pricing intelligence, seamless payment flexibility, and robust Magento upgrade execution, the platform now delivers a modern, scalable, and customer-centric jewellery buying experience — built on a stable technical foundation ready for continued growth.

Looking to Upgrade Your Magento Store or Add Advanced Pricing Features?

Let's build a high-performance, scalable solution tailored to your business — from Magento version upgrades to custom pricing modules, BNPL integrations, and beyond.

Start a Conversation

Frequently Asked Questions

Why is Magento 2.4.6-p2 important for a luxury eCommerce store?

Magento 2.4.6-p2 delivers improved security patches, performance enhancements, and compatibility with modern extensions and integrations. For a luxury platform handling high-value transactions, staying on a current, supported Magento version is critical for security, PCI compliance, and ensuring all third-party payment and pricing integrations function correctly.

Running an outdated version accumulates technical debt, limits available extensions, and increases the risk of incompatibilities that can affect checkout reliability — directly impacting revenue on high-ticket items where checkout friction is particularly costly.

How does the live metals pricing integration work?

A custom Magento module polls a third-party REST API for real-time gold, silver, and platinum spot prices. The rates are cached for performance and refreshed on a configurable schedule, then surfaced to customers on a dedicated Metals Price page and through an interactive calculator.

The calculator accepts weight or quantity inputs and applies a configurable business margin set in the Magento admin panel — giving customers an estimated product price based on live market data without requiring any developer involvement when margin strategy changes.

What is Humm Finance and why was it integrated?

Humm Finance is a Buy Now, Pay Later (BNPL) payment provider that allows customers to split purchases into manageable instalments. For a luxury jewellery store where individual items regularly represent significant purchase values, offering instalment-based payment meaningfully reduces the financial barrier to conversion.

The integration adds Humm as a selectable payment method at checkout and places a custom product-page widget that shows estimated instalment amounts at the point of purchase decision — before the customer reaches the cart — to reduce hesitation around high-value items.

How was the Stripe PDF rendering issue resolved?

The issue was traced to Stripe data fields containing HTML-encoded strings that were being passed into Magento's PDF template layer without proper escaping — causing raw HTML markup to appear as visible text in rendered invoices, credit memos, and shipment documents.

The fix was applied directly to the PDF templates to correctly escape the affected Stripe data fields before rendering — producing clean, professional output across all three document types. The fix was isolated to the rendering layer with no impact on other template functionality or Stripe payment processing.

Can pricing adjustments be made without developer involvement?

Yes. The business margin applied by the price calculator is fully configurable via the Magento admin panel. The admin team can update margin percentages at any time without touching code — the calculator automatically reflects the new margin in all price estimations shown to customers.

This design was intentional: precious metals market conditions can change rapidly, and the business needed the flexibility to adjust pricing strategy in real time without waiting for developer availability.

How does the packaging module handle externally priced products?

The packaging module intercepts the Magento pricing pipeline at the cart total calculation stage — applying the configured packaging fee to all qualifying products regardless of whether their base price originates from Magento's native pricing engine or from an external third-party pricing system.

This ensures that the packaging cost is always present in the cart summary and carried through to the checkout order total consistently — eliminating the discrepancies that previously occurred when externally priced products bypassed the packaging fee logic.