Marketplace

Marketplace

The marketplace uses Square Catalog as source of truth for products, prices, and variations.

Storefront behavior

• Product cards and detail pages read from the local cache populated from Square.
• Pricing and checkout are tied to Square variation IDs.
• Checkout creates a Square Payment Link using catalog_object_id.

Sync behavior

• Catalog items can be synced from Square into cache tables.
• Website-only metadata can be preserved during sync (for example slug and featured flags).

Checkout behavior

• Quantity is supported from 1 to 99.
• Payment flow redirects to Square-hosted checkout.
• Webhooks are validated and stored for idempotency/debugging.