> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://doc.cheddar.biz/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://doc.cheddar.biz/_mcp/server.

# Checkout links & sessions

A **checkout** is a payable order with a hosted URL you share with a buyer. A
**session** is one payment attempt against a checkout on a specific token/chain.

## Create a checkout (API)

`POST /checkouts` with line items and an `idempotencyKey` (safe to retry):

```bash
curl -X POST https://api.cheddar.biz/v1/checkouts \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "items": [{ "sku": "TSHIRT", "priceUsd": "25.00", "quantity": 1 }],
    "idempotencyKey": "order-12345"
  }'
```

The response includes `hostedUrl` — the link you share with the buyer. Optional
`successUrl` / `cancelUrl` redirect the buyer after payment, and
`expiresInSeconds` (1h–7d) sets link expiry.

## Sessions

When the buyer picks a token, create a session with
`POST /checkouts/:id/sessions`. It returns a `depositAddress`, `chain`, and
`token` — the buyer sends funds to that address.
Track progress with [checkout webhook events](/webhooks/checkout).

## Monitor in the dashboard

**Dashboard → Checkout** groups everything checkout-related: **Analytics**,
**Checkout Wallets**, **Transactions**, **Product**, **Checkout Sessions**, and
[**Invoices**](/guides/invoices).

**Analytics** (`/dashboard/checkout/analytics`) is the landing tab: total held in
checkout wallets, sales and refunds across today / yesterday / last 7 days / this
month / lifetime, plus sales and unique-buyer trends over a selectable window.

**Checkout Sessions** (`/dashboard/checkout/sessions`) is a
read-only view of checkouts and their sessions: status, product, price, hosted
URL, deposit address, and amount required vs received.

![Checkout sessions list with hosted URL column](/_fern-files/_img/81f927226dee4717e605a4fa4a8422f25f792d4077eaf1f31170b1e98c109bc0.webp)