Honest Money API

Honest Money Help Desk — integration reference

Reviewed November 14, 2026. This is an implementation description, not a security certification or a claim that every partner site has installed the snippets.

Two different snippets

Support widget — owned by this Help Desk: a small script adds a floating help button to a partner site. It opens the centrally hosted Help Desk in an iframe, with Helio chat and a support-ticket form.

Referral and member-journey snippet — owned by Honest Money: https://honest.money/hm.js records referral/visit information and can identify a visitor. It is a separate integration, not part of the support widget. Current ecosystem instructions are at honest.money/api.

The ecosystem footer links (Honest Money, terms, privacy and manifesto) are a third, separate concern: ordinary links do not install either script.

Install the support widget

Paste once in the site's shared footer/custom-code area immediately before </body>, so it is present on every supported page:

<script async
  src="https://help.honest.money/api/public/widget.js"
  data-ecosystem="minetxc"
  data-folder="minetxc"
  data-brand-name="mineTXC"
  data-context="mineTXC"
  data-theme="auto"
></script>

This is the mineTXC example. For the other original integrations, use these settings:

Site labeldata-ecosystemdata-folderdata-brand-name / data-context
SwapswapswapSwap
wTXCwtxcwtxcwTXC
USDCusdcusdcUSDC
mineTXCminetxcminetxcmineTXC

These are the four integration settings supplied in project chat on July 5, 2026, not a current inventory of installations or database folders. Check that the chosen folder slug still exists before installation. New sites need agreed labels and an existing routing folder; do not invent a slug.

data-folder selects an existing folder for a new ticket. If it is absent or does not match, the server falls back to topic classification. A submission may instead be added to an existing related ticket; that path does not reapply the new-ticket folder override. Folder labels may change independently of the routing slug.

The generic snippet is also available to authorized staff at Help Desk → Settings → Embed. That screen uses the address currently open in the browser: copy the published help.honest.money address for production, not a preview address.

Optional presentation settings

data-theme supports auto, light and dark. data-side selects left or right; the default is right. data-label changes the button's accessible label (default: Get help). data-bottom, data-offset and data-size accept CSS lengths. Additional color settings exist in the loader, but the basic installation does not require them.

Install only once. The loader has a page-level duplicate guard. Remove the script to remove the integration; existing support records are not deleted by uninstalling it.

What loads, and when

  1. The browser downloads the script over HTTPS from the Help Desk. The live response was verified on November 14, 2026: JavaScript, HTTP 200, five-minute public cache and Access-Control-Allow-Origin: *.
  2. The script executes in the partner page, inserts a launcher and an iframe pointing to https://help.honest.money/widget, and forwards presentation/routing settings in its query string.
  3. The iframe loads immediately, even while hidden. The widget creates a chat session on load, using document.referrer when available. Loading is not delayed until the visitor presses the button.
  4. Chat messages are stored as chat events. Escalation collects email, optional name, category, message and optional files, and creates or follows up on a ticket.

No API key is required for the public support widget. Folder, brand and ecosystem attributes are browser-supplied routing hints, not trusted proof of a site's or visitor's identity. An entered email is contact information, not verified account ownership. The widget is not a wallet authorization or consolidation-consent mechanism.

Data and privacy boundaries

The inspected support flow stores chat sessions, chat messages, contact details, ticket messages and accepted attachments centrally in the Help Desk. The iframe stores a theme preference under hm-widget-theme in browser local storage when the visitor changes theme. The loader itself does not contain referral tracking or read host-page form fields.

The support server accepts up to five attachments; accepted types include specified images, PDF, text/CSV, ZIP and Office documents, with a 20 MiB decoded per-file check. Type checks in this path are MIME-label checks; they are not evidence of malware scanning.

Helio requests are processed through the Help Desk's AI service. This review does not certify the provider's retention terms, legal basis, international transfers, production storage policies or retention/deletion schedules. Those require separate operational evidence.

The iframe gives a browser same-origin boundary, but the loader still executes in the host page and the iframe has no sandbox attribute in the inspected implementation. Do not describe the whole integration as sandboxed. The loader has no site-origin allow-list check. Its wildcard CORS header permits downloading public code; it does not grant staff access.

