Start or resume a storefront checkout intent

post

https://api.scalev.com/v3/stores/{store_id}/public/checkout-intents

The path store unique ID and Storefront API key define the capture scope. Use a stable form_widget_id chosen by your storefront. Requires a reCAPTCHA token for action checkout_intent_start. Repeating client_session_id resumes the unfinished attempt without replacing saved snapshots; PATCH with last_sequence + 1 to save new input. A completed session returns 409; create a new client_session_id after checkout succeeds. A valid optional cip_ prefill token resumes its matching unfinished attempt; invalid or mismatched prefill tokens fall back to the client session. Capture failures must not block checkout.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

store_id

string

required

Store unique_id.

Body Params

recaptcha_token

string

required

length ≥ 1

reCAPTCHA token for action checkout_intent_start.

client_session_id

uuid

required

Browser-persistent random UUID scoped to the page or storefront checkout; not a guest-cart token.

checkout_intent_prefill_token

string

Optional cip recovery capability. Invalid or mismatched tokens fall back to clientsession_id.

form_widget_id

string

required

length between 1 and 200

Stable identifier chosen by the storefront, for example storefront-checkout.

fields

object

items

array of objects

length ≤ 100

items

attribution

object

source_url

uri | null

Current checkout URL. Sensitive query parameters and fragments are stripped. Recovery links are only issued for trusted source origins.

cart_id

integer | null

≥ 1

Headers

X-Scalev-Storefront-Api-Key

string

required

Publishable storefront public API key for the target store. Page public API keys are not accepted on Storefront public routes.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

201New or resumed checkout intent and write capability.

400Malformed request.

403Checkout intent is not included in the active business subscription, or authorization failed.

404Source API key is missing or invalid, source was not found, or checkout intent does not belong to this source.

409The checkout intent is completed.

422Invalid capture fields, item references, sequence, form widget, or reCAPTCHA assessment.