June 5th, 2026

New

Introducing the Brink Shopper SDK

The Brink Shopper SDK is now available — a TypeScript SDK for the Brink Commerce Shopper API. Build storefronts, carts and checkouts against Brink with ease.

npm install @brinkcommerce/shopper-sdk

What it enables

  • One typed client for the whole shopper journey — sessions, carts, products, prices, stock, checkouts, and order confirmations.

  • All provider integrations covered out of the box — Adyen, Avarda, Klarna Checkout (KCO), Ledyer, Qliro (incl. upsell flow), Svea Checkout (SCO), Walley, Zaver, Custom Payment, Ingrid, NShift etc.

  • Automatic token management — session and checkout JWTs are issued, stored, and refreshed for you.

  • End-to-end TypeScript types — request and response shapes are generated from the live Shopper OpenAPI spec, so the SDK stays in sync with the API.

  • SSR-friendly — hydrate an existing session token at construction time for server-side rendering and BFF setups.

  • Helpers for common checkout edge casesisCheckoutStale and isCheckoutForPaymentProvider make it trivial to decide when to reuse a checkout vs. start a new one.

  • Predictable error handling — every non-2xx response throws a ShopperError with status code and parsed body.

Faster checkouts via smart staleness handling

The SDK ships with built-in staleness detection — isCheckoutStale compares the current session against the active checkout, and isCheckoutForPaymentProvider catches payment-provider switches. Used correctly, the storefront can reuse an existing checkout instead of calling checkouts.start() on every checkout page load. Fewer round-trips and a noticeably faster checkout for the shopper.

Why it matters

Frontend and BFF teams can now integrate Brink Shopper much faster. Less boilerplate, fewer integration bugs, and a single upgrade path that tracks the API as it evolves.

Get started

NPM Package