> ## Documentation Index > Fetch the complete documentation index at: https://quickbutik.dev/llms.txt > Use this file to discover all available pages before exploring further. # Types > The data shapes the kit returns: products, categories, the shop, carts, checkout sessions and confirmations. This page is the curated reference. The complete, generated type reference lives at [/kit/api/core](/kit/api/core) and is regenerated from the published typings. Every type here is exported from `@quickbutik/kit` and `@quickbutik/kit/sdk`. **Money is always an integer in the currency's minor unit** (öre, cents): `24900` is 249.00. The `MinorUnits` alias marks every such field. Prices include VAT. Divide by 100 or use `formatMoney`, with the currency the response states (`product.currency`, `cart.currency`). See [Currencies](/kit/concepts/currencies). ## Page ```ts theme={null} interface Page { data: T[] has_more: boolean next_cursor: string | null } ``` ## Product Prefixed, `"prod_123"`. Pass it straight to `cart.add`. Display price, minor units, in `currency`. What every price on this product is in: the client's chosen currency when the shop offers it, else the shop's own. Format with this. Absent on a platform older than the field. Merchant-authored HTML. VAT percentage: 25, 12, 6. Preferred by `buildSeo`. Optional on the wire; the variant matrix rebuilds groups from the variants when absent. A simple product has one synthetic variant. Merchant content sections, in order. Only from `products.get()`. A product has **no category membership**: a category page is `products.search({ categoryId })`. ## ProductVariant The numeric id the cart takes as `variantId`. Grams. The `id` of one of the product's own `images`, or `null`. Minor units. Falls back to `product.price` when null. The "before" price; null when not on sale. **`null` means not tracked, so purchasable.** Only a number at or below 0 is out of stock. The option values this variant is made of. ## ProductImage Absolute, without resize parameters. **Render this.** The bare storage filename. **Not a URL**; rendering it 404s. Cache-buster. `"temp"` means the file is still being processed. ## ProductOptionType and ProductOptionValue ```ts theme={null} interface ProductOptionType { id: number name: string | null // "Färg", "Storlek": merchant data, differs per product position: number | null } interface ProductOptionValue { id: number name: string | null position: number | null optionId: number | null } ``` ## ProductSection ```ts theme={null} interface ProductSection { id: string // stable render key title: string // may be empty content: string // merchant HTML; sanitize before injecting } ``` Rendered the way the Quickbutik theme renders them: template-linked sections carry the template's text, and the `[STOCKLEFT]`, `[PRICE]` and `[BEFOREPRICE]` merge tags are replaced. ## RelatedProducts `category`: up to 8 from the same category, newest first. `specific`: the merchant's hand-picked list, up to 12. `none`: always empty. `"prod_123"` Priced like the product list, discounts and campaign prices included. ## Category `"cat_12"` Bare storage filename, not a URL. Absolute. Size it with `resolveCategoryImageUrl`. Root first, to the immediate parent. Feeds a breadcrumb. `"cat_2"` The ancestor's own slug segment, not its full path. Full slug path, `"clothing/shirts"`. ## Shop The shop's own (base) currency, upper-case ISO 4217. Absent on a platform older than the field. Every currency a shopper may browse in, base first. Only the base entry when the merchant's currency converter is off; read a missing field the same way. Upper-case ISO 4217. `base`: the shop's own. `display`: shown converted, charged in the shop's currency. `charge`: priced and charged in this currency. Exported as `ShopCurrencyMode`. Units of this currency per 1 unit of the shop's currency. `"sv"` Doubles as the home page meta description. Hex, or null when never set. The merchant's tracking ids as configured in the admin, already validated by the platform. What the kit's analytics loads by default (`destinationsFromShop`). Absent on a platform older than the field. `G-…` `GTM-…` Numeric pixel id. Whether the platform sends Meta Conversions API events for this shop. Access tokens never leave the server. The wire payload also carries `demo.enabled`, not declared on the type: `true` while the shop has not activated Quickbutik Payments and its checkout runs in demo mode. ## Cart The shop's **numeric** id, what the hosted checkout URL needs. Sum of quantities, not of lines. What every amount in **this response** is in. A cart is priced per request, so the same cart can read in SEK on one request and EUR on the next. How `currency` relates to the checkout. A missing field means `mode: "base"`. `display`: amounts converted for display, the checkout charges `chargeCurrency` (the shop's own). `charge`: amounts are what the checkout will charge. What the checkout will charge in. The shop's own currency. Units of `currency` per 1 unit of `baseCurrency`. `1` for `base`. Display figure, following the shop's VAT setting. Also `subtotalExclTax`, `subtotalInclTax`. Display figure. Also `totalExclTax`, `totalInclTax`. The campaign storefront the cart is bound to. Shipping is chosen in the hosted checkout, so a cart total covers products only. ## CartItem The **line** id. The handle for `updateItem` and `removeItem`. `"Red / XL"`; null for a simple product. Absolute. Size it with `applyImageTransform`. Display figure. Also `unitPriceExclTax`, `unitPriceInclTax`. Display figure. Also `lineTotalTax`, `lineTotalExclTax`, `lineTotalInclTax`. False once the product was hidden or deleted. ## CheckoutSession Returned by `createSession()` and as `session` on a `v2` start result. `null` for an inline session created without one. The effective theme. The currency the checkout shows an approximate amount in, set when the session was created with a `"display"` currency. `null` when none applies (no currency sent, the shop's own, or a `"charge"` currency, in which case `data.pricing.value.currency` is it). Upper-case ISO 4217. Units of `code` per 1 unit of the currency the session is charged in. Shopper-supplied values with the server's verdict: `value`, `status` (`empty`, `valid`, `invalid`), `errors`, `updatedAt`. Server-computed nodes: `value`, `resolvedAt`. ## CheckoutSessionSnapshot Returned by `getSession()` and `syncCart()`. The same fields as a session (without `sessionId` and `theme`), plus: Whether the checkout can take payment. What still stands in the way. The data nodes worth reading (`CheckoutDataNodes`): | Node | Contents | | - | - | | `cart_products` | The lines as the session snapshotted them: `productId`, `variantId`, `name`, `variantName`, `price`, `quantity`, `imageUrl` | | `pricing` | Product-only subtotals, `taxOnTop`, and `currency` (what the session is priced **and charged** in), with `baseCurrency` and `exchangeRate` when that differs from the shop's own | | `order_total` | **The authoritative total**: `subtotal`, `totalTax`, `totalDiscount`, `totalShipping`, `totalPaymentFee`, `total`, `currency`, `lines` | | `shipping_cost`, `payment_cost`, `discount`, `promocode` | `OrderLine[]`: `id`, `tag`, `label`, `amount`, `taxRate`, `taxAmount` | `order_total.total` is the figure the shopper is charged. Never recompute it. ## SessionConfirmation `processing_payment`: paid, order being created (typically 6 to 17 seconds). `no_attempt`: no payment attempt known yet. ## ConfirmationOutcome ```ts theme={null} type ConfirmationOutcome = | { kind: "completed"; orderNumber: number | null; confirmation: SessionConfirmation } | { kind: "failed"; confirmation: SessionConfirmation } | { kind: "timeout"; lastStatus: ConfirmationStatus | null } // NOT a failure | { kind: "aborted" } ``` `orderNumber` can be `null` on `completed`. Fall back to `checkout.parseReturnUrl(location.href)?.orderNumber` for display. ## CurrencyInfo What `describeCurrency(shop, selected)` and `useCurrency()` resolve a currency choice to. What prices are shown in: the choice when the shop offers it, else the shop's own. `null` only before the shop is known with nothing chosen. The shop's own currency. Units of `currency` per 1 unit of the base currency. `1` for `base`. What the checkout will charge: the base currency, or `currency` in charge mode. Every currency the shop offers, base first. Empty until the shop is known. ## ConsentState The shopper's cookie decision, as `shopkit.consent.read()`, `readConsentCookie()` and the consent store report it. `ConsentSnapshot` (the store's snapshot) adds `open: boolean`, whether the preferences panel is open. Undecided is treated as denied. ISO timestamp of the decision. The cookie-policy revision the decision was made under. `ConsentCategory` is `"necessary" | "analytics" | "marketing"`; `ConsentChoice` is `{ analytics: boolean; marketing: boolean }`. See [Consent and analytics](/kit/concepts/consent-and-analytics). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.