Public widget handlers validate input shapes and lengths, but the inspected handlers do not establish verified visitor identity or an ownership-bound session capability. This review did not verify effective rate limits, CAPTCHA, abuse controls or live row-level/realtime policies. These are specific auditor follow-up items, not certified controls.

Honest Money referral snippet

The authoritative instructions currently specify installation in the page head, once on every page:

<script src="https://honest.money/hm.js" async></script>

The live script inspected on November 14, 2026:

  • Reads and normalizes ?ref= and stores hm_ref in a Secure, SameSite=Lax cookie with a 30-day maximum age, and also in local storage.
  • Stores a browser visitor identifier as hm_vid in local storage, and visit markers in session storage.
  • Sends the visitor identifier and current page URL (limited to 900 characters), referral and visit/form/identify events to https://honest.money/api/public/hub/visit using a beacon or fetch.
  • Adds a hidden hm_ref field on form submission and can send an email found in an email field.
  • Exposes window.honestMoney.ref() and window.honestMoney.identify(memberIdOrEmail).

Important qualifications: the 30-day cookie expiry does not expire the local-storage fallback in the inspected script; a current page URL may include sensitive query parameters; the script has no visible consent gate or Do Not Track check. Cookie-domain construction uses the last two hostname labels, not a public-suffix-aware parser. Do not call this anonymous-only tracking or promise that referrals disappear after 30 days. Cookie consent, permitted pages, retention and member matching should be reviewed with the Honest Money owner. The central instructions state that unconfirmed email matches are display-only, not grounds for payouts or access; this Help Desk review has not audited the receiving service's enforcement.

Existing Help Desk APIs

InterfacePurposeAccess
/api/public/widget.jsPublic support loaderNo key
/widgetChat and ticket interfacePublic; visitor-entered contact details
/api/public/v1/ticketsRead ticket summaries, including contact name/emailPrivate Help Desk API key
/api/public/v1/tickets/{id}/notesAdd an internal notePrivate Help Desk API key

The ticket API accepts x-api-key or Authorization: Bearer and rejects a missing/incorrect key. Its code uses one Help Desk key, not per-partner scopes. Keys must stay in an approved partner's server, never a footer, browser or public document. This page does not distribute credentials, grant access, or certify that a production key is configured. The support widget does not need the private ticket API.

For ecosystem sign-in, member lookup, affiliate reporting, mailing lists and other Honest Money services, use honest.money/api, not the Help Desk ticket key. Honest Money's site-specific ecosystem keys are distinct and server-only. Member UUIDs, not email addresses, are the permanent identity key for verified sign-in.

Safe installation check

  1. Confirm the site's routing slug and approved privacy/consent treatment.
  2. Insert the support snippet once with the published URL.
  3. Check the launcher and panel on desktop and phone without submitting a ticket.
  4. With separate authorization, send a clearly labelled test ticket and confirm its destination folder; this documentation change did not perform that write.
  5. Record the installed site, settings, owner, installation date and tested version in the site's integration inventory.

Changing the centrally hosted scripts can affect every site that loads them after its cache refresh. The current support snippet is an unversioned URL without a pinned integrity hash. Cross-site rollout, rollback and script integrity are therefore audit topics. This review checked the central loader, not every site's footer, installation history or deployment process.

Sources and audit scope

  • Project chat, July 5, 2026: existing support widget confirmed; Swap/wTXC/USDC/mineTXC snippets supplied and folder routing added. This is the verified provisioning date in chat, not a proven original creation date.
  • Help Desk source: src/routes/api/public/widget[.]js.ts, src/routes/widget.tsx, src/lib/widget.functions.ts, Settings Embed section, and the two ticket API route files.
  • Live public resources checked November 14, 2026: support loader, Honest Money instructions and referral script.
  • No private ticket records, credentials, emails or member data were used for this review. No emails were sent, no records were changed and no publication was authorized by this documentation task.

The new Help Desk /api reference page is a human-readable installation guide, not a new write API. It is preview-only until separately approved and published. The live /api address returned a not-found page at the time of this review.