[{"data":1,"prerenderedAt":736},["ShallowReactive",2],{"header:help":3,"footer:default":67,"story:navigation\u002Fsearch:help":250,"story:help\u002Fcategories":288,"story:help\u002Farticles\u002Fsingle-sign-on-overview":314,"no-guide:single-sign-on-overview":59,"article:\u002Fhelp\u002Farticles\u002Fsingle-sign-on-overview":499,"story:contact":519,"help:tree:8b3a53c4-3ca3-491b-92ac-4ccc6e7c33ac":709,"_apollo:default":735},{"name":4,"created_at":5,"published_at":6,"updated_at":7,"id":8,"uuid":9,"content":10,"slug":57,"full_slug":58,"sort_by_date":59,"position":60,"tag_list":61,"is_startpage":24,"parent_id":62,"meta_data":59,"group_id":63,"first_published_at":64,"release_id":59,"lang":65,"path":59,"alternates":66,"default_full_slug":59,"translated_slugs":59},"Help Center Header","2024-08-09T18:06:34.939Z","2024-10-21T21:58:39.217Z","2024-10-21T21:58:39.232Z",10082752,"3e9b88f7-c163-4657-a2f2-62532d600fad",{"_uid":11,"link":12,"badge":16,"items":17,"title":13,"buttons":50,"new_tab":24,"submenu":51,"alignment":13,"component":52,"badge_link":53,"top_menu_items":56},"e5645a1a-f991-40e8-8d67-e40ebc082b5a",{"id":13,"url":13,"linktype":14,"fieldtype":15,"cached_url":13},"","story","multilink","Help Center",[18,27,34,39,44],{"_uid":19,"link":20,"title":23,"new_tab":24,"submenu":25,"component":26},"5cbe2861-1f49-4166-97da-a4dddd8105e3",{"id":21,"url":13,"linktype":14,"fieldtype":15,"cached_url":22},"4c0a2d99-ec30-4579-8ef1-6bf5564d4839","help\u002Fcategories\u002F","Articles",false,[],"header___item",{"_uid":28,"link":29,"title":32,"new_tab":33,"component":26},"1c8edeb5-b9e9-4cb8-b1c6-c1f292f7d7cd",{"id":13,"url":30,"linktype":31,"fieldtype":15,"cached_url":30},"https:\u002F\u002Fwiki.foxycart.com\u002F","url","Documentation",true,{"_uid":35,"link":36,"title":38,"new_tab":33,"component":26},"8d7df70e-f087-4da0-b616-6f0e9a5af35c",{"id":13,"url":37,"linktype":31,"fieldtype":15,"cached_url":37},"https:\u002F\u002Fapi.foxycart.com\u002F","API Documentation",{"_uid":40,"link":41,"title":43,"new_tab":33,"component":26},"f76e7944-23d5-4652-87e4-cdae79272762",{"id":13,"url":42,"linktype":31,"fieldtype":15,"cached_url":42},"https:\u002F\u002Fstatus.foxy.io\u002F","System Status",{"_uid":45,"link":46,"title":49,"new_tab":24,"component":26},"0de16771-4c84-466c-a1da-d8568113c71f",{"id":47,"url":13,"linktype":14,"fieldtype":15,"cached_url":48},"01e4e370-f9b9-45af-8fa9-f15540699b0d","contact","Contact Us",[],[],"header",{"id":54,"url":13,"linktype":14,"fieldtype":15,"cached_url":55},"4a679eb7-662d-4ea4-a976-5a2acbf0b663","help\u002F",[],"help-header","navigation\u002Fhelp-header",null,20,[],10082747,"71b81c2e-5e09-48a1-a397-a3c72fcd344a","2022-09-21T14:50:25.655Z","default",[],{"name":68,"created_at":69,"published_at":70,"updated_at":71,"id":72,"uuid":73,"content":74,"slug":243,"full_slug":244,"sort_by_date":59,"position":245,"tag_list":246,"is_startpage":24,"parent_id":62,"meta_data":59,"group_id":247,"first_published_at":248,"release_id":59,"lang":65,"path":59,"alternates":249,"default_full_slug":59,"translated_slugs":59},"Default Footer","2024-08-09T18:06:59.024Z","2025-09-04T06:24:46.223Z","2025-09-04T06:24:46.241Z",10082753,"e59e67ac-248a-482f-84a1-53d4f318186a",{"_uid":75,"about":76,"logos":77,"socials":82,"sections":108,"component":225,"cta_title":226,"bottom_links":227,"cta_subtitle":241,"cta_button_link":242,"cta_button_text":183},"830983f5-c4c4-43c8-b150-86a5e3fa6dc8","Foxy’s hosted cart & payment page allow you to sell anything, using your existing website or platform.",[78],{"id":79,"alt":13,"name":13,"focus":13,"title":13,"filename":80,"copyright":13,"fieldtype":81},14760,"https:\u002F\u002Fa-us.storyblok.com\u002Ff\u002F1001040\u002Fx\u002F3b030847ec\u002Fb-corp.svg","asset",[83,90,96,102],{"_uid":84,"icon":85,"link":86,"name":88,"component":89},"faf0a618-ea94-42ea-9182-03be18c43216","fa-facebook",{"id":13,"url":87,"linktype":31,"fieldtype":15,"cached_url":87},"https:\u002F\u002Fwww.facebook.com\u002Ffoxycart","Facebook","footer___social",{"_uid":91,"icon":92,"link":93,"name":95,"component":89},"14309c18-7e79-423e-b375-34555bac0811","fa-instagram",{"id":13,"url":94,"linktype":31,"fieldtype":15,"cached_url":94},"https:\u002F\u002Fwww.instagram.com\u002Ffoxy_io","Instagram",{"_uid":97,"icon":98,"link":99,"name":101,"component":89},"8f7fe7cf-0dd3-4596-8334-226ea466716a","fa-linkedin",{"id":13,"url":100,"linktype":31,"fieldtype":15,"cached_url":100},"https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Ffoxycart.com","LinkedIn",{"_uid":103,"icon":104,"link":105,"name":107,"component":89},"90a675b4-dd97-40b5-be09-00a87223d4c5","fa-youtube",{"id":13,"url":106,"linktype":31,"fieldtype":15,"cached_url":106},"https:\u002F\u002Fwww.youtube.com\u002Fuser\u002Ffoxycart","Youtube",[109,139,184,206],{"_uid":110,"name":111,"items":112,"component":138},"82849945-282f-488c-b18d-a8d2252f514a","Company",[113,120,126,132],{"_uid":114,"link":115,"title":118,"new_tab":24,"component":119},"1f699ab1-938b-4d9d-9825-aabcbe6f57fe",{"id":116,"url":13,"linktype":14,"fieldtype":15,"cached_url":117},"63634293-a749-4226-9439-9f38ee6dcda0","about-us","About Us","footer___menu_items",{"_uid":121,"link":122,"title":125,"new_tab":24,"component":119},"b26b00f1-a0e7-4be2-8ab3-428b8cc841f8",{"id":123,"url":13,"linktype":14,"fieldtype":15,"cached_url":124},"26cb7c55-faed-4a77-a291-1552d4111b3e","how-foxy-works","How Foxy Works",{"_uid":127,"link":128,"title":131,"new_tab":24,"component":119},"b40c68a0-1ceb-4226-9515-6176534f61fe",{"id":129,"url":13,"linktype":14,"fieldtype":15,"cached_url":130},"dc6657d7-7f4f-4c0d-b781-e971b038ee26","for-good","Foxy For Good",{"_uid":133,"link":134,"title":137,"new_tab":24,"component":119},"3ad0c134-bef9-4fff-b891-e09f16109036",{"id":135,"url":13,"linktype":14,"fieldtype":15,"cached_url":136},"23cae210-baf4-4588-9862-d09f4f52ccd2","brand-assets","Brand Assets","footer___section",{"_uid":140,"name":141,"items":142,"component":138},"a6805fa8-ac60-47f1-b8f0-f27aded0afbe","Product",[143,149,155,161,167,173,179],{"_uid":144,"link":145,"title":148,"new_tab":24,"component":119},"b39c8a4e-2383-486f-b76a-11fbb15d8134",{"id":146,"url":13,"linktype":14,"fieldtype":15,"cached_url":147},"bb04690f-fe98-4ce6-80be-05b950f2364f","features\u002F","Features",{"_uid":150,"link":151,"title":154,"new_tab":24,"component":119},"64f8a41f-c181-433d-bc0a-fc94e71ecbf6",{"id":152,"url":13,"linktype":14,"fieldtype":15,"cached_url":153},"c450c58d-761d-48c0-a9af-0b064611689b","pricing","Pricing",{"_uid":156,"link":157,"title":160,"new_tab":24,"component":119},"6e0b287f-fd8c-4146-9e0e-0ab0b5c9ce3c",{"id":158,"url":13,"linktype":14,"fieldtype":15,"cached_url":159},"fab20ad9-e76a-4947-b709-3a6fdfa88028","blog\u002Fcategories\u002Fproduct-updates","Product Updates",{"_uid":162,"link":163,"title":166,"new_tab":24,"component":119},"47e5a074-a6b5-4f1c-8c2f-89a2ae9f83eb",{"id":164,"url":13,"linktype":14,"fieldtype":15,"cached_url":165},"d2c83612-d611-47f3-a3b4-ca7fe08540b8","changelogs\u002F","Changelogs",{"_uid":168,"link":169,"title":172,"new_tab":24,"component":119},"b5c08774-542f-4ffd-b357-c94d674488b9",{"id":170,"url":13,"linktype":14,"fieldtype":15,"cached_url":171},"08876121-0df3-4ed9-aa11-902b3e41cd02","whats-next","What's Next",{"_uid":174,"link":175,"title":178,"new_tab":24,"component":119},"9c2704ed-6d9f-43e1-9e67-c8d91c083288",{"id":176,"url":13,"linktype":14,"fieldtype":15,"cached_url":177},"056a7857-b18f-4025-8f97-91a38fc19bc8","compare\u002F","Compare",{"_uid":180,"link":181,"title":183,"new_tab":24,"component":119},"5f2db35b-674b-406a-8fa7-d246633af9fe",{"id":13,"url":182,"linktype":31,"fieldtype":15,"cached_url":182},"https:\u002F\u002Fadmin.foxy.io\u002Fsign-up","Try Foxy Free",{"_uid":185,"name":186,"items":187,"component":138},"63fa1f29-4252-4640-9922-fe310e69e54a","Security",[188,194,200],{"_uid":189,"link":190,"title":193,"new_tab":24,"component":119},"1158ddb6-9eb0-466f-8eb6-7ca2ae66c8b8",{"id":191,"url":13,"linktype":14,"fieldtype":15,"cached_url":192},"1f58fb2c-8681-4742-b6e8-09999beae9f6","security-contact","Security Contact",{"_uid":195,"link":196,"title":199,"new_tab":24,"component":119},"9a79c54a-6022-4dfd-854b-766f5e4703ba",{"id":197,"url":13,"linktype":14,"fieldtype":15,"cached_url":198},"55cbfcc3-425a-4261-8037-54e919851d2d","pci","PCI Compliance",{"_uid":201,"link":202,"title":205,"new_tab":24,"component":119},"0b85f5b6-9534-4071-b323-b39d053dd4d7",{"id":203,"url":13,"linktype":14,"fieldtype":15,"cached_url":204},"c3ac0fe3-83e2-4879-afbd-d4c83e1590df","help\u002Farticles\u002Four-official-domains-public-code","Domains & Codebases",{"_uid":207,"name":208,"items":209,"component":138},"998ded67-d107-49f4-8154-ca6be51671ec","Support",[210,213,216,219,222],{"_uid":211,"link":212,"title":16,"new_tab":24,"component":119},"594ffd35-3049-4004-bb08-0db568ebd819",{"id":54,"url":13,"linktype":14,"fieldtype":15,"cached_url":55},{"_uid":214,"link":215,"title":32,"new_tab":33,"component":119},"0a1a55ab-a985-4f9d-8b42-26da714d0c1c",{"id":13,"url":30,"linktype":31,"fieldtype":15,"cached_url":30},{"_uid":217,"link":218,"title":38,"new_tab":33,"component":119},"61e0b7c8-aadf-419b-a339-b3ccabc65bf4",{"id":13,"url":37,"linktype":31,"fieldtype":15,"cached_url":37},{"_uid":220,"link":221,"title":43,"new_tab":33,"component":119},"fd67a89e-1c54-4d31-94b5-64be999062d6",{"id":13,"url":42,"linktype":31,"fieldtype":15,"cached_url":42},{"_uid":223,"link":224,"title":49,"new_tab":24,"component":119},"231a6f71-e996-4ad4-b033-d4d5542f34f0",{"id":47,"url":13,"linktype":14,"fieldtype":15,"cached_url":48},"footer","Get started with our *unlimited free trial*.",[228,235],{"_uid":229,"link":230,"text":233,"component":234},"f0b77210-2632-45a2-8436-e57cad84d01a",{"id":231,"url":13,"linktype":14,"fieldtype":15,"cached_url":232},"60ba16a2-c1f4-485f-b978-8d2eeeafbf5a","terms-of-service","Terms of Service","footer___bottom_links",{"_uid":236,"link":237,"text":240,"component":234},"4bd497b0-993f-4b4d-a5b7-8a49c7c8fec9",{"id":238,"url":13,"linktype":14,"fieldtype":15,"cached_url":239},"332302b9-1d18-4016-b9c8-9b33c72d782b","privacy-policy","Privacy Policy","No credit card required.",{"id":13,"url":182,"linktype":31,"fieldtype":15,"cached_url":182},"default-footer","navigation\u002Fdefault-footer",50,[],"11006268-07f9-41e9-96f3-c51fb723399d","2022-09-21T20:39:02.357Z",[],{"name":251,"created_at":252,"published_at":253,"updated_at":254,"id":255,"uuid":256,"content":257,"slug":279,"full_slug":282,"sort_by_date":59,"position":283,"tag_list":284,"is_startpage":24,"parent_id":62,"meta_data":59,"group_id":285,"first_published_at":286,"release_id":59,"lang":65,"path":59,"alternates":287,"default_full_slug":59,"translated_slugs":59},"Search","2024-10-21T22:08:54.973Z","2025-05-26T09:17:25.790Z","2025-05-26T09:17:25.804Z",13592003,"14cbc359-9ac1-4a7a-a8de-ad4ac8ef26d4",{"_uid":258,"name":251,"indices":259,"summary":13,"component":279,"primary_image":280},"5e4a56e8-76f1-4790-b3a7-70f1be97d042",[260,265,269,274],{"key":261,"_uid":262,"icon":13,"name":263,"component":264},"all","c12a3210-7323-4273-8217-5215e52efe84","All","index",{"key":266,"_uid":267,"icon":268,"name":23,"component":264},"help_center_article","5acff080-95e4-44d3-8dcf-1b19720af382","fa-file-alt",{"key":270,"_uid":271,"icon":272,"name":273,"component":264},"help_center_guide","b8fbc206-c083-471e-a1f0-0ebeb90a669d","fa-book","Guides",{"key":275,"_uid":276,"icon":277,"name":278,"component":264},"blog_post","23419e83-2e56-4c4c-8a05-9fd1b3c9a9bd","fa-file-image","Blog Posts","search",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":281},{},"navigation\u002Fsearch",60,[],"11e1fd31-95cd-4fc9-b736-8b8910663e6c","2024-10-21T23:17:05.904Z",[],{"name":23,"created_at":289,"published_at":290,"updated_at":291,"id":292,"uuid":21,"content":293,"slug":307,"full_slug":22,"sort_by_date":59,"position":308,"tag_list":309,"is_startpage":33,"parent_id":310,"meta_data":59,"group_id":311,"first_published_at":312,"release_id":59,"lang":65,"path":59,"alternates":313,"default_full_slug":59,"translated_slugs":59},"2022-09-19T14:42:29.685Z","2024-07-30T18:17:22.506Z","2024-07-30T18:17:22.525Z",2660,{"_uid":294,"icon":13,"name":23,"guides":295,"pinned":24,"summary":296,"category":13,"component":297,"blog_posts":298,"content_hub":24,"icon_custom":299,"case_studies":300,"faq_sections":301,"help_articles":302,"featured_guides":303,"mailbox_category":13,"featured_articles":304,"featured_blog_posts":305,"featured_case_studies":306},"d6dae89a-907a-4bf7-82de-fe2ba875ee6e",[],"Get your questions answered with our browsable knowledge base.","help_center_category",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"filename":13,"copyright":59,"fieldtype":81},[],[],[],[],[],[],[],"categories",530,[],2658,"19ebcdd2-027f-47f5-9a5b-a8992c959578","2022-09-19T16:24:39.219Z",[],{"name":315,"created_at":316,"published_at":317,"updated_at":318,"id":319,"uuid":320,"content":321,"slug":492,"full_slug":493,"sort_by_date":59,"position":494,"tag_list":495,"is_startpage":24,"parent_id":496,"meta_data":59,"group_id":497,"first_published_at":317,"release_id":59,"lang":65,"path":59,"alternates":498,"default_full_slug":59,"translated_slugs":59},"Single sign-on overview","2026-07-17T05:27:42.754Z","2026-07-17T05:52:01.988Z","2026-07-17T05:52:02.002Z",198969191501209,"8b3a53c4-3ca3-491b-92ac-4ccc6e7c33ac",{"_uid":322,"body":323,"name":315,"image":487,"pinned":24,"summary":489,"category":490,"component":266,"related_articles":491},"1a301e8b-18fc-4920-a1f0-39a070970ff7",{"type":324,"content":325},"doc",[326,333,340,345,372,377,410,415,420,443,448,453,458,463,468,473,478],{"type":327,"attrs":328,"content":329},"paragraph",{"textAlign":59},[330],{"text":331,"type":332},"Foxy’s single sign-on (SSO) lets customers who are already logged into your website skip re-entering their username and password when they reach checkout. It also works in reverse, letting you authenticate a customer on your own site after they complete a purchase through Foxy.","text",{"type":334,"attrs":335,"content":337},"heading",{"level":336,"textAlign":59},2,[338],{"text":339,"type":332},"How it works",{"type":327,"attrs":341,"content":342},{"textAlign":59},[343],{"text":344,"type":332},"SSO covers two directions:",{"type":346,"content":347},"bullet_list",[348,361],{"type":349,"content":350},"list_item",[351],{"type":327,"attrs":352,"content":353},{"textAlign":59},[354,359],{"text":355,"type":332,"marks":356},"Checkout SSO (incoming):",[357],{"type":358},"bold",{"text":360,"type":332}," when a customer who’s already logged into your site proceeds to checkout, your site’s SSO endpoint passes an authentication token to Foxy. If the token is valid, the customer skips re-entering their email and password. For security, a saved credit card still requires the CSC unless your store is configured to only require it for new cards.",{"type":349,"content":362},[363],{"type":327,"attrs":364,"content":365},{"textAlign":59},[366,370],{"text":367,"type":332,"marks":368},"Outgoing (“reverse”) SSO:",[369],{"type":358},{"text":371,"type":332}," after a transaction completes, Foxy can generate an authentication token from the receipt page and pass it to your site, logging the customer in automatically.",{"type":327,"attrs":373,"content":374},{"textAlign":59},[375],{"text":376,"type":332},"The basic flow for checkout SSO:",{"type":378,"attrs":379,"content":381},"ordered_list",{"order":380},1,[382,389,396,403],{"type":349,"content":383},[384],{"type":327,"attrs":385,"content":386},{"textAlign":59},[387],{"text":388,"type":332},"A customer creates an account or logs into your site.",{"type":349,"content":390},[391],{"type":327,"attrs":392,"content":393},{"textAlign":59},[394],{"text":395,"type":332},"Your site syncs that customer’s information to Foxy using the API.",{"type":349,"content":397},[398],{"type":327,"attrs":399,"content":400},{"textAlign":59},[401],{"text":402,"type":332},"When the customer starts checkout, Foxy redirects them to your SSO endpoint.",{"type":349,"content":404},[405],{"type":327,"attrs":406,"content":407},{"textAlign":59},[408],{"text":409,"type":332},"Your endpoint checks the customer’s authentication status on your site (using session or cookie data), then either sends them back to checkout authenticated, sends them back unauthenticated, or takes another action such as redirecting to a login or registration page.",{"type":334,"attrs":411,"content":412},{"level":336,"textAlign":59},[413],{"text":414,"type":332},"Alternate uses",{"type":327,"attrs":416,"content":417},{"textAlign":59},[418],{"text":419,"type":332},"Beyond standard single sign-on, the same mechanism supports a few other scenarios:",{"type":346,"content":421},[422,429,436],{"type":349,"content":423},[424],{"type":327,"attrs":425,"content":426},{"textAlign":59},[427],{"text":428,"type":332},"Making checkout entirely private, requiring authentication before purchase, for members-only stores or similar setups.",{"type":349,"content":430},[431],{"type":327,"attrs":432,"content":433},{"textAlign":59},[434],{"text":435,"type":332},"Validating a customer’s cart before checkout, such as confirming order limits, applied discounts, or referrer and coupon values.",{"type":349,"content":437},[438],{"type":327,"attrs":439,"content":440},{"textAlign":59},[441],{"text":442,"type":332},"Offering single-click upsells on the receipt, or logging a customer into your site automatically after checkout, using outgoing SSO.",{"type":334,"attrs":444,"content":445},{"level":336,"textAlign":59},[446],{"text":447,"type":332},"Requirements",{"type":327,"attrs":449,"content":450},{"textAlign":59},[451],{"text":452,"type":332},"SSO requires a working site and Foxy setup that uses the API to keep your customer records synced with Foxy’s.",{"type":334,"attrs":454,"content":455},{"level":336,"textAlign":59},[456],{"text":457,"type":332},"Identifying customers: email vs. customer ID",{"type":327,"attrs":459,"content":460},{"textAlign":59},[461],{"text":462,"type":332},"Foxy treats a customer’s email as a unique identifier, so no two customers in a store can share one. If your system allows customers to change their email, filtering by email may not capture a customer’s full purchase history, since past purchases stay tied to whatever email was active at the time. If your database can store custom attributes, store the Foxy customer ID alongside the customer record. Unlike email, it never changes, making it a more reliable long-term identifier.",{"type":334,"attrs":464,"content":465},{"level":336,"textAlign":59},[466],{"text":467,"type":332},"Best practices",{"type":327,"attrs":469,"content":470},{"textAlign":59},[471],{"text":472,"type":332},"Allow checkout as a guest, or at least without requiring registration on your site first, whenever possible. This keeps the fewest hurdles between a customer and a completed purchase. Customers can still be synced on both sides either way: from your site to Foxy using the API, and from Foxy to your site using webhooks after checkout.",{"type":334,"attrs":474,"content":475},{"level":336,"textAlign":59},[476],{"text":477,"type":332},"Notes",{"type":346,"content":479},[480],{"type":349,"content":481},[482],{"type":327,"attrs":483,"content":484},{"textAlign":59},[485],{"text":486,"type":332},"SSO shouldn’t be combined with checkout pre-population to set customer values, since the two features can conflict. Combining them is possible but requires thorough testing before relying on it.",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":488},{},"What Foxy's single sign-on (SSO) is and how it lets customers skip re-authenticating at checkout or after completing a purchase.","89b14cf6-52cb-41c8-8aed-7ceae33cb271",[],"single-sign-on-overview","help\u002Farticles\u002Fsingle-sign-on-overview",-3680,[],2659,"921b4dbb-122c-4dab-a930-51e15fb8410f",[],{"html":500,"sections":501,"segments":515},"\u003Cp>Foxy’s single sign-on (SSO) lets customers who are already logged into your website skip re-entering their username and password when they reach checkout. It also works in reverse, letting you authenticate a customer on your own site after they complete a purchase through Foxy.\u003C\u002Fp>\u003Csection id=\"how-it-works\" data-title=\"How it works\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"how-it-works\">How it works\u003C\u002Fh2>\u003Cp>SSO covers two directions:\u003C\u002Fp>\u003Cul>\u003Cli>\u003Cp>\u003Cstrong>Checkout SSO (incoming):\u003C\u002Fstrong> when a customer who’s already logged into your site proceeds to checkout, your site’s SSO endpoint passes an authentication token to Foxy. If the token is valid, the customer skips re-entering their email and password. For security, a saved credit card still requires the CSC unless your store is configured to only require it for new cards.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Cstrong>Outgoing (“reverse”) SSO:\u003C\u002Fstrong> after a transaction completes, Foxy can generate an authentication token from the receipt page and pass it to your site, logging the customer in automatically.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003Cp>The basic flow for checkout SSO:\u003C\u002Fp>\u003Col class=\"step step-icon-sm step-dashed step-border-last-0 mt-3\">\u003Cli class=\"step-item\">\u003Cdiv class=\"step-content-wrapper\">\u003Cspan class=\"step-icon step-icon-soft-primary\">1\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>A customer creates an account or logs into your site.\u003C\u002Fp>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fli>\u003Cli class=\"step-item\">\u003Cdiv class=\"step-content-wrapper\">\u003Cspan class=\"step-icon step-icon-soft-primary\">2\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>Your site syncs that customer’s information to Foxy using the API.\u003C\u002Fp>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fli>\u003Cli class=\"step-item\">\u003Cdiv class=\"step-content-wrapper\">\u003Cspan class=\"step-icon step-icon-soft-primary\">3\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>When the customer starts checkout, Foxy redirects them to your SSO endpoint.\u003C\u002Fp>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fli>\u003Cli class=\"step-item\">\u003Cdiv class=\"step-content-wrapper\">\u003Cspan class=\"step-icon step-icon-soft-primary\">4\u003C\u002Fspan>\u003Cdiv class=\"w-100 overflow-hidden\">\u003Cdiv class=\"step-content mt-2\">\u003Cp>Your endpoint checks the customer’s authentication status on your site (using session or cookie data), then either sends them back to checkout authenticated, sends them back unauthenticated, or takes another action such as redirecting to a login or registration page.\u003C\u002Fp>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fdiv>\u003C\u002Fli>\u003C\u002Fol>\u003C\u002Fsection>\u003Csection id=\"alternate-uses\" data-title=\"Alternate uses\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"alternate-uses\">Alternate uses\u003C\u002Fh2>\u003Cp>Beyond standard single sign-on, the same mechanism supports a few other scenarios:\u003C\u002Fp>\u003Cul>\u003Cli>\u003Cp>Making checkout entirely private, requiring authentication before purchase, for members-only stores or similar setups.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Validating a customer’s cart before checkout, such as confirming order limits, applied discounts, or referrer and coupon values.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Offering single-click upsells on the receipt, or logging a customer into your site automatically after checkout, using outgoing SSO.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003C\u002Fsection>\u003Csection id=\"requirements\" data-title=\"Requirements\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"requirements\">Requirements\u003C\u002Fh2>\u003Cp>SSO requires a working site and Foxy setup that uses the API to keep your customer records synced with Foxy’s.\u003C\u002Fp>\u003C\u002Fsection>\u003Csection id=\"identifying-customers-email-vs-customer-id\" data-title=\"Identifying customers: email vs. customer ID\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"identifying-customers-email-vs-customer-id\">Identifying customers: email vs. customer ID\u003C\u002Fh2>\u003Cp>Foxy treats a customer’s email as a unique identifier, so no two customers in a store can share one. If your system allows customers to change their email, filtering by email may not capture a customer’s full purchase history, since past purchases stay tied to whatever email was active at the time. If your database can store custom attributes, store the Foxy customer ID alongside the customer record. Unlike email, it never changes, making it a more reliable long-term identifier.\u003C\u002Fp>\u003C\u002Fsection>\u003Csection id=\"best-practices\" data-title=\"Best practices\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"best-practices\">Best practices\u003C\u002Fh2>\u003Cp>Allow checkout as a guest, or at least without requiring registration on your site first, whenever possible. This keeps the fewest hurdles between a customer and a completed purchase. Customers can still be synced on both sides either way: from your site to Foxy using the API, and from Foxy to your site using webhooks after checkout.\u003C\u002Fp>\u003C\u002Fsection>\u003Csection id=\"notes\" data-title=\"Notes\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"notes\">Notes\u003C\u002Fh2>\u003Cul>\u003Cli>\u003Cp>SSO shouldn’t be combined with checkout pre-population to set customer values, since the two features can conflict. Combining them is possible but requires thorough testing before relying on it.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003C\u002Fsection>",[502,505,507,509,511,513],{"id":503,"title":339,"level":504},"how-it-works","H2",{"id":506,"title":414,"level":504},"alternate-uses",{"id":508,"title":447,"level":504},"requirements",{"id":510,"title":457,"level":504},"identifying-customers-email-vs-customer-id",{"id":512,"title":467,"level":504},"best-practices",{"id":514,"title":477,"level":504},"notes",[516],{"type":517,"content":518},"html","\u003Cp>Foxy’s single sign-on (SSO) lets customers who are already logged into your website skip re-entering their username and password when they reach checkout. It also works in reverse, letting you authenticate a customer on your own site after they complete a purchase through Foxy.\u003C\u002Fp>\u003Ch2>How it works\u003C\u002Fh2>\u003Cp>SSO covers two directions:\u003C\u002Fp>\u003Cul>\u003Cli>\u003Cp>\u003Cstrong>Checkout SSO (incoming):\u003C\u002Fstrong> when a customer who’s already logged into your site proceeds to checkout, your site’s SSO endpoint passes an authentication token to Foxy. If the token is valid, the customer skips re-entering their email and password. For security, a saved credit card still requires the CSC unless your store is configured to only require it for new cards.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>\u003Cstrong>Outgoing (“reverse”) SSO:\u003C\u002Fstrong> after a transaction completes, Foxy can generate an authentication token from the receipt page and pass it to your site, logging the customer in automatically.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003Cp>The basic flow for checkout SSO:\u003C\u002Fp>\u003Col order=\"1\">\u003Cli>\u003Cp>A customer creates an account or logs into your site.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Your site syncs that customer’s information to Foxy using the API.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>When the customer starts checkout, Foxy redirects them to your SSO endpoint.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Your endpoint checks the customer’s authentication status on your site (using session or cookie data), then either sends them back to checkout authenticated, sends them back unauthenticated, or takes another action such as redirecting to a login or registration page.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Fol>\u003Ch2>Alternate uses\u003C\u002Fh2>\u003Cp>Beyond standard single sign-on, the same mechanism supports a few other scenarios:\u003C\u002Fp>\u003Cul>\u003Cli>\u003Cp>Making checkout entirely private, requiring authentication before purchase, for members-only stores or similar setups.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Validating a customer’s cart before checkout, such as confirming order limits, applied discounts, or referrer and coupon values.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Offering single-click upsells on the receipt, or logging a customer into your site automatically after checkout, using outgoing SSO.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003Ch2>Requirements\u003C\u002Fh2>\u003Cp>SSO requires a working site and Foxy setup that uses the API to keep your customer records synced with Foxy’s.\u003C\u002Fp>\u003Ch2>Identifying customers: email vs. customer ID\u003C\u002Fh2>\u003Cp>Foxy treats a customer’s email as a unique identifier, so no two customers in a store can share one. If your system allows customers to change their email, filtering by email may not capture a customer’s full purchase history, since past purchases stay tied to whatever email was active at the time. If your database can store custom attributes, store the Foxy customer ID alongside the customer record. Unlike email, it never changes, making it a more reliable long-term identifier.\u003C\u002Fp>\u003Ch2>Best practices\u003C\u002Fh2>\u003Cp>Allow checkout as a guest, or at least without requiring registration on your site first, whenever possible. This keeps the fewest hurdles between a customer and a completed purchase. Customers can still be synced on both sides either way: from your site to Foxy using the API, and from Foxy to your site using webhooks after checkout.\u003C\u002Fp>\u003Ch2>Notes\u003C\u002Fh2>\u003Cul>\u003Cli>\u003Cp>SSO shouldn’t be combined with checkout pre-population to set customer values, since the two features can conflict. Combining them is possible but requires thorough testing before relying on it.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>",{"name":520,"created_at":521,"published_at":522,"updated_at":523,"id":524,"uuid":47,"content":525,"slug":48,"full_slug":48,"sort_by_date":59,"position":704,"tag_list":705,"is_startpage":24,"parent_id":59,"meta_data":59,"group_id":706,"first_published_at":707,"release_id":59,"lang":65,"path":59,"alternates":708,"default_full_slug":59,"translated_slugs":59},"Contact","2022-09-23T19:56:58.957Z","2025-05-08T18:24:40.382Z","2025-05-08T18:24:40.392Z",3138,{"seo":526,"_uid":529,"title":530,"action":531,"fields":532,"method":680,"columns":681,"subtitle":695,"component":48,"button_text":701,"submit_title":702,"submit_subtitle":703},{"_uid":527,"title":520,"plugin":528,"description":13},"24ff7574-3bcc-48d2-85b5-e529dfea1cc4","meta-fields","8f54f1da-9d8f-49b2-89e7-840e886491cb","We're here to help.","https:\u002F\u002Fusebasin.com\u002Ff\u002F029f48d65402",[533,538,542,651,654,659,674],{"_uid":534,"name":535,"type":332,"label":536,"options":13,"required":33,"component":537,"placeholder":13},"9a70b226-2036-4f90-a052-b3efa61c5896","name","Name","form___field",{"_uid":539,"name":540,"type":540,"label":541,"options":13,"required":33,"component":537,"placeholder":13},"86ba35be-ff43-4a28-8633-14052a8f6622","email","Email Address",{"_uid":543,"name":544,"type":545,"label":546,"options":547,"required":33,"component":537,"conditions":548,"placeholder":13},"3f827475-492c-4f97-aa1e-2386ac263b6c","topic","select","Topic","Presales, Support, Billing, Partnerships, Order Enquiry, Other",[549,605,615,622,630,638,644],{"_uid":550,"equals":551,"fields":552,"component":604},"e21d97dd-e68e-4fa6-ba97-bc40f3041dde","Order Enquiry",[553],{"_uid":554,"body":555,"type":602,"title":13,"component":603},"b64992bc-6d53-48b8-b7a0-d81e5a062e50",{"type":324,"content":556},[557],{"type":327,"content":558},[559,561,569,571,573,574,578,580,585,593,595,600],{"text":560,"type":332},"We are ",{"text":562,"type":332,"marks":563},"Foxy.io",[564],{"type":565,"attrs":566},"link",{"href":567,"uuid":59,"anchor":59,"custom":568,"target":59,"linktype":31},"http:\u002F\u002FFoxy.io",{},{"text":570,"type":332},", an ecommerce platform powering ecommerce for other merchants. We do not sell products, and are unable to assist with questions about order statuses or refunds for any merchants using our platform. Please contact the merchant you ordered from for assistance. If you’d like to report a store using Foxy for fraudulent practices, please select ‘other’ in the subject.",{"type":572},"hard_break",{"type":572},{"text":575,"type":332,"marks":576},"NOTE:",[577],{"type":358},{"text":579,"type":332}," We are ",{"text":581,"type":332,"marks":582},"not ",[583],{"type":584},"italic",{"text":586,"type":332,"marks":587},"Foxy.in",[588,592],{"type":565,"attrs":589},{"href":590,"uuid":59,"anchor":59,"custom":591,"target":59,"linktype":31},"http:\u002F\u002FFoxy.in",{},{"type":584},{"text":594,"type":332},". We are not in any way affiliated with ",{"text":586,"type":332,"marks":596},[597],{"type":565,"attrs":598},{"href":590,"uuid":59,"anchor":59,"custom":599,"target":59,"linktype":31},{},{"text":601,"type":332},", and cannot help in any way with your order from that website.","danger","global___alert","form___condition",{"_uid":606,"equals":607,"fields":608,"component":604},"8765c3e1-25cf-44aa-b8ea-fc6094acf9c3","Presales",[609],{"_uid":610,"name":611,"type":612,"label":13,"options":13,"required":24,"component":537,"conditions":613,"placeholder":13,"default_value":614},"cf464f8e-d643-4f6e-af29-d3abffaf7380","department_email_address","hidden",[],"hello@foxy.io",{"_uid":616,"equals":208,"fields":617,"component":604},"4007b6d8-77e5-421d-bd1e-6f336dd853fb",[618],{"_uid":619,"name":611,"type":612,"label":13,"options":13,"required":24,"component":537,"conditions":620,"placeholder":13,"default_value":621},"7b4c6aa5-a68c-45e0-9ce1-0a36af10c0c2",[],"help@foxy.io",{"_uid":623,"equals":624,"fields":625,"component":604},"1dbb8f11-613d-43cd-9e09-1b94f6e19219","Billing",[626],{"_uid":627,"name":611,"type":612,"label":13,"options":13,"required":24,"component":537,"conditions":628,"placeholder":13,"default_value":629},"a0ac0d1b-bc4f-4a6c-a682-581d450b0b73",[],"help+billing@foxy.io",{"_uid":631,"equals":632,"fields":633,"component":604},"a0a53a50-7172-4a29-ba58-181e38874e12","Partnerships",[634],{"_uid":635,"name":611,"type":612,"label":13,"options":13,"required":24,"component":537,"conditions":636,"placeholder":13,"default_value":637},"7aa011d9-f374-4aed-b5a5-929b54aaf152",[],"partners@foxy.io",{"_uid":639,"equals":551,"fields":640,"component":604},"a4cd431f-25d5-41c7-bfdc-02c908c8fb47",[641],{"_uid":642,"name":611,"type":612,"label":13,"options":13,"required":24,"component":537,"conditions":643,"placeholder":13,"default_value":614},"f5d52168-d6ae-451b-94ee-2ced1cbd28ad",[],{"_uid":645,"equals":646,"fields":647,"component":604},"25aba1ed-eb41-4bbc-aa89-f7a7167ea86e","Other",[648],{"_uid":649,"name":611,"type":612,"label":13,"options":13,"required":24,"component":537,"conditions":650,"placeholder":13,"default_value":614},"f40dfaef-c203-4b71-bf4e-e1b43cef192b",[],{"_uid":652,"component":653},"e9c53a05-f40a-4510-aaf8-bc072a235a0c","form___subject",{"_uid":655,"name":656,"type":657,"label":658,"options":13,"required":33,"component":537,"placeholder":13},"a4c4d385-fff4-4978-99fb-b68cfea623d6","message","textarea","Message",{"_uid":660,"name":661,"type":545,"label":662,"options":663,"required":33,"component":537,"conditions":664,"placeholder":13},"8a3c9f85-f438-427d-9c7a-d7b295a14b5b","existing_user","Are you an existing user?","No, Yes",[665],{"_uid":666,"equals":667,"fields":668,"component":604},"115933d6-262a-4b59-8fa8-579c5ad73de1","Yes",[669],{"_uid":670,"name":671,"type":332,"label":672,"options":13,"required":33,"component":537,"conditions":673,"placeholder":13},"44b6ff23-98f0-4e95-b7f5-c23e06415c2d","subdomain","Store Subdomain",[],{"_uid":675,"name":676,"type":545,"label":677,"options":678,"required":33,"component":537,"conditions":679,"placeholder":13},"922a5cef-3af2-4113-8855-36c7910e3ee3","user_type","What type of user are you?","Developer, Designer, Merchant",[],"POST",[682],{"_uid":683,"text":684,"title":693,"component":694},"7323b90d-a93a-4bf1-baa9-20d0b7ead61b",{"type":324,"content":685},[686],{"type":327,"content":687},[688,690,691],{"text":689,"type":332},"855.369.9227",{"type":572},{"text":692,"type":332},"9:30am-6pm Central M-F","Pre-sales, Sales, & Partnerships","contact___footer_column",{"type":324,"content":696},[697],{"type":327,"content":698},[699],{"text":700,"type":332},"Get in touch to get help from our friendly support team.","Submit","Success!","Your email has been received. We'll get back to you as soon as we can, but it might take a business day. If you don't hear back from us in a timely manner, please check your spam folder to ensure our reply didn't go there.",-80,[],"2fd9fb7d-a48a-4184-acfd-30022d8d6f08","2022-09-23T20:10:45.360Z",[],[288,710],{"name":711,"created_at":712,"published_at":713,"updated_at":714,"id":715,"uuid":490,"content":716,"slug":729,"full_slug":730,"sort_by_date":59,"position":731,"tag_list":732,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":733,"first_published_at":713,"release_id":59,"lang":65,"path":59,"alternates":734,"default_full_slug":59,"translated_slugs":59},"Single Sign-On (SSO)","2026-07-17T05:25:13.805Z","2026-07-17T05:44:46.437Z","2026-07-17T05:44:46.448Z",198968581389720,{"_uid":717,"icon":13,"name":711,"type":718,"pinned":24,"summary":719,"category":13,"component":297,"blog_posts":720,"icon_custom":721,"case_studies":723,"faq_sections":724,"featured_guides":725,"mailbox_category":13,"featured_articles":726,"featured_blog_posts":727,"featured_case_studies":728},"621919dd-dfb3-4b25-a3f6-d056127fc3a2","simple","How to set up single sign-on between your website and Foxy, covering checkout authentication, outgoing SSO on the receipt, and keeping customer data in sync.",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":722},{},[],[],[],[],[],[],"single-sign-on","help\u002Fcategories\u002Fsingle-sign-on",-720,[],"51903714-6c5b-45ba-b8a6-5bf411ffb056",[],{},1784267941061]