[{"data":1,"prerenderedAt":463},["ShallowReactive",2],{"navigation_docs_en":3,"-en-storefront-challenge-and-turnstile":366,"-en-storefront-challenge-and-turnstile-surround":458},[4,23,41,51,65,83,338,352],{"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,202,206,210,214,218,222,226,230,234,238,242,246,250,254,258,262,266,270,274,278,282,286,290,294,298,302,306,310,314,318,322,326,330,334],{"title":103,"path":104,"stem":105},"confirmOfficialPasswordReset","\u002Fen\u002Freference\u002Foperations\u002Fconfirm-official-password-reset","en\u002F6.reference\u002F3.operations\u002F01.confirm-official-password-reset",{"title":107,"path":108,"stem":109},"requestOfficialPasswordReset","\u002Fen\u002Freference\u002Foperations\u002Frequest-official-password-reset","en\u002F6.reference\u002F3.operations\u002F02.request-official-password-reset",{"title":111,"path":112,"stem":113},"registerOfficialStorefrontCustomer","\u002Fen\u002Freference\u002Foperations\u002Fregister-official-storefront-customer","en\u002F6.reference\u002F3.operations\u002F03.register-official-storefront-customer",{"title":115,"path":116,"stem":117},"Get the public site bootstrap configuration","\u002Fen\u002Freference\u002Foperations\u002Fget-public-bootstrap","en\u002F6.reference\u002F3.operations\u002F04.get-public-bootstrap",{"title":119,"path":120,"stem":121},"List public categories","\u002Fen\u002Freference\u002Foperations\u002Flist-public-categories","en\u002F6.reference\u002F3.operations\u002F05.list-public-categories",{"title":123,"path":124,"stem":125},"Get a public product for a store","\u002Fen\u002Freference\u002Foperations\u002Fget-public-merchant-product","en\u002F6.reference\u002F3.operations\u002F06.get-public-merchant-product",{"title":127,"path":128,"stem":129},"List public categories for a store","\u002Fen\u002Freference\u002Foperations\u002Flist-public-merchant-categories","en\u002F6.reference\u002F3.operations\u002F07.list-public-merchant-categories",{"title":131,"path":132,"stem":133},"List public products for a store","\u002Fen\u002Freference\u002Foperations\u002Flist-public-merchant-products","en\u002F6.reference\u002F3.operations\u002F08.list-public-merchant-products",{"title":135,"path":136,"stem":137},"Get a public store profile","\u002Fen\u002Freference\u002Foperations\u002Fget-public-merchant","en\u002F6.reference\u002F3.operations\u002F09.get-public-merchant",{"title":139,"path":140,"stem":141},"Get a public product by slug","\u002Fen\u002Freference\u002Foperations\u002Fget-public-product","en\u002F6.reference\u002F3.operations\u002F10.get-public-product",{"title":143,"path":144,"stem":145},"List the public product catalog","\u002Fen\u002Freference\u002Foperations\u002Flist-public-products","en\u002F6.reference\u002F3.operations\u002F11.list-public-products",{"title":147,"path":148,"stem":149},"List current published legal documents by locale","\u002Fen\u002Freference\u002Foperations\u002Flist-public-legal-documents","en\u002F6.reference\u002F3.operations\u002F12.list-public-legal-documents",{"title":151,"path":152,"stem":153},"describeOAuthAuthorization","\u002Fen\u002Freference\u002Foperations\u002Fdescribe-oauth-authorization","en\u002F6.reference\u002F3.operations\u002F13.describe-oauth-authorization",{"title":155,"path":156,"stem":157},"revokeOAuthToken","\u002Fen\u002Freference\u002Foperations\u002Frevoke-oauth-token","en\u002F6.reference\u002F3.operations\u002F14.revoke-oauth-token",{"title":159,"path":160,"stem":161},"exchangeOAuthToken","\u002Fen\u002Freference\u002Foperations\u002Fexchange-oauth-token","en\u002F6.reference\u002F3.operations\u002F15.exchange-oauth-token",{"title":163,"path":164,"stem":165},"List public categories with an API Key","\u002Fen\u002Freference\u002Foperations\u002Flist-api-key-catalog-categories","en\u002F6.reference\u002F3.operations\u002F16.list-api-key-catalog-categories",{"title":167,"path":168,"stem":169},"Get a public product with an API Key","\u002Fen\u002Freference\u002Foperations\u002Fget-api-key-catalog-product","en\u002F6.reference\u002F3.operations\u002F17.get-api-key-catalog-product",{"title":171,"path":172,"stem":173},"List public products with an API Key","\u002Fen\u002Freference\u002Foperations\u002Flist-api-key-catalog-products","en\u002F6.reference\u002F3.operations\u002F18.list-api-key-catalog-products",{"title":175,"path":176,"stem":177},"Cancel a hosted checkout session","\u002Fen\u002Freference\u002Foperations\u002Fcancel-hosted-checkout-session","en\u002F6.reference\u002F3.operations\u002F19.cancel-hosted-checkout-session",{"title":179,"path":180,"stem":181},"Get a hosted checkout session","\u002Fen\u002Freference\u002Foperations\u002Fget-hosted-checkout-session","en\u002F6.reference\u002F3.operations\u002F20.get-hosted-checkout-session",{"title":183,"path":184,"stem":185},"Create a hosted checkout session","\u002Fen\u002Freference\u002Foperations\u002Fcreate-hosted-checkout-session","en\u002F6.reference\u002F3.operations\u002F21.create-hosted-checkout-session",{"title":187,"path":188,"stem":189},"Initiate a hosted login session","\u002Fen\u002Freference\u002Foperations\u002Finitiate-hosted-login","en\u002F6.reference\u002F3.operations\u002F22.initiate-hosted-login",{"title":191,"path":192,"stem":193},"Consume a hosted login return","\u002Fen\u002Freference\u002Foperations\u002Fconsume-hosted-login-return","en\u002F6.reference\u002F3.operations\u002F23.consume-hosted-login-return",{"title":195,"path":196,"stem":197},"Get the current API Key identity and scopes","\u002Fen\u002Freference\u002Foperations\u002Fget-api-key-identity","en\u002F6.reference\u002F3.operations\u002F24.get-api-key-identity",{"title":199,"path":200,"stem":201},"Get the installation credential identity","\u002Fen\u002Freference\u002Foperations\u002Fget-installation-credential-identity","en\u002F6.reference\u002F3.operations\u002F25.get-installation-credential-identity",{"title":203,"path":204,"stem":205},"Get the installation credential readiness","\u002Fen\u002Freference\u002Foperations\u002Fget-installation-credential-readiness","en\u002F6.reference\u002F3.operations\u002F26.get-installation-credential-readiness",{"title":207,"path":208,"stem":209},"setPublicCartAddress","\u002Fen\u002Freference\u002Foperations\u002Fset-public-cart-address","en\u002F6.reference\u002F3.operations\u002F27.set-public-cart-address",{"title":211,"path":212,"stem":213},"quotePublicCartCheckout","\u002Fen\u002Freference\u002Foperations\u002Fquote-public-cart-checkout","en\u002F6.reference\u002F3.operations\u002F28.quote-public-cart-checkout",{"title":215,"path":216,"stem":217},"checkoutPublicCart","\u002Fen\u002Freference\u002Foperations\u002Fcheckout-public-cart","en\u002F6.reference\u002F3.operations\u002F29.checkout-public-cart",{"title":219,"path":220,"stem":221},"clearPublicCart","\u002Fen\u002Freference\u002Foperations\u002Fclear-public-cart","en\u002F6.reference\u002F3.operations\u002F30.clear-public-cart",{"title":223,"path":224,"stem":225},"removePublicCartItem","\u002Fen\u002Freference\u002Foperations\u002Fremove-public-cart-item","en\u002F6.reference\u002F3.operations\u002F31.remove-public-cart-item",{"title":227,"path":228,"stem":229},"updatePublicCartItemQuantity","\u002Fen\u002Freference\u002Foperations\u002Fupdate-public-cart-item-quantity","en\u002F6.reference\u002F3.operations\u002F32.update-public-cart-item-quantity",{"title":231,"path":232,"stem":233},"addPublicCartItem","\u002Fen\u002Freference\u002Foperations\u002Fadd-public-cart-item","en\u002F6.reference\u002F3.operations\u002F33.add-public-cart-item",{"title":235,"path":236,"stem":237},"removePublicCartPromotion","\u002Fen\u002Freference\u002Foperations\u002Fremove-public-cart-promotion","en\u002F6.reference\u002F3.operations\u002F34.remove-public-cart-promotion",{"title":239,"path":240,"stem":241},"applyPublicCartPromotion","\u002Fen\u002Freference\u002Foperations\u002Fapply-public-cart-promotion","en\u002F6.reference\u002F3.operations\u002F35.apply-public-cart-promotion",{"title":243,"path":244,"stem":245},"quotePublicCart","\u002Fen\u002Freference\u002Foperations\u002Fquote-public-cart","en\u002F6.reference\u002F3.operations\u002F36.quote-public-cart",{"title":247,"path":248,"stem":249},"revokePublicCart","\u002Fen\u002Freference\u002Foperations\u002Frevoke-public-cart","en\u002F6.reference\u002F3.operations\u002F37.revoke-public-cart",{"title":251,"path":252,"stem":253},"getPublicCart","\u002Fen\u002Freference\u002Foperations\u002Fget-public-cart","en\u002F6.reference\u002F3.operations\u002F38.get-public-cart",{"title":255,"path":256,"stem":257},"createPublicCart","\u002Fen\u002Freference\u002Foperations\u002Fcreate-public-cart","en\u002F6.reference\u002F3.operations\u002F39.create-public-cart",{"title":259,"path":260,"stem":261},"getStorefrontOrderAfterSalesEligibility","\u002Fen\u002Freference\u002Foperations\u002Fget-storefront-order-after-sales-eligibility","en\u002F6.reference\u002F3.operations\u002F40.get-storefront-order-after-sales-eligibility",{"title":263,"path":264,"stem":265},"requestStorefrontOrderAfterSales","\u002Fen\u002Freference\u002Foperations\u002Frequest-storefront-order-after-sales","en\u002F6.reference\u002F3.operations\u002F41.request-storefront-order-after-sales",{"title":267,"path":268,"stem":269},"getStorefrontOrderCancellationEligibility","\u002Fen\u002Freference\u002Foperations\u002Fget-storefront-order-cancellation-eligibility","en\u002F6.reference\u002F3.operations\u002F42.get-storefront-order-cancellation-eligibility",{"title":271,"path":272,"stem":273},"cancelStorefrontOrder","\u002Fen\u002Freference\u002Foperations\u002Fcancel-storefront-order","en\u002F6.reference\u002F3.operations\u002F43.cancel-storefront-order",{"title":275,"path":276,"stem":277},"getStorefrontOrder","\u002Fen\u002Freference\u002Foperations\u002Fget-storefront-order","en\u002F6.reference\u002F3.operations\u002F44.get-storefront-order",{"title":279,"path":280,"stem":281},"listStorefrontOrders","\u002Fen\u002Freference\u002Foperations\u002Flist-storefront-orders","en\u002F6.reference\u002F3.operations\u002F45.list-storefront-orders",{"title":283,"path":284,"stem":285},"replayInstallationWebhookDelivery","\u002Fen\u002Freference\u002Foperations\u002Freplay-installation-webhook-delivery","en\u002F6.reference\u002F3.operations\u002F46.replay-installation-webhook-delivery",{"title":287,"path":288,"stem":289},"listInstallationWebhookDeliveries","\u002Fen\u002Freference\u002Foperations\u002Flist-installation-webhook-deliveries","en\u002F6.reference\u002F3.operations\u002F47.list-installation-webhook-deliveries",{"title":291,"path":292,"stem":293},"getInstallationWebhookSignatureFixture","\u002Fen\u002Freference\u002Foperations\u002Fget-installation-webhook-signature-fixture","en\u002F6.reference\u002F3.operations\u002F48.get-installation-webhook-signature-fixture",{"title":295,"path":296,"stem":297},"updateInstallationWebhook","\u002Fen\u002Freference\u002Foperations\u002Fupdate-installation-webhook","en\u002F6.reference\u002F3.operations\u002F49.update-installation-webhook",{"title":299,"path":300,"stem":301},"listInstallationWebhooks","\u002Fen\u002Freference\u002Foperations\u002Flist-installation-webhooks","en\u002F6.reference\u002F3.operations\u002F50.list-installation-webhooks",{"title":303,"path":304,"stem":305},"createInstallationWebhook","\u002Fen\u002Freference\u002Foperations\u002Fcreate-installation-webhook","en\u002F6.reference\u002F3.operations\u002F51.create-installation-webhook",{"title":307,"path":308,"stem":309},"listInstallationWebhookEvents","\u002Fen\u002Freference\u002Foperations\u002Flist-installation-webhook-events","en\u002F6.reference\u002F3.operations\u002F52.list-installation-webhook-events",{"title":311,"path":312,"stem":313},"Get public contact channels","\u002Fen\u002Freference\u002Foperations\u002Fget-public-contact","en\u002F6.reference\u002F3.operations\u002F53.get-public-contact",{"title":315,"path":316,"stem":317},"verifyStorefrontChallenge","\u002Fen\u002Freference\u002Foperations\u002Fverify-storefront-challenge","en\u002F6.reference\u002F3.operations\u002F54.verify-storefront-challenge",{"title":319,"path":320,"stem":321},"createStorefrontChallenge","\u002Fen\u002Freference\u002Foperations\u002Fcreate-storefront-challenge","en\u002F6.reference\u002F3.operations\u002F55.create-storefront-challenge",{"title":323,"path":324,"stem":325},"Get the public store security configuration","\u002Fen\u002Freference\u002Foperations\u002Fget-public-store-security-config","en\u002F6.reference\u002F3.operations\u002F56.get-public-store-security-config",{"title":327,"path":328,"stem":329},"Get the public runtime configuration","\u002Fen\u002Freference\u002Foperations\u002Fget-public-runtime-config","en\u002F6.reference\u002F3.operations\u002F57.get-public-runtime-config",{"title":331,"path":332,"stem":333},"Search public products","\u002Fen\u002Freference\u002Foperations\u002Fsearch-public-products","en\u002F6.reference\u002F3.operations\u002F58.search-public-products",{"title":335,"path":336,"stem":337},"Get the published Storefront decoration","\u002Fen\u002Freference\u002Foperations\u002Fget-public-storefront-decoration","en\u002F6.reference\u002F3.operations\u002F59.get-public-storefront-decoration",{"title":339,"icon":340,"path":341,"stem":342,"children":343,"page":22},"Examples","i-lucide-code-xml","\u002Fen\u002Fexamples","en\u002F7.examples",[344,348],{"title":345,"path":346,"stem":347},"Minimal Nuxt Storefront","\u002Fen\u002Fexamples\u002Fnuxt-storefront","en\u002F7.examples\u002F1.nuxt-storefront",{"title":349,"path":350,"stem":351},"Webhook verification","\u002Fen\u002Fexamples\u002Fwebhook-verification","en\u002F7.examples\u002F2.webhook-verification",{"title":353,"icon":354,"path":355,"stem":356,"children":357,"page":22},"Versions and support","i-lucide-life-buoy","\u002Fen\u002Foperations","en\u002F8.operations",[358,362],{"title":359,"path":360,"stem":361},"Versions, migrations, and changelog","\u002Fen\u002Foperations\u002Fversions-and-migrations","en\u002F8.operations\u002F1.versions-and-migrations",{"title":363,"path":364,"stem":365},"Support and security disclosure","\u002Fen\u002Foperations\u002Fsupport-and-security","en\u002F8.operations\u002F2.support-and-security",{"id":367,"title":34,"body":368,"description":451,"extension":452,"links":453,"meta":454,"navigation":455,"path":35,"seo":456,"stem":36,"__hash__":457},"docs_en\u002Fen\u002F2.storefront\u002F2.challenge-and-turnstile.md",{"type":369,"value":370,"toc":446},"minimark",[371,375,382,385,390,439],[372,373,34],"h1",{"id":374},"turnstile-trust-boundary",[376,377,378],"blockquote",{},[379,380,381],"p",{},"Status: planned\u002Fnot enabled. There is no verified evidence yet for an Ayalink Cloudflare widget, hostname policy, Siteverify integration, zone\u002FWAF rule, or pre-clearance configuration.",[379,383,384],{},"Turnstile can only reduce bots and automated abuse on official Ayalink sign-in and authorization endpoints. It does not prove ownership of a site, page authenticity, user identity, MFA, an OAuth grant, or resource authorization. A phishing site can deploy its own Turnstile widget, so the presence of a challenge is never a trust signal. Primary anti-impersonation controls are verification of the official authorization domain, Passkey\u002FWebAuthn where verified in the official flow, OAuth Authorization Code with PKCE S256, and short-lived grants constrained by audience, resource, and scope.",[386,387,389],"h2",{"id":388},"mandatory-gates-before-enablement","Mandatory gates before enablement",[391,392,393,397,408,424,427],"ul",{},[394,395,396],"li",{},"A widget allows only explicitly registered official hostnames. A public site key is not proof of an authentic site.",[394,398,399,400,407],{},"The browser token goes to an Ayalink backend, which calls ",[401,402,406],"a",{"href":403,"rel":404},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Fturnstile\u002Fget-started\u002Fserver-side-validation\u002F",[405],"nofollow","Cloudflare Siteverify",". A client callback alone is never trusted.",[394,409,410,411,415,416,419,420,423],{},"In addition to ",[412,413,414],"code",{},"success",", the backend compares the expected ",[412,417,418],{},"hostname"," and ",[412,421,422],{},"action",". The secret remains in controlled server configuration and never enters browsers, documentation, logs, or error telemetry.",[394,425,426],{},"A token expires five minutes after generation and can be validated only once. Timeout or replay fails and never becomes durable clearance or login state.",[394,428,429,434,435,438],{},[401,430,433],{"href":431,"rel":432},"https:\u002F\u002Fdevelopers.cloudflare.com\u002Fturnstile\u002Fadditional-configuration\u002Fhostname-management\u002Fpre-clearance\u002F",[405],"Pre-clearance"," applies only when the widget hostname is correctly associated with the Cloudflare zone and its WAF rule. ",[412,436,437],{},"cf_clearance"," only allows configured WAF challenges to be skipped; it is not an Ayalink session, OAuth grant, or authorization fact.",[379,440,441,442,445],{},"Until these configurations and runtime evidence exist, the documentation provides no Ayalink site key, Siteverify wiring, ",[412,443,444],{},"CHALLENGE_REQUIRED"," protocol, or successful production example, and makes no claim that Turnstile protects a live flow.",{"title":447,"searchDepth":448,"depth":448,"links":449},"",2,[450],{"id":388,"depth":448,"text":389},"Limit Turnstile to bot protection on official sign-in and authorization endpoints, not proof of site authenticity or login.","md",null,{},true,{"title":34,"description":451},"7mCZ3OJlqazyha60rAwmkbufFgilBHiWdCUfHXhUmNc",[459,461],{"title":30,"path":31,"stem":32,"description":460,"children":-1},"Build an independent storefront while preserving Ayalink identity, access policy, cache, and challenge boundaries.",{"title":38,"path":39,"stem":40,"description":462,"children":-1},"The Storefront public API entry generated from the authoritative public-only artifact.",1786207769038]