Mark a checkout session as viewed

Records last_viewed_at/view_count. Not a “checkout complete” signal — order status/payment state is never driven by this.

POST/checkout_sessions/{id}/view

Authorization

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstringrequired

Responses

200

Checkout session

tokenstring

statusstring

order_idinteger

return_urlstring | null

Where the buyer is redirected after a hosted-redirect-mode gateway round-trip (see storefronts headless-reference.md). Set at most once per session lineage — the first non-blank return_url given to POST /orders/{order_id}/checkout_session wins; later calls while the same session is still active are ignored. Carried forward automatically if the session is later forked due to a stale cart total.

expires_atstring<date-time>

last_viewed_atstring<date-time> | null

view_countinteger

checkout_urlstring

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (JWT)Remember on this deviceInclude my values in samples

Parameters

idpath*

Request

curl -X POST 'https://api.onbolder.com/v2/checkout_sessions/string/view' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://api.onbolder.com/v2/checkout_sessions/string/view", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.post(
    "https://api.onbolder.com/v2/checkout_sessions/string/view",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json"
    },
)

Response

{
  "token": "string",
  "status": "string",
  "order_id": 0,
  "return_url": "string",
  "expires_at": "2019-08-24T14:15:22Z",
  "last_viewed_at": "2019-08-24T14:15:22Z",
  "view_count": 0,
  "checkout_url": "string"
}