[{"data":1,"prerenderedAt":747},["ShallowReactive",2],{"header:help":3,"footer:default":67,"story:navigation\u002Fsearch:help":250,"story:help\u002Fcategories":288,"story:help\u002Farticles\u002Fcustomers-overview":314,"no-guide:customers-overview":59,"article:\u002Fhelp\u002Farticles\u002Fcustomers-overview":511,"story:contact":530,"help:tree:c8c77dda-a2f7-4fb0-833f-e671a7acc303":719,"_apollo:default":746},{"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":504,"full_slug":505,"sort_by_date":59,"position":506,"tag_list":507,"is_startpage":24,"parent_id":508,"meta_data":59,"group_id":509,"first_published_at":317,"release_id":59,"lang":65,"path":59,"alternates":510,"default_full_slug":59,"translated_slugs":59},"Customers Overview","2026-06-04T19:33:50.333Z","2026-06-04T20:04:53.097Z","2026-06-04T20:04:53.111Z",183959676296233,"c8c77dda-a2f7-4fb0-833f-e671a7acc303",{"_uid":322,"body":323,"name":315,"image":500,"pinned":33,"summary":13,"category":502,"component":266,"related_articles":503},"3218a161-3062-4c70-9ae0-2ba72b5431aa",{"type":324,"content":325},"doc",[326,333,340,355,360,365,370,376,422,435,440,470,478,487],{"type":327,"attrs":328,"content":329},"paragraph",{"textAlign":59},[330],{"text":331,"type":332},"Without the customer, e-commerce wouldn't be very exciting (or profitable), so a thorough understanding of the customer as treated by Foxy is important for any merchant or developer using Foxy.","text",{"type":334,"attrs":335,"content":337},"heading",{"level":336,"textAlign":59},2,[338],{"text":339,"type":332},"How Customers Are Defined and Created",{"type":327,"attrs":341,"content":342},{"textAlign":59},[343,345,353],{"text":344,"type":332},"There are a few ways to create a customer record in Foxy. The first and most common is to allow the customer record to be created automatically upon a successful transaction. The second method is to create the customer record directly in the admin or via ",{"text":346,"type":332,"marks":347},"the API",[348],{"type":349,"attrs":350},"link",{"href":351,"uuid":59,"anchor":59,"target":352,"linktype":31},"https:\u002F\u002Fapi.foxycart.com\u002Fdocs","_self",{"text":354,"type":332},".",{"type":327,"attrs":356,"content":357},{"textAlign":59},[358],{"text":359,"type":332},"Regardless the method of creation, the single most important piece of a customer record is the email address used. The email address can be considered the unique key for the customer; there cannot be two different (non-guest) customer records with the same email address in a single store.",{"type":334,"attrs":361,"content":362},{"level":336,"textAlign":59},[363],{"text":364,"type":332},"Guest Customers and Saved Customers",{"type":327,"attrs":366,"content":367},{"textAlign":59},[368],{"text":369,"type":332},"Depending on the store configuration, Foxy can allow customers to checkout as guests or to checkout with an account.",{"type":334,"attrs":371,"content":373},{"level":372,"textAlign":59},3,[374],{"text":375,"type":332},"Guest customers",{"type":377,"content":378},"bullet_list",[379,387,394,401,408,415],{"type":380,"content":381},"list_item",[382],{"type":327,"attrs":383,"content":384},{"textAlign":59},[385],{"text":386,"type":332},"Do not enter a password.",{"type":380,"content":388},[389],{"type":327,"attrs":390,"content":391},{"textAlign":59},[392],{"text":393,"type":332},"Can enter an email address already used by other guest or saved customer records.",{"type":380,"content":395},[396],{"type":327,"attrs":397,"content":398},{"textAlign":59},[399],{"text":400,"type":332},"Cannot purchase a subscription. (Guest mode as an option is hidden if a subscription is in the cart.)",{"type":380,"content":402},[403],{"type":327,"attrs":404,"content":405},{"textAlign":59},[406],{"text":407,"type":332},"Cannot be retrieved, created or edited via the API.",{"type":380,"content":409},[410],{"type":327,"attrs":411,"content":412},{"textAlign":59},[413],{"text":414,"type":332},"Cannot retrieve their information if they purchase again in the future and enter their previously used email. (Because they have no password, there'd be no way for the customer to authenticate anyway.)",{"type":380,"content":416},[417],{"type":327,"attrs":418,"content":419},{"textAlign":59},[420],{"text":421,"type":332},"Cannot be converted into a non-guest customer.",{"type":327,"attrs":423,"content":424},{"textAlign":59},[425,427,434],{"text":426,"type":332},"To set up your checkout to use guest customers only, follow the instructions ",{"text":428,"type":332,"marks":429},"here",[430],{"type":349,"attrs":431},{"href":432,"uuid":433,"anchor":59,"target":352,"linktype":14},"\u002Fhelp\u002Farticles\u002Fset-up-guest-only-checkout","e39672c4-df36-40cf-9753-45c8c9f12f88",{"text":354,"type":332},{"type":334,"attrs":436,"content":437},{"level":372,"textAlign":59},[438],{"text":439,"type":332},"Non-guest customers",{"type":377,"content":441},[442,449,456,463],{"type":380,"content":443},[444],{"type":327,"attrs":445,"content":446},{"textAlign":59},[447],{"text":448,"type":332},"Must have an email address unique among non-guest customers.",{"type":380,"content":450},[451],{"type":327,"attrs":452,"content":453},{"textAlign":59},[454],{"text":455,"type":332},"Can be created and edited via the API.",{"type":380,"content":457},[458],{"type":327,"attrs":459,"content":460},{"textAlign":59},[461],{"text":462,"type":332},"Can enter their previously used password when returning to a checkout page, or can checkout as a guest (if guest checkout is allowed by the store) to have their saved information automatically populated on the checkout.",{"type":380,"content":464},[465],{"type":327,"attrs":466,"content":467},{"textAlign":59},[468],{"text":469,"type":332},"Cannot be converted into a guest customer.",{"type":334,"attrs":471,"content":472},{"level":336,"textAlign":59},[473],{"text":474,"type":332,"marks":475},"Saved Payment Information",[476],{"type":477},"bold",{"type":327,"attrs":479,"content":480},{"textAlign":59},[481,485],{"text":482,"type":332,"marks":483},"Customers can have one and only one saved payment method",[484],{"type":477},{"text":486,"type":332}," associated with their account. If a customer has a subscription associated with his or her account, the checkbox to elect to save the payment method on checkout is required to be checked, and an error explaining this is displayed if it is unchecked.",{"type":327,"attrs":488,"content":489},{"textAlign":59},[490,492,498],{"text":491,"type":332},"What is important to note is that if a customer has an active subscription being paid for by credit card xxxx1234 and makes another purchase in the future using card xxx5678, that new card becomes the only saved payment method for the customer, and all active subscriptions will use that new card when they run. (While this may sound problematic, in 3+ years we haven't heard of it being an issue. That said, if you have a situation where multiple separate payment methods are required please ",{"text":493,"type":332,"marks":494},"let us know",[495],{"type":349,"attrs":496},{"href":497,"uuid":59,"anchor":59,"target":352,"linktype":31},"https:\u002F\u002Fwww.foxy.io\u002Fcontact\u002F",{"text":499,"type":332},".)",{"id":59,"alt":59,"name":13,"focus":59,"title":59,"source":59,"filename":13,"copyright":59,"fieldtype":81,"meta_data":501},{},"28ceb72a-9aff-4499-a48e-7616f7d17033",[],"customers-overview","help\u002Farticles\u002Fcustomers-overview",-1990,[],2659,"59190466-e173-44de-a54c-12cdb3faa662",[],{"html":512,"sections":513,"segments":526},"\u003Cp>Without the customer, e-commerce wouldn't be very exciting (or profitable), so a thorough understanding of the customer as treated by Foxy is important for any merchant or developer using Foxy.\u003C\u002Fp>\u003Csection id=\"how-customers-are-defined-and-created\" data-title=\"How Customers Are Defined and Created\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"how-customers-are-defined-and-created\">How Customers Are Defined and Created\u003C\u002Fh2>\u003Cp>There are a few ways to create a customer record in Foxy. The first and most common is to allow the customer record to be created automatically upon a successful transaction. The second method is to create the customer record directly in the admin or via \u003Ca href=\"https:\u002F\u002Fapi.foxycart.com\u002Fdocs\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">the API\u003C\u002Fa>.\u003C\u002Fp>\u003Cp>Regardless the method of creation, the single most important piece of a customer record is the email address used. The email address can be considered the unique key for the customer; there cannot be two different (non-guest) customer records with the same email address in a single store.\u003C\u002Fp>\u003C\u002Fsection>\u003Csection id=\"guest-customers-and-saved-customers\" data-title=\"Guest Customers and Saved Customers\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"guest-customers-and-saved-customers\">Guest Customers and Saved Customers\u003C\u002Fh2>\u003Cp>Depending on the store configuration, Foxy can allow customers to checkout as guests or to checkout with an account.\u003C\u002Fp>\u003C\u002Fsection>\u003Csection id=\"guest-customers\" data-title=\"Guest customers\" data-title-node=\"H3\">\u003Ch3 data-anchor-id=\"guest-customers\">Guest customers\u003C\u002Fh3>\u003Cul>\u003Cli>\u003Cp>Do not enter a password.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Can enter an email address already used by other guest or saved customer records.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Cannot purchase a subscription. (Guest mode as an option is hidden if a subscription is in the cart.)\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Cannot be retrieved, created or edited via the API.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Cannot retrieve their information if they purchase again in the future and enter their previously used email. (Because they have no password, there'd be no way for the customer to authenticate anyway.)\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Cannot be converted into a non-guest customer.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003Cp>To set up your checkout to use guest customers only, follow the instructions \u003Ca href=\"\u002Fhelp\u002Farticles\u002Fset-up-guest-only-checkout\" target=\"_self\">here\u003C\u002Fa>.\u003C\u002Fp>\u003C\u002Fsection>\u003Csection id=\"non-guest-customers\" data-title=\"Non-guest customers\" data-title-node=\"H3\">\u003Ch3 data-anchor-id=\"non-guest-customers\">Non-guest customers\u003C\u002Fh3>\u003Cul>\u003Cli>\u003Cp>Must have an email address unique among non-guest customers.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Can be created and edited via the API.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Can enter their previously used password when returning to a checkout page, or can checkout as a guest (if guest checkout is allowed by the store) to have their saved information automatically populated on the checkout.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Cannot be converted into a guest customer.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003C\u002Fsection>\u003Csection id=\"saved-payment-information\" data-title=\"Saved Payment Information\" data-title-node=\"H2\">\u003Chr class=\"my-8\" style=\"margin-left: -48px; margin-right: -40vw\">\u003Ch2 data-anchor-id=\"saved-payment-information\">\u003Cstrong>Saved Payment Information\u003C\u002Fstrong>\u003C\u002Fh2>\u003Cp>\u003Cstrong>Customers can have one and only one saved payment method\u003C\u002Fstrong> associated with their account. If a customer has a subscription associated with his or her account, the checkbox to elect to save the payment method on checkout is required to be checked, and an error explaining this is displayed if it is unchecked.\u003C\u002Fp>\u003Cp>What is important to note is that if a customer has an active subscription being paid for by credit card xxxx1234 and makes another purchase in the future using card xxx5678, that new card becomes the only saved payment method for the customer, and all active subscriptions will use that new card when they run. (While this may sound problematic, in 3+ years we haven't heard of it being an issue. That said, if you have a situation where multiple separate payment methods are required please \u003Ca href=\"https:\u002F\u002Fwww.foxy.io\u002Fcontact\u002F\" target=\"_self\" class=\"\">let us know\u003C\u002Fa>.)\u003C\u002Fp>\u003C\u002Fsection>",[514,517,519,522,524],{"id":515,"title":339,"level":516},"how-customers-are-defined-and-created","H2",{"id":518,"title":364,"level":516},"guest-customers-and-saved-customers",{"id":520,"title":375,"level":521},"guest-customers","H3",{"id":523,"title":439,"level":521},"non-guest-customers",{"id":525,"title":474,"level":516},"saved-payment-information",[527],{"type":528,"content":529},"html","\u003Cp>Without the customer, e-commerce wouldn't be very exciting (or profitable), so a thorough understanding of the customer as treated by Foxy is important for any merchant or developer using Foxy.\u003C\u002Fp>\u003Ch2>How Customers Are Defined and Created\u003C\u002Fh2>\u003Cp>There are a few ways to create a customer record in Foxy. The first and most common is to allow the customer record to be created automatically upon a successful transaction. The second method is to create the customer record directly in the admin or via \u003Ca href=\"https:\u002F\u002Fapi.foxycart.com\u002Fdocs\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"\">the API\u003C\u002Fa>.\u003C\u002Fp>\u003Cp>Regardless the method of creation, the single most important piece of a customer record is the email address used. The email address can be considered the unique key for the customer; there cannot be two different (non-guest) customer records with the same email address in a single store.\u003C\u002Fp>\u003Ch2>Guest Customers and Saved Customers\u003C\u002Fh2>\u003Cp>Depending on the store configuration, Foxy can allow customers to checkout as guests or to checkout with an account.\u003C\u002Fp>\u003Ch3>Guest customers\u003C\u002Fh3>\u003Cul>\u003Cli>\u003Cp>Do not enter a password.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Can enter an email address already used by other guest or saved customer records.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Cannot purchase a subscription. (Guest mode as an option is hidden if a subscription is in the cart.)\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Cannot be retrieved, created or edited via the API.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Cannot retrieve their information if they purchase again in the future and enter their previously used email. (Because they have no password, there'd be no way for the customer to authenticate anyway.)\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Cannot be converted into a non-guest customer.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003Cp>To set up your checkout to use guest customers only, follow the instructions \u003Ca href=\"\u002Fhelp\u002Farticles\u002Fset-up-guest-only-checkout\" target=\"_self\">here\u003C\u002Fa>.\u003C\u002Fp>\u003Ch3>Non-guest customers\u003C\u002Fh3>\u003Cul>\u003Cli>\u003Cp>Must have an email address unique among non-guest customers.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Can be created and edited via the API.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Can enter their previously used password when returning to a checkout page, or can checkout as a guest (if guest checkout is allowed by the store) to have their saved information automatically populated on the checkout.\u003C\u002Fp>\u003C\u002Fli>\u003Cli>\u003Cp>Cannot be converted into a guest customer.\u003C\u002Fp>\u003C\u002Fli>\u003C\u002Ful>\u003Ch2>\u003Cstrong>Saved Payment Information\u003C\u002Fstrong>\u003C\u002Fh2>\u003Cp>\u003Cstrong>Customers can have one and only one saved payment method\u003C\u002Fstrong> associated with their account. If a customer has a subscription associated with his or her account, the checkbox to elect to save the payment method on checkout is required to be checked, and an error explaining this is displayed if it is unchecked.\u003C\u002Fp>\u003Cp>What is important to note is that if a customer has an active subscription being paid for by credit card xxxx1234 and makes another purchase in the future using card xxx5678, that new card becomes the only saved payment method for the customer, and all active subscriptions will use that new card when they run. (While this may sound problematic, in 3+ years we haven't heard of it being an issue. That said, if you have a situation where multiple separate payment methods are required please \u003Ca href=\"https:\u002F\u002Fwww.foxy.io\u002Fcontact\u002F\" target=\"_self\" class=\"\">let us know\u003C\u002Fa>.)\u003C\u002Fp>",{"name":531,"created_at":532,"published_at":533,"updated_at":534,"id":535,"uuid":47,"content":536,"slug":48,"full_slug":48,"sort_by_date":59,"position":714,"tag_list":715,"is_startpage":24,"parent_id":59,"meta_data":59,"group_id":716,"first_published_at":717,"release_id":59,"lang":65,"path":59,"alternates":718,"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":537,"_uid":540,"title":541,"action":542,"fields":543,"method":690,"columns":691,"subtitle":705,"component":48,"button_text":711,"submit_title":712,"submit_subtitle":713},{"_uid":538,"title":531,"plugin":539,"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",[544,549,553,661,664,669,684],{"_uid":545,"name":546,"type":332,"label":547,"options":13,"required":33,"component":548,"placeholder":13},"9a70b226-2036-4f90-a052-b3efa61c5896","name","Name","form___field",{"_uid":550,"name":551,"type":551,"label":552,"options":13,"required":33,"component":548,"placeholder":13},"86ba35be-ff43-4a28-8633-14052a8f6622","email","Email Address",{"_uid":554,"name":555,"type":556,"label":557,"options":558,"required":33,"component":548,"conditions":559,"placeholder":13},"3f827475-492c-4f97-aa1e-2386ac263b6c","topic","select","Topic","Presales, Support, Billing, Partnerships, Order Enquiry, Other",[560,615,625,632,640,648,654],{"_uid":561,"equals":562,"fields":563,"component":614},"e21d97dd-e68e-4fa6-ba97-bc40f3041dde","Order Enquiry",[564],{"_uid":565,"body":566,"type":612,"title":13,"component":613},"b64992bc-6d53-48b8-b7a0-d81e5a062e50",{"type":324,"content":567},[568],{"type":327,"content":569},[570,572,579,581,583,584,588,590,595,603,605,610],{"text":571,"type":332},"We are ",{"text":573,"type":332,"marks":574},"Foxy.io",[575],{"type":349,"attrs":576},{"href":577,"uuid":59,"anchor":59,"custom":578,"target":59,"linktype":31},"http:\u002F\u002FFoxy.io",{},{"text":580,"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":582},"hard_break",{"type":582},{"text":585,"type":332,"marks":586},"NOTE:",[587],{"type":477},{"text":589,"type":332}," We are ",{"text":591,"type":332,"marks":592},"not ",[593],{"type":594},"italic",{"text":596,"type":332,"marks":597},"Foxy.in",[598,602],{"type":349,"attrs":599},{"href":600,"uuid":59,"anchor":59,"custom":601,"target":59,"linktype":31},"http:\u002F\u002FFoxy.in",{},{"type":594},{"text":604,"type":332},". We are not in any way affiliated with ",{"text":596,"type":332,"marks":606},[607],{"type":349,"attrs":608},{"href":600,"uuid":59,"anchor":59,"custom":609,"target":59,"linktype":31},{},{"text":611,"type":332},", and cannot help in any way with your order from that website.","danger","global___alert","form___condition",{"_uid":616,"equals":617,"fields":618,"component":614},"8765c3e1-25cf-44aa-b8ea-fc6094acf9c3","Presales",[619],{"_uid":620,"name":621,"type":622,"label":13,"options":13,"required":24,"component":548,"conditions":623,"placeholder":13,"default_value":624},"cf464f8e-d643-4f6e-af29-d3abffaf7380","department_email_address","hidden",[],"hello@foxy.io",{"_uid":626,"equals":208,"fields":627,"component":614},"4007b6d8-77e5-421d-bd1e-6f336dd853fb",[628],{"_uid":629,"name":621,"type":622,"label":13,"options":13,"required":24,"component":548,"conditions":630,"placeholder":13,"default_value":631},"7b4c6aa5-a68c-45e0-9ce1-0a36af10c0c2",[],"help@foxy.io",{"_uid":633,"equals":634,"fields":635,"component":614},"1dbb8f11-613d-43cd-9e09-1b94f6e19219","Billing",[636],{"_uid":637,"name":621,"type":622,"label":13,"options":13,"required":24,"component":548,"conditions":638,"placeholder":13,"default_value":639},"a0ac0d1b-bc4f-4a6c-a682-581d450b0b73",[],"help+billing@foxy.io",{"_uid":641,"equals":642,"fields":643,"component":614},"a0a53a50-7172-4a29-ba58-181e38874e12","Partnerships",[644],{"_uid":645,"name":621,"type":622,"label":13,"options":13,"required":24,"component":548,"conditions":646,"placeholder":13,"default_value":647},"7aa011d9-f374-4aed-b5a5-929b54aaf152",[],"partners@foxy.io",{"_uid":649,"equals":562,"fields":650,"component":614},"a4cd431f-25d5-41c7-bfdc-02c908c8fb47",[651],{"_uid":652,"name":621,"type":622,"label":13,"options":13,"required":24,"component":548,"conditions":653,"placeholder":13,"default_value":624},"f5d52168-d6ae-451b-94ee-2ced1cbd28ad",[],{"_uid":655,"equals":656,"fields":657,"component":614},"25aba1ed-eb41-4bbc-aa89-f7a7167ea86e","Other",[658],{"_uid":659,"name":621,"type":622,"label":13,"options":13,"required":24,"component":548,"conditions":660,"placeholder":13,"default_value":624},"f40dfaef-c203-4b71-bf4e-e1b43cef192b",[],{"_uid":662,"component":663},"e9c53a05-f40a-4510-aaf8-bc072a235a0c","form___subject",{"_uid":665,"name":666,"type":667,"label":668,"options":13,"required":33,"component":548,"placeholder":13},"a4c4d385-fff4-4978-99fb-b68cfea623d6","message","textarea","Message",{"_uid":670,"name":671,"type":556,"label":672,"options":673,"required":33,"component":548,"conditions":674,"placeholder":13},"8a3c9f85-f438-427d-9c7a-d7b295a14b5b","existing_user","Are you an existing user?","No, Yes",[675],{"_uid":676,"equals":677,"fields":678,"component":614},"115933d6-262a-4b59-8fa8-579c5ad73de1","Yes",[679],{"_uid":680,"name":681,"type":332,"label":682,"options":13,"required":33,"component":548,"conditions":683,"placeholder":13},"44b6ff23-98f0-4e95-b7f5-c23e06415c2d","subdomain","Store Subdomain",[],{"_uid":685,"name":686,"type":556,"label":687,"options":688,"required":33,"component":548,"conditions":689,"placeholder":13},"922a5cef-3af2-4113-8855-36c7910e3ee3","user_type","What type of user are you?","Developer, Designer, Merchant",[],"POST",[692],{"_uid":693,"text":694,"title":703,"component":704},"7323b90d-a93a-4bf1-baa9-20d0b7ead61b",{"type":324,"content":695},[696],{"type":327,"content":697},[698,700,701],{"text":699,"type":332},"855.369.9227",{"type":582},{"text":702,"type":332},"9:30am-6pm Central M-F","Pre-sales, Sales, & Partnerships","contact___footer_column",{"type":324,"content":706},[707],{"type":327,"content":708},[709],{"text":710,"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,720],{"name":721,"created_at":722,"published_at":723,"updated_at":724,"id":725,"uuid":502,"content":726,"slug":740,"full_slug":741,"sort_by_date":59,"position":742,"tag_list":743,"is_startpage":24,"parent_id":310,"meta_data":59,"group_id":744,"first_published_at":723,"release_id":59,"lang":65,"path":59,"alternates":745,"default_full_slug":59,"translated_slugs":59},"Customers","2023-01-19T16:16:54.964Z","2023-01-19T17:25:31.890Z","2023-01-19T17:25:31.909Z",28232,{"_uid":727,"icon":728,"name":721,"guides":729,"summary":730,"category":13,"component":297,"blog_posts":731,"content_hub":24,"icon_custom":732,"case_studies":733,"faq_sections":734,"help_articles":735,"featured_guides":736,"mailbox_category":13,"featured_articles":737,"featured_blog_posts":738,"featured_case_studies":739},"d2a7083c-603b-4b42-a6ee-86403e480bba","fa-user-tag",[],"Customer management, account creation, customer portal, and more.",[],{"id":59,"alt":59,"name":13,"focus":59,"title":59,"filename":13,"copyright":59,"fieldtype":81},[],[],[],[],[],[],[],"customers","help\u002Fcategories\u002Fcustomers",180,[],"ee2cb21b-988c-4477-adec-89f4bd9fa030",[],{},1784562227402]