Product Catalog Overview
The Product Catalog API enables merchants to submit SKUs to Truemed for HSA/FSA eligibility evaluation and tracking. Once Truemed classifies a product, that eligibility data powers a richer storefront experience—surfacing Truemed as a payment option only where it’s relevant and keeping customers informed.
Why it matters
Not all products are eligible for HSA/FSA spending. By keeping Truemed up to date on your catalog, merchants unlock a richer set of integrations:
- Eligible collections — Tag and group your HSA/FSA-eligible products for dedicated landing pages, email campaigns, or storefront filters.
- PDP widget — Conditionally show or hide the Truemed widget on product detail pages based on each product’s eligibility status.
- Checkout messaging — Display “Pay with your HSA/FSA” copy on the checkout page only when the cart contains eligible items.
- Accurate checkout decisions — Prevent customers from being sent to a Truemed flow for a cart that won’t qualify.
How it works
Submit your SKUs
Call create_catalog_item for each product,
or bulk-upload via your Truemed Partner Dashboard.
Truemed evaluates eligibility
Truemed reviews and classifies each item. This happens asynchronously after submission— classification is not immediate.
Receive the result via webhook (recommended)
When a product’s eligibility status is determined or updated, Truemed sends a
product_catalog_item_eligibility_updated
webhook with the classification result. Store this status to power collections, PDP widgets,
and more.
OR: For checkout page messaging only, call
check_truemed_checkout_method
at cart assembly time to evaluate eligibility in real time—no stored status or webhook required.
Eligibility statuses
Each catalog item will receive one of the following statuses:
