[{"data":1,"prerenderedAt":418},["ShallowReactive",2],{"navigation_docs_en":3,"-en-storefront-third-party-storefront":230,"-en-storefront-third-party-storefront-surround":413},[4,23,41,51,65,83,202,216],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":22},"Getting started","i-lucide-rocket","\u002Fen\u002Fgetting-started","en\u002F1.getting-started",[10,14,18],{"title":11,"path":12,"stem":13},"Quick start","\u002Fen\u002Fgetting-started\u002Fquick-start","en\u002F1.getting-started\u002F1.quick-start",{"title":15,"path":16,"stem":17},"Trust model","\u002Fen\u002Fgetting-started\u002Ftrust-model","en\u002F1.getting-started\u002F2.trust-model",{"title":19,"path":20,"stem":21},"Enterprise integration journey","\u002Fen\u002Fgetting-started\u002Fenterprise-integration","en\u002F1.getting-started\u002F3.enterprise-integration",false,{"title":24,"icon":25,"path":26,"stem":27,"children":28,"page":22},"Storefront","i-lucide-store","\u002Fen\u002Fstorefront","en\u002F2.storefront",[29,33,37],{"title":30,"path":31,"stem":32},"Third-party Storefront","\u002Fen\u002Fstorefront\u002Fthird-party-storefront","en\u002F2.storefront\u002F1.third-party-storefront",{"title":34,"path":35,"stem":36},"Turnstile trust boundary","\u002Fen\u002Fstorefront\u002Fchallenge-and-turnstile","en\u002F2.storefront\u002F2.challenge-and-turnstile",{"title":38,"path":39,"stem":40},"Third-party Storefront public API","\u002Fen\u002Fstorefront\u002Fpublic-api","en\u002F2.storefront\u002F3.public-api",{"title":42,"icon":43,"path":44,"stem":45,"children":46,"page":22},"OAuth and identity","i-lucide-key-round","\u002Fen\u002Foauth","en\u002F3.oauth",[47],{"title":48,"path":49,"stem":50},"Third-party account authorization boundary","\u002Fen\u002Foauth\u002Fauthorization-code-pkce","en\u002F3.oauth\u002F1.authorization-code-pkce",{"title":52,"icon":53,"path":54,"stem":55,"children":56,"page":22},"Developer platform","i-lucide-blocks","\u002Fen\u002Fplatform","en\u002F4.platform",[57,61],{"title":58,"path":59,"stem":60},"Apps, versions, installations, and scopes","\u002Fen\u002Fplatform\u002Fapps-installations-scopes","en\u002F4.platform\u002F1.apps-installations-scopes",{"title":62,"path":63,"stem":64},"Origins, redirects, proxies, and environments","\u002Fen\u002Fplatform\u002Fsecurity-and-environments","en\u002F4.platform\u002F2.security-and-environments",{"title":66,"icon":67,"path":68,"stem":69,"children":70,"page":22},"Runtime extensions","i-lucide-workflow","\u002Fen\u002Fruntime","en\u002F5.runtime",[71,75,79],{"title":72,"path":73,"stem":74},"Installation Webhooks","\u002Fen\u002Fruntime\u002Fwebhooks","en\u002F5.runtime\u002F1.webhooks",{"title":76,"path":77,"stem":78},"Inventory synchronization","\u002Fen\u002Fruntime\u002Finventory-sync","en\u002F5.runtime\u002F2.inventory-sync",{"title":80,"path":81,"stem":82},"Automatic fulfillment providers","\u002Fen\u002Fruntime\u002Fauto-fulfillment","en\u002F5.runtime\u002F3.auto-fulfillment",{"title":84,"icon":85,"path":86,"stem":87,"children":88,"page":22},"API reference","i-lucide-braces","\u002Fen\u002Freference","en\u002F6.reference",[89,93,97],{"title":90,"path":91,"stem":92},"API Reference","\u002Fen\u002Freference\u002Fapi","en\u002F6.reference\u002F1.api",{"title":94,"path":95,"stem":96},"Errors, idempotency, and rate limits","\u002Fen\u002Freference\u002Ferrors-and-limits","en\u002F6.reference\u002F2.errors-and-limits",{"title":98,"path":99,"stem":100,"children":101,"page":22},"Endpoint catalog","\u002Fen\u002Freference\u002Foperations","en\u002F6.reference\u002F3.operations",[102,106,110,114,118,122,126,130,134,138,142,146,150,154,158,162,166,170,174,178,182,186,190,194,198],{"title":103,"path":104,"stem":105},"Get the public runtime configuration","\u002Fen\u002Freference\u002Foperations\u002Fget-public-runtime-config","en\u002F6.reference\u002F3.operations\u002F01.get-public-runtime-config",{"title":107,"path":108,"stem":109},"Get the public site bootstrap configuration","\u002Fen\u002Freference\u002Foperations\u002Fget-public-bootstrap","en\u002F6.reference\u002F3.operations\u002F02.get-public-bootstrap",{"title":111,"path":112,"stem":113},"Get public contact channels","\u002Fen\u002Freference\u002Foperations\u002Fget-public-contact","en\u002F6.reference\u002F3.operations\u002F03.get-public-contact",{"title":115,"path":116,"stem":117},"List current published legal documents by locale","\u002Fen\u002Freference\u002Foperations\u002Flist-public-legal-documents","en\u002F6.reference\u002F3.operations\u002F04.list-public-legal-documents",{"title":119,"path":120,"stem":121},"Get the published Storefront decoration","\u002Fen\u002Freference\u002Foperations\u002Fget-public-storefront-decoration","en\u002F6.reference\u002F3.operations\u002F05.get-public-storefront-decoration",{"title":123,"path":124,"stem":125},"Get the public store security configuration","\u002Fen\u002Freference\u002Foperations\u002Fget-public-store-security-config","en\u002F6.reference\u002F3.operations\u002F06.get-public-store-security-config",{"title":127,"path":128,"stem":129},"Search public products","\u002Fen\u002Freference\u002Foperations\u002Fsearch-public-products","en\u002F6.reference\u002F3.operations\u002F07.search-public-products",{"title":131,"path":132,"stem":133},"List public categories","\u002Fen\u002Freference\u002Foperations\u002Flist-public-categories","en\u002F6.reference\u002F3.operations\u002F08.list-public-categories",{"title":135,"path":136,"stem":137},"Get the installation credential identity","\u002Fen\u002Freference\u002Foperations\u002Fget-installation-credential-identity","en\u002F6.reference\u002F3.operations\u002F09.get-installation-credential-identity",{"title":139,"path":140,"stem":141},"Get the installation credential readiness","\u002Fen\u002Freference\u002Foperations\u002Fget-installation-credential-readiness","en\u002F6.reference\u002F3.operations\u002F10.get-installation-credential-readiness",{"title":143,"path":144,"stem":145},"Initiate a hosted login session","\u002Fen\u002Freference\u002Foperations\u002Finitiate-hosted-login","en\u002F6.reference\u002F3.operations\u002F11.initiate-hosted-login",{"title":147,"path":148,"stem":149},"Consume a hosted login return","\u002Fen\u002Freference\u002Foperations\u002Fconsume-hosted-login-return","en\u002F6.reference\u002F3.operations\u002F12.consume-hosted-login-return",{"title":151,"path":152,"stem":153},"Create a hosted checkout session","\u002Fen\u002Freference\u002Foperations\u002Fcreate-hosted-checkout-session","en\u002F6.reference\u002F3.operations\u002F13.create-hosted-checkout-session",{"title":155,"path":156,"stem":157},"Get a hosted checkout session","\u002Fen\u002Freference\u002Foperations\u002Fget-hosted-checkout-session","en\u002F6.reference\u002F3.operations\u002F14.get-hosted-checkout-session",{"title":159,"path":160,"stem":161},"Cancel a hosted checkout session","\u002Fen\u002Freference\u002Foperations\u002Fcancel-hosted-checkout-session","en\u002F6.reference\u002F3.operations\u002F15.cancel-hosted-checkout-session",{"title":163,"path":164,"stem":165},"List the public product catalog","\u002Fen\u002Freference\u002Foperations\u002Flist-public-products","en\u002F6.reference\u002F3.operations\u002F16.list-public-products",{"title":167,"path":168,"stem":169},"Get a public product by slug","\u002Fen\u002Freference\u002Foperations\u002Fget-public-product","en\u002F6.reference\u002F3.operations\u002F17.get-public-product",{"title":171,"path":172,"stem":173},"Get a public store profile","\u002Fen\u002Freference\u002Foperations\u002Fget-public-merchant","en\u002F6.reference\u002F3.operations\u002F18.get-public-merchant",{"title":175,"path":176,"stem":177},"List public products for a store","\u002Fen\u002Freference\u002Foperations\u002Flist-public-merchant-products","en\u002F6.reference\u002F3.operations\u002F19.list-public-merchant-products",{"title":179,"path":180,"stem":181},"List public categories for a store","\u002Fen\u002Freference\u002Foperations\u002Flist-public-merchant-categories","en\u002F6.reference\u002F3.operations\u002F20.list-public-merchant-categories",{"title":183,"path":184,"stem":185},"Get a public product for a store","\u002Fen\u002Freference\u002Foperations\u002Fget-public-merchant-product","en\u002F6.reference\u002F3.operations\u002F21.get-public-merchant-product",{"title":187,"path":188,"stem":189},"Get the current API Key identity and scopes","\u002Fen\u002Freference\u002Foperations\u002Fget-api-key-identity","en\u002F6.reference\u002F3.operations\u002F22.get-api-key-identity",{"title":191,"path":192,"stem":193},"List public categories with an API Key","\u002Fen\u002Freference\u002Foperations\u002Flist-api-key-catalog-categories","en\u002F6.reference\u002F3.operations\u002F23.list-api-key-catalog-categories",{"title":195,"path":196,"stem":197},"List public products with an API Key","\u002Fen\u002Freference\u002Foperations\u002Flist-api-key-catalog-products","en\u002F6.reference\u002F3.operations\u002F24.list-api-key-catalog-products",{"title":199,"path":200,"stem":201},"Get a public product with an API Key","\u002Fen\u002Freference\u002Foperations\u002Fget-api-key-catalog-product","en\u002F6.reference\u002F3.operations\u002F25.get-api-key-catalog-product",{"title":203,"icon":204,"path":205,"stem":206,"children":207,"page":22},"Examples","i-lucide-code-xml","\u002Fen\u002Fexamples","en\u002F7.examples",[208,212],{"title":209,"path":210,"stem":211},"Minimal Nuxt Storefront","\u002Fen\u002Fexamples\u002Fnuxt-storefront","en\u002F7.examples\u002F1.nuxt-storefront",{"title":213,"path":214,"stem":215},"Webhook verification","\u002Fen\u002Fexamples\u002Fwebhook-verification","en\u002F7.examples\u002F2.webhook-verification",{"title":217,"icon":218,"path":219,"stem":220,"children":221,"page":22},"Versions and support","i-lucide-life-buoy","\u002Fen\u002Foperations","en\u002F8.operations",[222,226],{"title":223,"path":224,"stem":225},"Versions, migrations, and changelog","\u002Fen\u002Foperations\u002Fversions-and-migrations","en\u002F8.operations\u002F1.versions-and-migrations",{"title":227,"path":228,"stem":229},"Support and security disclosure","\u002Fen\u002Foperations\u002Fsupport-and-security","en\u002F8.operations\u002F2.support-and-security",{"id":231,"title":30,"body":232,"description":406,"extension":407,"links":408,"meta":409,"navigation":410,"path":31,"seo":411,"stem":32,"__hash__":412},"docs_en\u002Fen\u002F2.storefront\u002F1.third-party-storefront.md",{"type":233,"value":234,"toc":403},"minimark",[235,239,243,248,302,335,338,341,371,378,388,399],[236,237,30],"h1",{"id":238},"third-party-storefront",[240,241,242],"p",{},"Public catalog reads use the API-selected store, market, and publication state. A custom domain must not infer access from a product ID, slug, search result, cached JSON-LD, sitemap, or OpenGraph response.",[244,245,247],"h2",{"id":246},"hosted-redirect-model","Hosted redirect model",[249,250,255],"pre",{"className":251,"code":252,"language":253,"meta":254,"style":254},"language-mermaid shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","flowchart LR\n  A[Third-party store: read and render the public catalog] --> B{User action}\n  B -->|Sign in or register| C[Official Ayalink authorization domain: not yet available]\n  B -->|Checkout or pay| D[Official Ayalink hosted checkout: not yet available]\n  C --> E[Reviewed exact return URL]\n  D --> E\n  E --> A\n","mermaid","",[256,257,258,266,272,278,284,290,296],"code",{"__ignoreMap":254},[259,260,263],"span",{"class":261,"line":262},"line",1,[259,264,265],{},"flowchart LR\n",[259,267,269],{"class":261,"line":268},2,[259,270,271],{},"  A[Third-party store: read and render the public catalog] --> B{User action}\n",[259,273,275],{"class":261,"line":274},3,[259,276,277],{},"  B -->|Sign in or register| C[Official Ayalink authorization domain: not yet available]\n",[259,279,281],{"class":261,"line":280},4,[259,282,283],{},"  B -->|Checkout or pay| D[Official Ayalink hosted checkout: not yet available]\n",[259,285,287],{"class":261,"line":286},5,[259,288,289],{},"  C --> E[Reviewed exact return URL]\n",[259,291,293],{"class":261,"line":292},6,[259,294,295],{},"  D --> E\n",[259,297,299],{"class":261,"line":298},7,[259,300,301],{},"  E --> A\n",[303,304,305,317,323,329],"ul",{},[306,307,308,312,313,316],"li",{},[309,310,311],"strong",{},"Catalog reads: Available."," Call only operations listed in the ",[314,315,38],"a",{"href":39},".",[306,318,319,322],{},[309,320,321],{},"Hosted login backend session foundation: Published contract."," The artifact includes server-side initiate and return operations protected by API Key and PKCE-related fields. The official login UI, authorization-domain production configuration, and browser-ready redirect flow are not complete, so there is no executable redirect example.",[306,324,325,328],{},[309,326,327],{},"Hosted checkout backend session foundation: Published contract."," The artifact includes server-side create, get, and cancel session operations. Official checkout UI, final order creation, provider payment progression, production configuration, and migrations are not complete; this is not evidence that checkout or payment is available.",[306,330,331,334],{},[309,332,333],{},"Return: Platform enablement required."," A future flow may return only to an exact HTTPS return URL reviewed by the platform; no open redirect or client-side override is allowed.",[240,336,337],{},"A third party must not collect an Ayalink email, password, or MFA; accept or forward the global Ayalink Cookie; handle card data, payment tokens, or any other payment credential; or iframe, proxy, or imitate an Ayalink sign-in, registration, checkout, or payment page. The third-party site renders the catalog and initiates only a future top-level redirect approved by a public contract.",[240,339,340],{},"When a store protects a page or resource, the API applies the same policy to details, prices, inventory, media, structured data, SSR, search, sitemap, and cache. Handle:",[303,342,343,349,355,361],{},[306,344,345,348],{},[256,346,347],{},"401",": send the user through system-domain OAuth and return to an allowlisted local route;",[306,350,351,354],{},[256,352,353],{},"403",": the authenticated user lacks the required membership, role, customer group, market, or scope;",[306,356,357,360],{},[256,358,359],{},"404",": the store chose anti-enumeration semantics for a hidden resource;",[306,362,363,366,367,370],{},[256,364,365],{},"429"," or ",[256,368,369],{},"CHALLENGE_REQUIRED",": render a scoped challenge and retry the original request once.",[240,372,373,374,377],{},"Cache public responses only by the complete server-declared key, including store, market, language, policy version, and authentication class. User-specific responses are ",[256,375,376],{},"private\u002Fno-store"," and must never enter a shared CDN cache.",[240,379,380,381,384,385,316],{},"The browser never receives a client secret or stores an access or refresh token, and it must not proxy or share the Ayalink global-session Cookie. Future sign-in occurs only on the official authorization domain confirmed by platform enablement materials, using Authorization Code with PKCE S256, an exact redirect URI, ",[256,382,383],{},"state",", and ",[256,386,387],{},"nonce",[240,389,390,391,394,395,398],{},"Use a same-origin BFF for a durable session. It stores only the minimal OAuth grant for its own app, installation, store\u002Fresource, and audience, then gives its frontend a secure application-session Cookie. It never forwards an Ayalink Cookie. OAuth APIs are pending security review, so the ",[314,392,393],{"href":49},"account authorization boundary"," and ",[314,396,397],{"href":210},"minimal Nuxt example"," provide no sign-in endpoint or token-exchange code.",[400,401,402],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":254,"searchDepth":268,"depth":268,"links":404},[405],{"id":246,"depth":268,"text":247},"Build an independent storefront while preserving Ayalink identity, access policy, cache, and challenge boundaries.","md",null,{},true,{"title":30,"description":406},"KwjdEPrLEdOcSmRNHm01pytcnY8g0-9LC6oEBLnqnkY",[414,416],{"title":19,"path":20,"stem":21,"description":415,"children":-1},"An end-to-end path from readiness and platform enablement through authorization, API use, Webhooks, testing, production, and emergency revocation.",{"title":34,"path":35,"stem":36,"description":417,"children":-1},"Limit Turnstile to bot protection on official sign-in and authorization endpoints, not proof of site authenticity or login.",1785961909204]