Configure a Shopify POS integration using the POS UI Extensions API to surface custom loyalty points balance and redemption during in-store checkout

domain: Shopify POS UI Extensions · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Create a Shopify POS UI Extension using the Shopify CLI and select the pos.home.tile.render and pos.checkout.action.render-before extension targets to surface the loyalty widget at checkout
  2. In the checkout extension, use the useCustomer() hook to retrieve the current customer's ID and fetch their loyalty point balance from an external loyalty API via a server-side proxy to avoid exposing API credentials
  3. Render the loyalty balance and a points redemption input in the pos.checkout.action.render-before target, displaying available redemption tiers formatted to the store's currency
  4. On redemption confirmation, apply a custom line item discount to the Shopify POS cart using the useCart() hook's applyCartDiscount method with the calculated discount amount
  5. Record the redemption event to the external loyalty system from a Shopify app proxy endpoint called by the extension, including the order ID from the useOrder() hook after checkout completes
  6. Handle offline mode gracefully by caching the last known points balance in the extension's local state with a staleness indicator shown to the cashier

Known gotchas

Related routes

Add a Customer Account UI Extension to Shopify customer account pages to render custom loyalty points content
shopify.dev · 6 steps · unrated
Implement the provider-hosted endpoint that Toast POS calls to look up and award loyalty points at checkout
toast-loyalty-integration · 5 steps · unrated
Build a Shopify POS UI extension that renders after purchase
shopify.dev · 4 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans