Input
BuyerInput
Buyer details for an unauthenticated checkout. Required when the caller is not signed in and the target product or activity allows guest checkout. Ignored when the caller is signed in. The server finds an existing user by email or creates a new one inline; when createAccount is true (the default), a magic-link email is sent so the buyer can claim the account.
Fields
emailString!nameStringcreateAccountBooleanWhether to send a magic-link sign-in email to the buyer so they can claim and manage the account that was created on their behalf. Defaults to true.
countryStringBuyer's destination address, used for tax calculation. Required when the seller has tax collection enabled and the line items aren't all in-person services (which use the activity location instead). ISO 3166-1 alpha-2 country code.
regionStringISO 3166-2 region (state / province / etc.) sub-code.
postalCodeStringPostal or ZIP code. Required for sub-region precision in the US.
botChallengeTokenStringBot-challenge token, obtained by the client-rendered bot-challenge widget on the guest checkout / registration sheet (site key from Services.botChallenge.siteKey). Verified server-side before any account / participant row is created or any PaymentIntent is minted — the primary bot defense for the anonymous guest path (issues #2455 / #2456). Only meaningful on the unauthenticated guest branch; ignored for signed-in callers. Optional in the schema so the field can ship ahead of the client widget and so verification stays fail-open until the platform bot-challenge secret is configured. Provider-neutral; the current provider is Cloudflare Turnstile.