humanity.llc Create

Feature 12

Merch funnel & QR customizer

Scan curiosity → branded QR on wear → Shopify checkout.

Partial /shop/ Tier 0 + /shop/customize/ Tier 1; operator gates live checkout

About this feature

Why it matters

Physical merch is distribution for the live QR primitive — curiosity on a hoodie leads to create, customize, and wear your own programmable object. The value is changing resolver state over time, not scan analytics. Users never touch Printify; checkout stays branded on humanity.llc.

Design decisions

Funnel: scan live wear → signed profile → create card → /shop/customize/ preview (LIVE OBJECT QR band) → POST /v1/store/artifact-intents → Shopify cart metadata → paid webhook → Printify middleware mints unique print_artifact QR. Tier 0 founding stickers at /shop/ skip the customizer. Scan CTA uses hc_ref=scan_customize.

Safety · privacy · security

Commerce never grants vouch or human verification. Scan bearer warning + product copy stay honest: holding printed wear does not prove ownership. Artifact intent holds no private keys.

Limits

Engineering rollout ships in repo (merch-funnel:rollout:step1step6). Live Tier 1 checkout requires operator shop-config.json, one paid order proof, and physical ink QA (docs/MERCH_FUNNEL_MVP.md).

Future directions

Full story-row catalog (~50 SKUs), stranger wear funnel QA, order timeline UI for stewards, seasonal resolver states for wearable objects.