For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
HomeGuidesAPI Reference
HomeGuidesAPI Reference
  • Payment Sessions
    • Payments Overview
    • Manual/Delayed Capture
    • Itemized Fees and Discounts
  • Implementation
    • Stripe Custom Payment Method
    • iFrame Payment Session
  • Product Catalog
    • Overview
      • Build HSA/FSA-Eligible Collections
      • Conditionally Show the PDP Widget
      • Checkout Page Messaging
    • Managing Your Catalog
  • Qualification Sessions
    • Update a Qualification Session
  • Direct Substantiation
    • Overview
    • TPA Guide
    • Employers Guide
    • Platforms Guide
  • Subscriptions
    • Overview
    • Create a Subscription (New Subscriber)
    • Create a Subscription (Existing Subscriber)
    • Subsequent Billing Periods
    • Partner Administrative Operations
  • Resources
    • Webhooks
    • Developer Tools
LogoLogo
On this page
  • Why this matters
  • How to build it
  • 1. Listen for eligibility updates
  • 2. Tag eligible products
  • 3. Build your collection
  • 4. Keep it up to date
  • Checking item status on demand
Product CatalogUse Cases

Build HSA/FSA-Eligible Collections

Was this page helpful?
Previous

Conditionally Show the PDP Widget

Next
Built with

Once Truemed has classified your SKUs, you can use that eligibility data to build dedicated HSA/FSA collections on your storefront. A curated “Shop with your HSA/FSA” collection lowers friction for health-conscious shoppers and surfaces products they may not have known were covered.

Why this matters

Customers often don’t know which products qualify for HSA/FSA spending. A dedicated collection or filtered category page gives them a clear starting point—and a reason to spend their pre-tax dollars with you before the benefit year ends.

Common use cases:

  • A “Shop HSA/FSA Eligible” collection page or landing page
  • A storefront filter (“Show only HSA/FSA eligible items”)
  • Email or marketing campaigns targeting HSA/FSA holders near year-end

How to build it

1. Listen for eligibility updates

Subscribe to the product_catalog_item_eligibility_updated webhook. Each time an item’s status changes, Truemed will send a payload with the SKU and its new eligibility status.

Store the eligibility status alongside each product in your system (e.g., in a product metafield, database column, or tag).

2. Tag eligible products

When you receive a webhook where data.object.eligibility is eligible or eligible_with_lmn, mark that product in your catalog as Truemed-eligible. When you receive eligibility: ineligible, remove that tag.

3. Build your collection

Use the eligibility tags to drive a filtered collection page, a storefront segment, or a marketing audience—whatever the platform supports.

4. Keep it up to date

Eligibility can change as Truemed refines its classifications. Continue listening to the webhook and updating your tags in real time so your collection always reflects the current state.

Checking item status on demand

If you need to look up a specific product’s current status outside of a webhook (e.g., during a catalog sync or backfill), use the get_catalog_item endpoint with the item’s SKU.