Cart Module

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

Import

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

Creating a Client

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

Lifecycle

1. Create a cart with a currency and channel
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, delivery/invoice addresses
5. Submit payment through your payment provider integration
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:

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, proceed to checkout using submitPayment:

const result = await cart.submitPayment(cartId, 'stripe', {})

The SDK supports multiple payment providers through a consistent interface. See the Checkout documentation for integration guides:

• Stripe — Card payments with Stripe Elements
• Stripe Express — Apple Pay, Google Pay, Link
• Demo — Simulated payment for testing