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):

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 the checkout.* webhook events.

Monitor in the dashboard

Dashboard → Checkout groups everything checkout-related: Analytics, Checkout Wallets, Transactions, Product, Checkout Sessions, and 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.