Hantera Storefront SDK

Appearance

Cart Module ​

The cart module provides a complete client for Hantera's cart and checkout APIs, including real-time SSE event subscriptions.

Import ​

ts
import { createCartClient } from '@hantera/storefront-sdk/cart'

Creating a Client ​

ts
const cart = createCartClient({
  baseUrl: 'https://core.your-instance.hantera.cloud',
})

Lifecycle ​

  1. Create a cart with a cart profile key and locale
  2. Subscribe to events for real-time cart updates via SSE
  3. Add items by product number and quantity
  4. Set customer info — email, phone, address, optional invoice address override
  5. Submit payment by POSTing to the PSP app's payment ingress (see Checkout)
  6. Cart completes automatically when payment is confirmed

Real-time Updates ​

All mutation methods return the updated cart state directly, so you can update your UI immediately from the response. SSE subscriptions are optional but useful for syncing state across multiple tabs or when other actors (e.g. payment webhooks) update the cart.

The cart supports Server-Sent Events (SSE) for real-time state synchronization:

ts
const eventSource = cart.subscribeToCartEvents(cartId, {
  onInit: (cartData) => {
    // Full cart state on connection
  },
  onUpdate: (cartData) => {
    // Cart state after mutations
  },
  onError: (data) => {
    // Application-level errors
  },
  onConnectionError: (event) => {
    // Connection lost
  },
})

// Clean up when done
eventSource.close()

See the API Reference for the full method list.

Checkout ​

Once items are in the cart and customer info is set, the storefront initiates payment by calling the PSP app's payment ingress. Each PSP app exposes its own HTTP endpoint with its own request and response shape — see the per-provider guides: