# Integrate in your shop

Source: https://gokarla.io/docs/guides/resolve/integrate-in-your-shop

# Integrate in your shop

Resolve pages embed into your shop website through the Karla
[Browser SDK](/docs/platform/browser-sdk) — a single script tag plus a
container div.

## Embed the resolve widget

Add a container div and the bundle script to the page where you want the
resolve flow to render, and set `data-starter-page="resolve"` so the SDK
loads the resolve entry point:

```html
<div id="karla-container"></div>
<script
  id="karla-bundle"
  src="https://browser.gokarla.io/latest/bundle.min.js"
  data-shop-slug="my-shop-slug"
  data-starter-page="resolve"
></script>
```

Replace `my-shop-slug` with your own shop slug (find it in the
[portal](https://portal.gokarla.io/) under your shop profile).

For all supported script attributes, order lookup methods, debug options, and
advanced configuration, see the [Browser SDK](/docs/platform/browser-sdk)
reference.

## Test your embed

Once the page is published (e.g. `https://your-shop-domain/resolve`), add
order identifiers as URL parameters to preview a real resolution flow:

- ZIP code lookup: `https://your-shop-domain/resolve?orderNumber=00001&zipCode=10119`
- Token-based lookup: `https://your-shop-domain/resolve?orderNumber=00001&token=abc123`

:::tip Tokens unlock extra actions on the order
When you link to the resolve page with a **token** instead of a ZIP code,
Karla treats the visitor as authenticated for that specific order. We
reserve advanced, order-scoped operations (things like cancellation flows
and similar sensitive actions) for token-authenticated sessions, and the
set of capabilities behind the token keeps growing over time.

Token lookup is **enabled by default** on every shop (Shopify and others),
and every notification Karla sends — including the resolve page URL in
shipping emails — already carries the token for that order. You can also
retrieve a token-protected URL for any order through our public
[API](/docs/api-reference), so you can embed secure deep links in your own
emails, flows, or support tools.
:::

## Skip issue selection

If you want to route customers directly into a specific resolution flow
(e.g. a "Report damaged item" link that goes straight to the defective
flow), add the `flowType` URL parameter:

- `?flowType=defective`
- `?flowType=notReceived`
- `?flowType=missingProduct`
- `?flowType=wrongProduct`
- `?flowType=return`
- `?flowType=dissatisfiedWithProduct`
- `?flowType=support`

## Using the API directly

If you'd rather build your own resolve UI from scratch, see the
[Claims API](/docs/api-reference).