{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Alyte","description":"Sell to AI shopping agents — safely. Alyte enforces the buyer's mandate server-side and settles on your own PSP.","colors":{"primary":"#0F766E","light":"#2DD4BF","dark":"#115E59"},"logo":{"light":"https://mintcdn.com/alyte/zYPVEfYM19CTXhPe/images/alyte-lockup-node-teal.webp?fit=max\u0026auto=format\u0026n=zYPVEfYM19CTXhPe\u0026q=85\u0026s=c4801890c6a8513cc24fd83c61be4cf8","dark":"https://mintcdn.com/alyte/zYPVEfYM19CTXhPe/images/alyte-lockup-node-white.webp?fit=max\u0026auto=format\u0026n=zYPVEfYM19CTXhPe\u0026q=85\u0026s=41468f54c007cd474ab4f49099b77db9","href":"https://alytegen.com"},"favicon":"https://mintcdn.com/alyte/BZL4f73XKlkywFem/favicon.svg?fit=max\u0026auto=format\u0026n=BZL4f73XKlkywFem\u0026q=85\u0026s=779eb8caa2f4893510fda1316c49c5e8","footer":{"socials":{}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"alyte","hasAudioNarration":false,"actualSubdomain":"alyte","customDomains":[],"gitSource":{"type":"github","owner":"chris-alytegen","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aebd3771b42271a81b4b3db","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":102},{"language":"default","tag":"API","count":102},{"language":"default","tag":"integration","count":45},{"language":"default","tag":"buyer","count":27},{"language":"default","tag":"Guides","count":23},{"language":"default","tag":"ticketing","count":10},{"language":"default","tag":"Selling and fulfilling","count":9},{"language":"default","tag":"Start here","count":6},{"language":"default","tag":"The buyer hand-off","count":5},{"language":"default","tag":"acp","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat","slug":"/api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat","pageMetadata":{"title":"Create a checkout session (quote + reserve a real held seat)","description":null,"deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /acp/checkout_sessions","href":"/api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat","autogeneratedByOpenApi":true},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a checkout session (quote + reserve a real held seat)","description":null,"deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /acp/checkout_sessions","href":"/api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a checkout session (quote + reserve a real held seat)","tags":["acp"],"requestBody":"6966c193-c0c7-4b9f-8ed7-4de59adfe355","responses":{"200":"de82bce3-f00c-47cf-ae67-5dcbde472e16"},"method":"post","type":"path","servers":["d984a407-c637-4e20-a599-c5e1d93843df"],"security":["9b841fa4-77bc-4acc-b2c6-e8717704352c"],"path":"/acp/checkout_sessions","baseUrlOptions":["/"],"title":"Create a checkout session (quote + reserve a real held seat)","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].id","typeLabel":"string"},"quantity":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"\\items.items.[INDEX].quantity","typeLabel":"integer"}},"required":["id","quantity"],"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"\\items","typeLabel":"object[]"},"buyer":{"type":"object","properties":{"name":{"type":"string","uniqueKey":"buyer.name","typeLabel":"string"},"email":{"type":"string","uniqueKey":"buyer.email","typeLabel":"string"},"phone":{"type":"string","uniqueKey":"buyer.phone","typeLabel":"string"}},"uniqueKey":"buyer","typeLabel":"object"}},"required":["items"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"items":[{"id":"\u003cstring>","quantity":123}],"buyer":{"name":"\u003cstring>","email":"\u003cstring>","phone":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"de82bce3-f00c-47cf-ae67-5dcbde472e16":{"description":"Default Response","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"9b841fa4-77bc-4acc-b2c6-e8717704352c":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"d984a407-c637-4e20-a599-c5e1d93843df":{"url":"/","description":"this instance"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://app.alytegen.com/openapi.public.json"},"subdomain":"alyte","siteName":"Alyte","title":"Create a checkout session (quote + reserve a real held seat) - Alyte","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T00:53:15.717Z","originalFileLocation":"api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Alyte\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/alyte/_6KiA9xTSyg78EnN/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/alyte/_6KiA9xTSyg78EnN/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/alyte/_6KiA9xTSyg78EnN/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/alyte/_6KiA9xTSyg78EnN/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/alyte/_6KiA9xTSyg78EnN/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/alyte/_6KiA9xTSyg78EnN/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/alyte/_6KiA9xTSyg78EnN/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/alyte/_6KiA9xTSyg78EnN/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/alyte/_6KiA9xTSyg78EnN/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a checkout session (quote + reserve a real held seat) - Alyte\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Alyte\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://alyte.mintlify.app/api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://alyte.mintlify.site/_mintlify/api/og/v2?division=acp\u0026amp;title=Create+a+checkout+session+%28quote+%2B+reserve+a+real+held+seat%29\u0026amp;theme=ce031e5908e28e8d97a02809\u0026amp;signature=ff6a3ba1828519716acba381d23d9ec6db2697b3ac33c2c62492661f01d3e516\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a checkout session (quote + reserve a real held seat) - Alyte\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://alyte.mintlify.site/_mintlify/api/og/v2?division=acp\u0026amp;title=Create+a+checkout+session+%28quote+%2B+reserve+a+real+held+seat%29\u0026amp;theme=ce031e5908e28e8d97a02809\u0026amp;signature=ff6a3ba1828519716acba381d23d9ec6db2697b3ac33c2c62492661f01d3e516\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/alyte/_6KiA9xTSyg78EnN/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Alyte\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F766E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://alyte.mintlify.app/api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/acp/create-a-checkout-session-quote-%2B-reserve-a-real-held-seat.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://alyte.mintlify.app/#organization\",\"name\":\"Alyte\",\"url\":\"https://alyte.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/alyte/zYPVEfYM19CTXhPe/images/alyte-lockup-node-teal.webp?fit=max\u0026auto=format\u0026n=zYPVEfYM19CTXhPe\u0026q=85\u0026s=c4801890c6a8513cc24fd83c61be4cf8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://alyte.mintlify.app#website\",\"name\":\"Alyte\",\"url\":\"https://alyte.mintlify.app\",\"publisher\":{\"@id\":\"https://alyte.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://alyte.mintlify.app/api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat#webpage\",\"url\":\"https://alyte.mintlify.app/api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat\",\"name\":\"Create a checkout session (quote + reserve a real held seat)\",\"dateModified\":\"2026-11-05T00:53:15.717Z\",\"isPartOf\":{\"@id\":\"https://alyte.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://alyte.mintlify.app/api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://alyte.mintlify.app/api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API\",\"item\":\"https://alyte.mintlify.app/api-reference/catalog/list-merchants-tenant-scoped-catalogue\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a checkout session (quote + reserve a real held seat)\",\"item\":\"https://alyte.mintlify.app/api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://alyte.mintlify.app/api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat#apireference\",\"headline\":\"Create a checkout session (quote + reserve a real held seat)\",\"name\":\"Create a checkout session (quote + reserve a real held seat)\",\"url\":\"https://alyte.mintlify.app/api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat\",\"mainEntityOfPage\":{\"@id\":\"https://alyte.mintlify.app/api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat#webpage\"},\"dateModified\":\"2026-11-05T00:53:15.717Z\",\"publisher\":{\"@id\":\"https://alyte.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://alyte.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Alyte\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Alyte","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"API","pages":[{"group":"catalog","pages":[{"title":"List merchants (tenant-scoped catalogue)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/merchants","href":"/api-reference/catalog/list-merchants-tenant-scoped-catalogue"},{"title":"Fetch one merchant by id","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/merchants/{id}","href":"/api-reference/catalog/fetch-one-merchant-by-id"},{"title":"List the vaulted instruments the agent may spend from","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/instruments","href":"/api-reference/catalog/list-the-vaulted-instruments-the-agent-may-spend-from"},{"title":"A merchant's events + tiers (with availability)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/merchants/{id}/events","href":"/api-reference/catalog/a-merchants-events-+-tiers-with-availability"}]},{"group":"payments","pages":[{"title":"One-shot authorize a payment (mandate-gated)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/payments","href":"/api-reference/payments/one-shot-authorize-a-payment-mandate-gated"},{"title":"One-shot deterministic checkout by SKU (mandate-gated · 201 authorized · 402 refused)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/checkout","href":"/api-reference/payments/one-shot-deterministic-checkout-by-sku-mandate-gated-·-201-authorized-·-402-refused"},{"title":"Fetch a payment result (tenant-scoped)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/payments/{intentId}","href":"/api-reference/payments/fetch-a-payment-result-tenant-scoped"},{"title":"Run the in-process Alyte agent over a natural-language goal (needs ANTHROPIC_API_KEY)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/agent/run","href":"/api-reference/payments/run-the-in-process-alyte-agent-over-a-natural-language-goal-needs-anthropic_api_key"}]},{"group":"ticketing","pages":[{"title":"Lock a price (price-locked quote, has a TTL)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/quotes","href":"/api-reference/ticketing/lock-a-price-price-locked-quote-has-a-ttl"},{"title":"Reserve (oversell-proof hold on a tier)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/holds","href":"/api-reference/ticketing/reserve-oversell-proof-hold-on-a-tier"},{"title":"Confirm — pay the locked quote total, confirm the hold (201 settled · 202 payment/SCA pending · 402 refused)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/holds/{holdId}/confirm","href":"/api-reference/ticketing/confirm-—-pay-the-locked-quote-total-confirm-the-hold-201-settled-·-202-paymentsca-pending-·-402-refused"},{"title":"Reserve a multi-line basket atomically (all-or-nothing across lines and shared pools, with linkRule and add-on mandate enforcement)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/reservations","href":"/api-reference/ticketing/reserve-a-multi-line-basket-atomically-all-or-nothing-across-lines-and-shared-pools-with-linkrule-and-add-on-mandate-enforcement"},{"title":"Fetch a basket reservation and its lines (tenant-scoped)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/reservations/{reservationId}","href":"/api-reference/ticketing/fetch-a-basket-reservation-and-its-lines-tenant-scoped"},{"title":"Release a held basket reservation and return all lines to inventory","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json delete /v1/reservations/{reservationId}","href":"/api-reference/ticketing/release-a-held-basket-reservation-and-return-all-lines-to-inventory"},{"title":"Lock a single price-lock quote across all held lines of a basket reservation","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/reservations/{reservationId}/quotes","href":"/api-reference/ticketing/lock-a-single-price-lock-quote-across-all-held-lines-of-a-basket-reservation"},{"title":"Confirm a basket reservation as one charge (201 settled · 202 payment/SCA pending · 402 refused)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/reservations/{reservationId}/confirm","href":"/api-reference/ticketing/confirm-a-basket-reservation-as-one-charge-201-settled-·-202-paymentsca-pending-·-402-refused"},{"title":"Resolve a pending SCA challenge and resume","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/reservations/sca/{continueToken}/resolve","href":"/api-reference/ticketing/resolve-a-pending-sca-challenge-and-resume"},{"title":"Resolve a pending SCA challenge and resume","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/sca/{continueToken}/resolve","href":"/api-reference/ticketing/resolve-a-pending-sca-challenge-and-resume-1"}]},{"group":"protocols","pages":[{"title":"A2A JSON-RPC message/send — invoke the Alyte agent as a peer-agent skill (agent JWT, agent:run)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /a2a","href":"/api-reference/protocols/a2a-json-rpc-messagesend-—-invoke-the-alyte-agent-as-a-peer-agent-skill-agent-jwt-agent:run"},{"title":"MCP endpoint (Streamable HTTP) — the same buy-path tools over the Model Context Protocol (agent JWT, agent:run)","description":null,"deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /mcp","href":"/api-reference/protocols/mcp-endpoint-streamable-http-—-the-same-buy-path-tools-over-the-model-context-protocol-agent-jwt-agent:run"}]},{"group":"acp","pages":[{"title":"Create a checkout session (quote + reserve a real held seat)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /acp/checkout_sessions","href":"/api-reference/acp/create-a-checkout-session-quote-+-reserve-a-real-held-seat"},{"title":"Retrieve session state","description":null,"deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /acp/checkout_sessions/{id}","href":"/api-reference/acp/retrieve-session-state"},{"title":"Update a session (change quantity → re-quote/reserve)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /acp/checkout_sessions/{id}","href":"/api-reference/acp/update-a-session-change-quantity-→-re-quotereserve"},{"title":"Complete — charge the shared payment token via the merchant PSP (confirm)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /acp/checkout_sessions/{id}/complete","href":"/api-reference/acp/complete-—-charge-the-shared-payment-token-via-the-merchant-psp-confirm"},{"title":"Cancel a session (release the hold)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /acp/checkout_sessions/{id}/cancel","href":"/api-reference/acp/cancel-a-session-release-the-hold"}]},{"group":"vic","pages":[{"title":"VIC purchase-initiate: buy a tier under a Visa Intelligent Commerce mandate (mandate governs spend server-side)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /vic/purchase","href":"/api-reference/vic/vic-purchase-initiate:-buy-a-tier-under-a-visa-intelligent-commerce-mandate-mandate-governs-spend-server-side"}]},{"group":"signed-mandate","pages":[{"title":"Network signed-mandate purchase: buy a tier under a signature-verified network mandate (VIC / Mastercard Agent Pay shape)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /mandate/signed/purchase","href":"/api-reference/signed-mandate/network-signed-mandate-purchase:-buy-a-tier-under-a-signature-verified-network-mandate-vic-mastercard-agent-pay-shape"}]},{"group":"buyer","pages":[{"title":"Request a sign-in link for a shop — emails a single-use magic link (returned inline outside production)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/buyer/login","href":"/api-reference/buyer/request-a-sign-in-link-for-a-shop-—-emails-a-single-use-magic-link-returned-inline-outside-production"},{"title":"Verify the emailed 6-digit sign-in code (WorkOS Magic Auth) — sets the buyer session cookie","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/buyer/verify","href":"/api-reference/buyer/verify-the-emailed-6-digit-sign-in-code-workos-magic-auth-—-sets-the-buyer-session-cookie"},{"title":"Send a 6-digit code to the session's email so a bounded session can become full (returned inline outside production)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/buyer/step-up/send","href":"/api-reference/buyer/send-a-6-digit-code-to-the-sessions-email-so-a-bounded-session-can-become-full-returned-inline-outside-production"},{"title":"Verify the step-up code — returns a FULL buyer credential for the same buyer and shop (30 min); bearer only, never a cookie","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/buyer/step-up/verify","href":"/api-reference/buyer/verify-the-step-up-code-—-returns-a-full-buyer-credential-for-the-same-buyer-and-shop-30-min;-bearer-only-never-a-cookie"},{"title":"Exchange a single-use sign-in token for a 30-minute buyer bearer (no cookie)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/buyer/session-token","href":"/api-reference/buyer/exchange-a-single-use-sign-in-token-for-a-30-minute-buyer-bearer-no-cookie"},{"title":"The signed-in buyer + the shop their session is locked to","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/buyer/me","href":"/api-reference/buyer/the-signed-in-buyer-+-the-shop-their-session-is-locked-to"},{"title":"The session shop's events + tiers (buyer view)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/buyer/catalog","href":"/api-reference/buyer/the-session-shops-events-+-tiers-buyer-view"},{"title":"Begin adding a card — creates a setup on the SHOP'S OWN payment provider; returns the client secret + publishable key. No card data crosses this API.","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/buyer/instruments/setup","href":"/api-reference/buyer/begin-adding-a-card-—-creates-a-setup-on-the-shops-own-payment-provider;-returns-the-client-secret-+-publishable-key-no-card-data-crosses-this-api"},{"title":"Resume this buyer’s Adyen card setup after authentication","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/buyer/instruments/setup/{reference}","href":"/api-reference/buyer/resume-this-buyer’s-adyen-card-setup-after-authentication"},{"title":"Finish adding a card — re-verifies the capture session SERVER-SIDE with the provider and stores only the reference (scheme + last4), bound to this buyer","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/buyer/instruments/confirm","href":"/api-reference/buyer/finish-adding-a-card-—-re-verifies-the-capture-session-server-side-with-the-provider-and-stores-only-the-reference-scheme-+-last4-bound-to-this-buyer"},{"title":"Saved payment methods usable by a created agent (opaque tokens, never card data)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/buyer/instruments","href":"/api-reference/buyer/saved-payment-methods-usable-by-a-created-agent-opaque-tokens-never-card-data"},{"title":"Active agents in this shop's registry (picker data) — names + keyids only","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/buyer/registry","href":"/api-reference/buyer/active-agents-in-this-shops-registry-picker-data-—-names-+-keyids-only"},{"title":"How each agent platform can be used at this shop: connect (registry action) / available (platform lane live, act there) / not_yet","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/buyer/connect-options","href":"/api-reference/buyer/how-each-agent-platform-can-be-used-at-this-shop:-connect-registry-action-available-platform-lane-live-act-there-not_yet"},{"title":"MY agents with their mandates (owner-filtered server-side)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/buyer/agents","href":"/api-reference/buyer/my-agents-with-their-mandates-owner-filtered-server-side"},{"title":"Create an agent (with a saved payment method) or bring one (registry keyid; no instrument — its credential arrives per-charge)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/buyer/agents","href":"/api-reference/buyer/create-an-agent-with-a-saved-payment-method-or-bring-one-registry-keyid;-no-instrument-—-its-credential-arrives-per-charge"},{"title":"Grant a mandate to one of your agents — scope.merchants is locked server-side to the shop your session is for","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/buyer/mandates","href":"/api-reference/buyer/grant-a-mandate-to-one-of-your-agents-—-scopemerchants-is-locked-server-side-to-the-shop-your-session-is-for"},{"title":"Point an agent at a different saved card (owner-bound; the agent's mandates are preserved)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json put /v1/buyer/agents/{id}/instrument","href":"/api-reference/buyer/point-an-agent-at-a-different-saved-card-owner-bound;-the-agents-mandates-are-preserved"},{"title":"Set (or clear with capMinor: null) a spending ceiling on one of your payment methods — caps the TOTAL you can grant across all agents using it","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json put /v1/buyer/instruments/cap","href":"/api-reference/buyer/set-or-clear-with-capminor:-null-a-spending-ceiling-on-one-of-your-payment-methods-—-caps-the-total-you-can-grant-across-all-agents-using-it"},{"title":"Your instrument ceilings with how much of each is already granted","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/buyer/instruments/caps","href":"/api-reference/buyer/your-instrument-ceilings-with-how-much-of-each-is-already-granted"},{"title":"Buy a tier NOW with one of your agents — quote → hold → confirm under the agent's mandate","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/buyer/agents/{id}/buy","href":"/api-reference/buyer/buy-a-tier-now-with-one-of-your-agents-—-quote-→-hold-→-confirm-under-the-agents-mandate"},{"title":"Your queued/fired watches with their outcomes","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/buyer/watches","href":"/api-reference/buyer/your-queuedfired-watches-with-their-outcomes"},{"title":"Queue one of your agents to buy a tier the moment it goes on sale — fired under the agent's mandate","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/buyer/watches","href":"/api-reference/buyer/queue-one-of-your-agents-to-buy-a-tier-the-moment-it-goes-on-sale-—-fired-under-the-agents-mandate"},{"title":"One of your watches with its current place in the queue","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/buyer/watches/{id}","href":"/api-reference/buyer/one-of-your-watches-with-its-current-place-in-the-queue"},{"title":"Cancel a queued watch (owner-bound; fired/failed are history)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json delete /v1/buyer/watches/{id}","href":"/api-reference/buyer/cancel-a-queued-watch-owner-bound;-firedfailed-are-history"},{"title":"Watch request kinds and conditions this deployment enforces","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/buyer/watch-capabilities","href":"/api-reference/buyer/watch-request-kinds-and-conditions-this-deployment-enforces"},{"title":"Queue an agent with an explicit condition (availability or an all-in price target); idempotent on requestId","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/buyer/watch-requests","href":"/api-reference/buyer/queue-an-agent-with-an-explicit-condition-availability-or-an-all-in-price-target;-idempotent-on-requestid"},{"title":"Revoke a mandate I granted (immediate, server-side)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json delete /v1/buyer/mandates/{id}","href":"/api-reference/buyer/revoke-a-mandate-i-granted-immediate-server-side"}]},{"group":"integration","pages":[{"title":"Mint a buyer session for YOUR authenticated user — returns a single-use redeem link to drop them into the shop's authorize page (API token, merchant:write; or merchantAttested: true on a mandates:attest key for staff-enabled merchants, within their ceilings)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/buyer-sessions","href":"/api-reference/integration/mint-a-buyer-session-for-your-authenticated-user-—-returns-a-single-use-redeem-link-to-drop-them-into-the-shops-authorize-page-api-token-merchant:write;-or-merchantattested:-true-on-a-mandates:attest-key-for-staff-enabled-merchants-within-their-ceilings"},{"title":"Read-only offers, slots and observed inventory for one shop; merchant:read","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/merchants/{id}/inventory","href":"/api-reference/integration/read-only-offers-slots-and-observed-inventory-for-one-shop;-merchant:read"},{"title":"Shop location metadata; merchant:read","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/merchants/{id}/locations","href":"/api-reference/integration/shop-location-metadata;-merchant:read"},{"title":"Add optional shop location metadata with an IANA zone; merchant:write","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/merchants/{id}/locations","href":"/api-reference/integration/add-optional-shop-location-metadata-with-an-iana-zone;-merchant:write"},{"title":"Version location metadata without changing existing bindings; merchant:write","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json patch /v1/integration/merchants/{id}/locations/{locationId}","href":"/api-reference/integration/version-location-metadata-without-changing-existing-bindings;-merchant:write"},{"title":"Occurrence and its optional pinned location; merchant:read","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/merchants/{id}/slots/{slotId}","href":"/api-reference/integration/occurrence-and-its-optional-pinned-location;-merchant:read"},{"title":"Bind or clear optional location metadata without rescheduling; merchant:write","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json put /v1/integration/merchants/{id}/slots/{slotId}/location","href":"/api-reference/integration/bind-or-clear-optional-location-metadata-without-rescheduling;-merchant:write"},{"title":"Read access rules and registered membership programs","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/merchants/{id}/access","href":"/api-reference/integration/read-access-rules-and-registered-membership-programs"},{"title":"Get v1integrationmerchants accessrules","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/merchants/{id}/access/rules/{ruleId}","href":"/api-reference/integration/get-v1integrationmerchants-accessrules"},{"title":"Replace an inactive draft at the expected revision","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json put /v1/integration/merchants/{id}/access/rules/{ruleId}","href":"/api-reference/integration/replace-an-inactive-draft-at-the-expected-revision"},{"title":"Save an inactive access-rule draft","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/merchants/{id}/access/rules","href":"/api-reference/integration/save-an-inactive-access-rule-draft"},{"title":"Preview scheduling or cancellation against current evidence and queued requests","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/merchants/{id}/access/rules/{ruleId}/preview","href":"/api-reference/integration/preview-scheduling-or-cancellation-against-current-evidence-and-queued-requests"},{"title":"schedule an access rule from an unchanged preview","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/merchants/{id}/access/rules/{ruleId}/schedule","href":"/api-reference/integration/schedule-an-access-rule-from-an-unchanged-preview"},{"title":"cancel an access rule from an unchanged preview","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/merchants/{id}/access/rules/{ruleId}/cancel","href":"/api-reference/integration/cancel-an-access-rule-from-an-unchanged-preview"},{"title":"Register a merchant-attested membership program and explicit levels","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/merchants/{id}/access/programs","href":"/api-reference/integration/register-a-merchant-attested-membership-program-and-explicit-levels"},{"title":"Attest or revoke membership; source revision must increase","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json put /v1/integration/merchants/{id}/access/programs/{programId}/members/{buyerId}","href":"/api-reference/integration/attest-or-revoke-membership;-source-revision-must-increase"},{"title":"The tenant's full catalog — shops → events → tiers, with restriction fields (API token, merchant:read)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/catalog","href":"/api-reference/integration/the-tenants-full-catalog-—-shops-→-events-→-tiers-with-restriction-fields-api-token-merchant:read"},{"title":"Create a shop (API token, merchant:admin)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/merchants","href":"/api-reference/integration/create-a-shop-api-token-merchant:admin"},{"title":"Delete a shop — cascades its events, tiers, and PSP links, and shreds the PSP secret refs (API token, merchant:admin). Irreversible.","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json delete /v1/integration/merchants/{id}","href":"/api-reference/integration/delete-a-shop-—-cascades-its-events-tiers-and-psp-links-and-shreds-the-psp-secret-refs-api-token-merchant:admin-irreversible"},{"title":"Update a shop's public settings — discovery opt-in, shop image, and the embed origins (up to three partner origins allowed to frame the authorize page and call the buyer API from a browser) (API token, merchant:write)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json patch /v1/integration/merchants/{id}","href":"/api-reference/integration/update-a-shops-public-settings-—-discovery-opt-in-shop-image-and-the-embed-origins-up-to-three-partner-origins-allowed-to-frame-the-authorize-page-and-call-the-buyer-api-from-a-browser-api-token-merchant:write"},{"title":"Publish an event (API token, merchant:write)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/events","href":"/api-reference/integration/publish-an-event-api-token-merchant:write"},{"title":"Publish a ticket tier (API token, merchant:write)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/tiers","href":"/api-reference/integration/publish-a-ticket-tier-api-token-merchant:write"},{"title":"Delete a tier (API token, merchant:write)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json delete /v1/integration/tiers/{id}","href":"/api-reference/integration/delete-a-tier-api-token-merchant:write"},{"title":"Update a tier — price/stock + the server-enforced restrictions (API token, merchant:write)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json patch /v1/integration/tiers/{id}","href":"/api-reference/integration/update-a-tier-—-pricestock-+-the-server-enforced-restrictions-api-token-merchant:write"},{"title":"Atomically adjust a tier's available stock by a signed non-zero delta (API token, merchant:write). Runs a single guarded UPDATE (available_count + delta >= 0, invariant #7); for a pooled tier, adjusts its shared pool (refusing with 409 pool_capacity_exceeded if a positive delta would exceed the pool's declared capacity). Short stock returns a terminal 409 stock_insufficient ({ tierId, delta, availableCount }). Idempotent on requestId (scoped per tenant).","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/tiers/{id}/stock","href":"/api-reference/integration/atomically-adjust-a-tiers-available-stock-by-a-signed-non-zero-delta-api-token-merchant:write-runs-a-single-guarded-update-available_count-+-delta->=-0-invariant-#7;-for-a-pooled-tier-adjusts-its-shared-pool-refusing-with-409-pool_capacity_exceeded-if-a-positive-delta-would-exceed-the-pools-declared-capacity-short-stock-returns-a-terminal-409-stock_insufficient--idempotent-on-requestid-scoped-per-tenant"},{"title":"A shop's inventory pools with live availability (API token, merchant:read)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/pools","href":"/api-reference/integration/a-shops-inventory-pools-with-live-availability-api-token-merchant:read"},{"title":"Create a SHARED inventory pool — one capacity several tiers draw on (API token, merchant:write). Adult and child prices sharing one room limit; early-bird and standard sharing the floor. The pool is the oversell arbiter for every tier attached to it.","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/pools","href":"/api-reference/integration/create-a-shared-inventory-pool-—-one-capacity-several-tiers-draw-on-api-token-merchant:write-adult-and-child-prices-sharing-one-room-limit;-early-bird-and-standard-sharing-the-floor-the-pool-is-the-oversell-arbiter-for-every-tier-attached-to-it"},{"title":"Rename, re-declare capacity, or RESTOCK a pool (API token, merchant:write). availableCount sets the live remaining places for every tier on the pool; it can never exceed capacity, and capacity must also cover places still held, so raise both together when restocking past the declared number.","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json patch /v1/integration/pools/{id}","href":"/api-reference/integration/rename-re-declare-capacity-or-restock-a-pool-api-token-merchant:write-availablecount-sets-the-live-remaining-places-for-every-tier-on-the-pool;-it-can-never-exceed-capacity-and-capacity-must-also-cover-places-still-held-so-raise-both-together-when-restocking-past-the-declared-number"},{"title":"An event's per-customer ticket limit (null when it has none) and how many of its tickets the limit can count against a customer (API token, merchant:read)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/events/{id}/purchase-limit","href":"/api-reference/integration/an-events-per-customer-ticket-limit-null-when-it-has-none-and-how-many-of-its-tickets-the-limit-can-count-against-a-customer-api-token-merchant:read"},{"title":"Set the per-customer ticket limit for an event (API token, merchant:write). maxPerCustomer caps the tickets one customer can have for the event, held or bought; maxHeldPerCustomer optionally caps the unpaid tickets one customer can hold at once. PUT replaces the whole limit. The first PUT also counts the event's earlier sales: a customer already over the limit keeps their tickets but cannot buy more. Clear with DELETE.","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json put /v1/integration/events/{id}/purchase-limit","href":"/api-reference/integration/set-the-per-customer-ticket-limit-for-an-event-api-token-merchant:write-maxpercustomer-caps-the-tickets-one-customer-can-have-for-the-event-held-or-bought;-maxheldpercustomer-optionally-caps-the-unpaid-tickets-one-customer-can-hold-at-once-put-replaces-the-whole-limit-the-first-put-also-counts-the-events-earlier-sales:-a-customer-already-over-the-limit-keeps-their-tickets-but-cannot-buy-more-clear-with-delete"},{"title":"Remove an event's per-customer ticket limit (API token, merchant:write). Setting one again counts the event's sales from the start.","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json delete /v1/integration/events/{id}/purchase-limit","href":"/api-reference/integration/remove-an-events-per-customer-ticket-limit-api-token-merchant:write-setting-one-again-counts-the-events-sales-from-the-start"},{"title":"Delete an event and its tiers (API token, merchant:write)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json delete /v1/integration/events/{id}","href":"/api-reference/integration/delete-an-event-and-its-tiers-api-token-merchant:write"},{"title":"A shop's PSP links — refs and public fields only, never a secret (API token, merchant:read)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/merchants/{id}/psps","href":"/api-reference/integration/a-shops-psp-links-—-refs-and-public-fields-only-never-a-secret-api-token-merchant:read"},{"title":"Link a PSP to a shop — captures the API key to the secret store, ref only persisted (API token, merchant:write)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/merchants/{id}/psps","href":"/api-reference/integration/link-a-psp-to-a-shop-—-captures-the-api-key-to-the-secret-store-ref-only-persisted-api-token-merchant:write"},{"title":"The tenant's payments, newest first by createdAt (API token, merchant:read). Poll with ?since=\u003cISO timestamp of the newest payment you have> to fetch only newer rows; dedupe by intentId.","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/payments","href":"/api-reference/integration/the-tenants-payments-newest-first-by-createdat-api-token-merchant:read-poll-with-?since=\u003ciso-timestamp-of-the-newest-payment-you-have>-to-fetch-only-newer-rows;-dedupe-by-intentid"},{"title":"One payment with its full durable event trail (API token, merchant:read)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/payments/{intentId}","href":"/api-reference/integration/one-payment-with-its-full-durable-event-trail-api-token-merchant:read"},{"title":"List webhook endpoints — never includes secrets (API token, merchant:read)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/webhooks","href":"/api-reference/integration/list-webhook-endpoints-—-never-includes-secrets-api-token-merchant:read"},{"title":"Register a webhook endpoint for payment.settled push (API token, merchant:write). The signing secret is returned ONCE — store it like a password. Delivery is at-least-once; dedupe by eventId (the intentId). Verify: alyte-signature: t=\u003cunix>,v1=hex(hmac_sha256(secret, \"\u003ct>.\u003crawBody>\")).","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/webhooks","href":"/api-reference/integration/register-a-webhook-endpoint-for-paymentsettled-push-api-token-merchant:write-the-signing-secret-is-returned-once-—-store-it-like-a-password-delivery-is-at-least-once;-dedupe-by-eventid-the-intentid-verify:-alyte-signature:-t=\u003cunix>v1=hexhmac_sha256secret-\"\u003ct>\u003crawbody>\""},{"title":"Disable a webhook endpoint — delivery stops immediately (API token, merchant:write)","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json delete /v1/integration/webhooks/{id}","href":"/api-reference/integration/disable-a-webhook-endpoint-—-delivery-stops-immediately-api-token-merchant:write"},{"title":"Rotate an endpoint's signing secret — the new secret is returned ONCE; the old one stops verifying immediately (API token, merchant:write). Use after a secret is exposed; the endpoint id and any queued retries are preserved.","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/webhooks/{id}/rotate-secret","href":"/api-reference/integration/rotate-an-endpoints-signing-secret-—-the-new-secret-is-returned-once;-the-old-one-stops-verifying-immediately-api-token-merchant:write-use-after-a-secret-is-exposed;-the-endpoint-id-and-any-queued-retries-are-preserved"},{"title":"Send a TEST delivery to this endpoint — same signed pipeline as a real event, so you can verify your signature check before a live purchase (API token, merchant:write). Event type is `webhook.test` and carries NO payment data: never fulfil on it.","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/webhooks/{id}/test","href":"/api-reference/integration/send-a-test-delivery-to-this-endpoint-—-same-signed-pipeline-as-a-real-event-so-you-can-verify-your-signature-check-before-a-live-purchase-api-token-merchant:write-event-type-is-`webhooktest`-and-carries-no-payment-data:-never-fulfil-on-it"},{"title":"What happened to a queued purchase (API token, merchant:read). Answers the case GET /payments/{intentId} cannot: most refusals happen BEFORE a payment exists, so a failed watch has no intentId. Returns the watch, a plain-language outcome, the typed refusal reason, and the linked payment when one was produced. `deliveries` lists every webhook attempt for this watch (status/attempts/lastError), so you can tell a never-sent event from one your endpoint rejected. Note merchantFulfilment/buyerNotified are always `unknown` — Alyte records webhook DELIVERY, not whether you issued a ticket.","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/watches/{watchId}","href":"/api-reference/integration/what-happened-to-a-queued-purchase-api-token-merchant:read-answers-the-case-get-payments-cannot:-most-refusals-happen-before-a-payment-exists-so-a-failed-watch-has-no-intentid-returns-the-watch-a-plain-language-outcome-the-typed-refusal-reason-and-the-linked-payment-when-one-was-produced-`deliveries`-lists-every-webhook-attempt-for-this-watch-statusattemptslasterror-so-you-can-tell-a-never-sent-event-from-one-your-endpoint-rejected-note-merchantfulfilmentbuyernotified-are-always-`unknown`-—-alyte-records-webhook-delivery-not-whether-you-issued-a-ticket"},{"title":"DRILL-DOWN behind the purchase-outcome counts (API token, merchant:read). The insights tiles say how many attempts succeeded or were refused; this says WHICH, with the tier, quantity, typed refusal reason and timestamp — so \"Failed or refused: 3\" can be investigated without asking us to query the database. Optional ?outcome=successful|failed|pending filters. Reporting only: no buyer identity, no agent id, no card data. A `pending` row with resolvedWithoutPayment=true is NOT still in flight — its hold expired or was released and no payment was ever created.","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/merchants/{id}/attempts","href":"/api-reference/integration/drill-down-behind-the-purchase-outcome-counts-api-token-merchant:read-the-insights-tiles-say-how-many-attempts-succeeded-or-were-refused;-this-says-which-with-the-tier-quantity-typed-refusal-reason-and-timestamp-—-so-\"failed-or-refused:-3\"-can-be-investigated-without-asking-us-to-query-the-database-optional-?outcome=successful|failed|pending-filters-reporting-only:-no-buyer-identity-no-agent-id-no-card-data-a-`pending`-row-with-resolvedwithoutpayment=true-is-not-still-in-flight-—-its-hold-expired-or-was-released-and-no-payment-was-ever-created"},{"title":"SELF-TEST your integration (API token, merchant:write) — answers \"is my wiring correct?\" without clicking through the buyer page in a frame. Checks the shop, that a payment provider is linked AND its stored credential resolves, that something is buyable, that a webhook endpoint is registered, and sends one REAL signed test delivery to confirm your endpoint accepts it. NO purchase is attempted: a synthetic buy would bill you on the append-only event log and consume real ticket stock, so this proves the wiring a charge depends on, not that a charge will authorize. Each failing check carries a concrete remediation.","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /v1/integration/merchants/{id}/selftest","href":"/api-reference/integration/self-test-your-integration-api-token-merchant:write-—-answers-\"is-my-wiring-correct?\"-without-clicking-through-the-buyer-page-in-a-frame-checks-the-shop-that-a-payment-provider-is-linked-and-its-stored-credential-resolves-that-something-is-buyable-that-a-webhook-endpoint-is-registered-and-sends-one-real-signed-test-delivery-to-confirm-your-endpoint-accepts-it-no-purchase-is-attempted:-a-synthetic-buy-would-bill-you-on-the-append-only-event-log-and-consume-real-ticket-stock-so-this-proves-the-wiring-a-charge-depends-on-not-that-a-charge-will-authorize-each-failing-check-carries-a-concrete-remediation"},{"title":"Agent adoption + watch demand for a shop (API token, merchant:read): agents created under your account (total / by kind / ready-to-buy) and per-tier watch queue counts — how many buyers are in line or waiting for a drop. Counts only, never buyer identities.","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/integration/merchants/{id}/insights","href":"/api-reference/integration/agent-adoption-+-watch-demand-for-a-shop-api-token-merchant:read:-agents-created-under-your-account-total-by-kind-ready-to-buy-and-per-tier-watch-queue-counts-—-how-many-buyers-are-in-line-or-waiting-for-a-drop-counts-only-never-buyer-identities"}]},{"group":"discovery","pages":[{"title":"Public shop window (no auth): events + tiers with price and live availability state. Only for shops that opted in (discoverable).","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/discovery/merchants/{id}","href":"/api-reference/discovery/public-shop-window-no-auth:-events-+-tiers-with-price-and-live-availability-state-only-for-shops-that-opted-in-discoverable"},{"title":"ACP product feed (JSONL, no auth) for an opted-in shop — one item per ticket tier. ETag/If-None-Match supported.","deprecated":null,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json get /v1/discovery/merchants/{id}/feed.jsonl","href":"/api-reference/discovery/acp-product-feed-jsonl-no-auth-for-an-opted-in-shop-—-one-item-per-ticket-tier-etagif-none-match-supported"}]},{"group":"ap2","pages":[{"title":"Unsupported legacy AP2 purchase — verified checkout authorization is not available","deprecated":true,"version":null,"openapi":"https://app.alytegen.com/openapi.public.json post /ap2/purchase","href":"/api-reference/ap2/unsupported-legacy-ap2-purchase-—-verified-checkout-authorization-is-not-available"}]}]}]}]},"basePath":"","title":"Create a checkout session (quote + reserve a real held seat) - Alyte","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}
