Get your headless store live

A practical sequence for agencies and engineering teams: connect the store, wire your backend, then embed the shopper SDK.

← Headless hub

  1. 1. Connect your store

    Accept your Merchant Portal invite or work with your Merly agency contact to activate your store.

  2. 2. Publish catalog policy

    Call POST /api/v1/merchant/catalog/publish (write:catalog) or use Merchant Portal → Store Settings.

  3. 3. Create API keys

    Merchant Portal → Integrations. For backend ingest, include write:catalog, write:customers, and write:orders.

  4. 4. Link customers on signup

    POST /api/v1/merchant/customers/link when your auth system creates a shopper account.

  5. 5. Report paid orders

    POST /api/v1/merchant/orders when payment is captured so shoppers earn Merly credits.

  6. 6. Embed the storefront SDK

    Add merly.v1.js with your store key and data-platform=headless on product, cart, and account pages.

Merchant Portal

Merchants complete Getting Started, Store Settings, and Integrations in the portal after accepting an invite.

Open Merchant Portal →