> ## Documentation Index
> Fetch the complete documentation index at: https://www.commercengine.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# POS

> TypeScript SDK for the Commerce Engine POS API — in-store selling, device pairing, cart management, and order capture.

<Note>
  **Detailed guides are coming soon.** The POS API and `@commercengine/pos` are complete and usable today — the POS application itself is still in development. If you want to build on POS now, [get in touch](mailto:support@commercengine.io) and we'll help you get set up.
</Note>

`@commercengine/pos` is the TypeScript SDK for the Commerce Engine POS API. It covers the in-store selling surface: staff authentication, device pairing, cart and customer management, coupons and loyalty, fulfillment, and order capture.

## Available today

<CardGroup cols={2}>
  <Card title="POS API reference" icon="code" href="/docs/api-reference/pos/login-with-email">
    Every POS endpoint, with request and response schemas and an interactive playground.
  </Card>

  <Card title="Package on npm" icon="box" href="https://www.npmjs.com/package/@commercengine/pos">
    Install `@commercengine/pos` and read the published changelog.
  </Card>
</CardGroup>

## What the API covers

| Area                 | What it does                                                                       |
| -------------------- | ---------------------------------------------------------------------------------- |
| Authentication       | Staff login by email, phone, or WhatsApp, OTP verification, and logout             |
| Device management    | Pair, claim, and unclaim POS devices; refresh device access tokens                 |
| Cart management      | Create and retrieve carts, add and remove items, set the cart customer and address |
| Coupons & promotions | List, evaluate, apply, and remove coupons and promotions                           |
| Loyalty & credits    | Redeem and remove loyalty points and store credit                                  |
| Catalog              | Browse categories, products, variants, SKUs, and search                            |
| Fulfillment          | Retrieve fulfillment options, set preferences, and list locations                  |
| Orders & payments    | Create orders and retrieve payment status                                          |

## Installation

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
npm install @commercengine/pos
```

<Tip>
  POS runs on its own authentication model — staff sessions and paired devices, not storefront customer sessions. Do not reuse Storefront API keys or customer tokens against POS endpoints.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Talk to us about POS" icon="envelope" href="mailto:support@commercengine.io">
    Tell us what you're building and we'll walk you through the integration.
  </Card>

  <Card title="Storefront SDK" icon="store" href="/docs/sdk/installation">
    Building a customer-facing storefront instead? Start here.
  </Card>
</CardGroup>