https://wiki.foxycart.com/ Mon, 25 May 2026 10:15:20 +0000 FeedCreator 1.8 https://wiki.foxycart.com/_media/wiki/dokuwiki.svg https://wiki.foxycart.com/ https://wiki.foxycart.com/v/2.0/analytics?rev=1757079278&do=diff Store Analytics Add analytics and tracking libraries to your FoxyCart store to discover how customers interact with your site. Google Tag (GA4, Google Ads) The Google Tag integration allows you add tracking for Google Analytics 4 or Google Ads (or both) to your store. anonymous@undisclosed.example.com (Anonymous) Fri, 05 Sep 2025 13:34:38 +0000 https://wiki.foxycart.com/v/2.0/api?rev=1660322522&do=diff The FoxyCart API NOTE: This XML API will be deprecated Though this legacy XML API works and will continue to function in the future, it will not see any new functionality. We recommend any new integrations are built on top of our new Hypermedia API anonymous@undisclosed.example.com (Anonymous) Fri, 12 Aug 2022 16:42:02 +0000 https://wiki.foxycart.com/v/2.0/browser_support?rev=1493190150&do=diff Browser Support As of FoxyCart v2.0, we officially support (with our default templates): * Firefox, Chrome, Safari, Opera on desktop and mobile, for all versions within the past ~3 years. * IE10+ with full functionality. * IE9 without the default Sidecart cart, but with full functionality. anonymous@undisclosed.example.com (Anonymous) Wed, 26 Apr 2017 07:02:30 +0000 https://wiki.foxycart.com/v/2.0/cart?rev=1712068259&do=diff The Cart of The Foxy What Is The Cart? The “cart” in “FoxyCart” is where your products are stored for each visitor to your website. The cart itself is highly flexible, and can be loaded as HTML or as JSON, allowing for unlimited customization potential. When we say anonymous@undisclosed.example.com (Anonymous) Tue, 02 Apr 2024 14:30:59 +0000 https://wiki.foxycart.com/v/2.0/categories?rev=1592333571&do=diff Product Categories What Product Categories Are Categories offer a way to give products additional behaviors that cannot be accomplished by product options alone. While it's probably best to take a look at the category settings in your admin, we'll briefly discuss the functionality that categories offer. anonymous@undisclosed.example.com (Anonymous) Tue, 16 Jun 2020 18:52:51 +0000 https://wiki.foxycart.com/v/2.0/cheat_sheet?rev=1778143598&do=diff FoxyCart Cheat Sheet: Product and Cart Parameters Product Parameters Important Notes: * All product parameters will be trimmed of excess leading and trailing whitespace when added to the cart. This can cause problems with price validation if you're not careful. anonymous@undisclosed.example.com (Anonymous) Thu, 07 May 2026 08:46:38 +0000 https://wiki.foxycart.com/v/2.0/checkout?rev=1689771762&do=diff The Most Efficient One-Page Checkout Available What Is the Checkout? When we refer to the “checkout” we refer to the page (or pages, in other systems) where the customer enters their billing and payment information, and where they submit their order for processing. In general, anonymous@undisclosed.example.com (Anonymous) Wed, 19 Jul 2023 13:02:42 +0000 https://wiki.foxycart.com/v/2.0/cloudflare_and_foxy?rev=1570648876&do=diff Using CloudFlare with FoxyCart CloudFlare is a popular option for many of our users, and offers fantastic (and easy) protection for most website owners. That said, they do a lot of “interesting” things to speed up the internet. Generally, these things are wonderful, and work well. But what they do (particularly with regard to how they modify website's source, especially as it relates to JavaScript) is incredibly complicated, and we've seen it cause problems. anonymous@undisclosed.example.com (Anonymous) Wed, 09 Oct 2019 19:21:16 +0000 https://wiki.foxycart.com/v/2.0/content_security_policy?rev=1758151029&do=diff Managing script security with a Content Security Policy What is CSP? Content Security Policy (CSP) is an advanced security feature that acts like a “whitelist” for a web page, controlling which external scripts, styles, fonts, and other resources are allowed to load. You set (in the Foxy admin, under settings anonymous@undisclosed.example.com (Anonymous) Wed, 17 Sep 2025 23:17:09 +0000 https://wiki.foxycart.com/v/2.0/coupons_and_discounts?rev=1748973358&do=diff FoxyCart Coupons and Discounts Coupon codes can be a very significant marketing tool, so it's important to understand what is and isn't possible with FoxyCart's coupon and quantity discounting functionality. While coupon codes and quantity discounts may not seem inherently related, FoxyCart uses almost the same logic and syntax for both, so we'll discuss them together. anonymous@undisclosed.example.com (Anonymous) Tue, 03 Jun 2025 17:55:58 +0000 https://wiki.foxycart.com/v/2.0/custom_domain?rev=1751625296&do=diff Sugar, Spice, and Custom Subdomains IMPORTANT Anti-Fraud Considerations If you opt for a custom subdomain, we strongly recommend enabling our automatic reCAPTCHA integration, to prevent more advanced card testing attacks. We can't enable this automatically for custom domains, so it requires an extra step. Read on below for more info. anonymous@undisclosed.example.com (Anonymous) Fri, 04 Jul 2025 10:34:56 +0000 https://wiki.foxycart.com/v/2.0/customer_portal?rev=1750864994&do=diff Customer Portal Setup Instructions Enabling the portal The customer portal can be enabled from the Foxy admin at admin.foxy.io. Navigate to the Settings > Customer Portal section where you can configure the portal for your store. You need to specify an allowlist of domains where the portal is able to be utilised. Note that all domains have to begin with anonymous@undisclosed.example.com (Anonymous) Wed, 25 Jun 2025 15:23:14 +0000 https://wiki.foxycart.com/v/2.0/customers?rev=1768477610&do=diff Customers: Notes and Features Without the customer, e-commerce wouldn't be very exciting (or profitable), so a thorough understanding mof the customer as treated by FoxyCart is important for any merchant or developer using FoxyCart. How Customers Are Defined and Created anonymous@undisclosed.example.com (Anonymous) Thu, 15 Jan 2026 11:46:50 +0000 https://wiki.foxycart.com/v/2.0/emails?rev=1749692517&do=diff Email Receipts What's In an Email Receipt? [An example email receipt sent by FoxyCart using the default HTML Responsive template] FoxyCart's email receipts include almost everything in the web receipt, as well as any additional text you have configured in your receipt template(s). (You can see an example receipt to the right.) The major difference between the web receipt and the email receipts is that email receipts have specific sections that are only included in certain situations. anonymous@undisclosed.example.com (Anonymous) Thu, 12 Jun 2025 01:41:57 +0000 https://wiki.foxycart.com/v/2.0/fighting-fraud?rev=1623228464&do=diff Fraud Prevention in FoxyCart Foxy's Internal Abuse Prevention In addition to the options below, we have some systems in place to block more “obvious” fraud. We always recommend relying on your gateway's anti-fraud functionality, but you can rest easy knowing we'll prevent some of the more egregious abuse, before it even reaches your gateway. anonymous@undisclosed.example.com (Anonymous) Wed, 09 Jun 2021 08:47:44 +0000 https://wiki.foxycart.com/v/2.0/foxycarts_reason_for_being?rev=1493190150&do=diff FoxyCart's Reason for Being FoxyCart's raison d'être is simple: To provide web professionals with a powerful, flexible, secure, and enjoyable e-commerce platform with which to deliver more profitable e-commerce sites to their merchant clients. This focus on serving web professionals who in turn serve merchants is a unique approach, and can best be understood in the context of FoxyCart's birth. anonymous@undisclosed.example.com (Anonymous) Wed, 26 Apr 2017 07:02:30 +0000 https://wiki.foxycart.com/v/2.0/gift_cards?rev=1731427047&do=diff Gift Cards (aka Gift Certificates) in Foxy How Gift Cards Work Gift cards are similar to coupons in a few ways. Just as a “coupon” in Foxy defines the coupon itself, and the “coupon code” is the important bit that's entered by the customer, gift cards similarly have anonymous@undisclosed.example.com (Anonymous) Tue, 12 Nov 2024 15:57:27 +0000 https://wiki.foxycart.com/v/2.0/hmac_validation?rev=1734130561&do=diff HMAC Product Verification: Locking Down your Add-To-Cart Links and Forms The What & Why What Is FoxyCart's HMAC Product Verification? FoxyCart's HMAC Product Verification is a cryptographic method to prevent tampering with your product links and forms, available as of anonymous@undisclosed.example.com (Anonymous) Fri, 13 Dec 2024 22:56:01 +0000 https://wiki.foxycart.com/v/2.0/i18n?rev=1556941475&do=diff Internationalization & Translations The USA Is Not The Center Of The World [The sundial at Felicity, California, USA] At FoxyCart, we know that the USA isn't the center of the world And though we're a US-based company, our goal is to serve all web professionals, regardless of their country. That said, and even though we do have a very diverse international team, the only way we'll ever learn enough about your specific needs is for you to teach us. Please review what is and isn't supported bel… anonymous@undisclosed.example.com (Anonymous) Sat, 04 May 2019 03:44:35 +0000 https://wiki.foxycart.com/v/2.0/integrations?rev=1493190150&do=diff Integrations Version-specific integrations are coming soon. anonymous@undisclosed.example.com (Anonymous) Wed, 26 Apr 2017 07:02:30 +0000 https://wiki.foxycart.com/v/2.0/inventory_management?rev=1519621489&do=diff Product Inventory Management One common need for online stores is being able to track inventory levels for products on your store - decreasing inventory as successful transactions are made, and preventing products from being added to the cart if no stock is available. anonymous@undisclosed.example.com (Anonymous) Mon, 26 Feb 2018 05:04:49 +0000 https://wiki.foxycart.com/v/2.0/javascript?rev=1757079343&do=diff FoxyCart's JavaScript FoxyCart's JavaScript files are full of goodies that you probably won't ever need to think twice about. But if default configurations are an anathema to you, if you need to get advanced for a custom integration, or if you're just curious about what's under the hood please explore this page and anonymous@undisclosed.example.com (Anonymous) Fri, 05 Sep 2025 13:35:43 +0000 https://wiki.foxycart.com/v/2.0/json?rev=1643992659&do=diff JSON and JSONP with FoxyCart What is JSON? JSON stands for JavaScript Object Notation , and can be thought of as a very flexible method to store data. Conceptually it is similar to XML, but since it's actually a javascript object it's trivially easy to work with in javascript (whereas XML requires much more work to process by javascript). anonymous@undisclosed.example.com (Anonymous) Fri, 04 Feb 2022 16:37:39 +0000 https://wiki.foxycart.com/v/2.0/multicurrency?rev=1587490203&do=diff Multi-Currency Support in FoxyCart How Multi-Currency Functionality works in FoxyCart FoxyCart includes multi-currency in a couple ways - both changing the currency of the whole cart and dynamically converting a price from one currency to another. anonymous@undisclosed.example.com (Anonymous) Tue, 21 Apr 2020 17:30:03 +0000 https://wiki.foxycart.com/v/2.0/multiship?rev=1499222776&do=diff Multi-Ship: Multiple Shipping Addresses on a One-Page Checkout What is Multi-Ship? FoxyCart's “Multi-Ship” functionality allows for a single order to contain multiple “sub-orders” of sorts, each of which can be shipped to a separate address. While this option really doesn't make much sense for a anonymous@undisclosed.example.com (Anonymous) Wed, 05 Jul 2017 02:46:16 +0000 https://wiki.foxycart.com/v/2.0/payment_sets?rev=1500603055&do=diff Payment Sets FoxyCart's payment set functionality introduces the ability for a single store to offer different groups of payment gateway configurations. This can be very useful for situations where you need to only offer a specific set of payment options in different checkouts, whether based on the currency of the cart, or related to specific types of products. Payment sets are applied to a checkout session through the anonymous@undisclosed.example.com (Anonymous) Fri, 21 Jul 2017 02:10:55 +0000 https://wiki.foxycart.com/v/2.0/pre_cart_webhook?rev=1730403157&do=diff The Pre-Cart Webhook This is advanced functionality and is currently only available on our Advanced and Enterprise plans. Please contact us for additional details. What is the Pre-Cart Webhook? The pre-cart webhook is an advanced feature (which may only be available on certain Foxy plans) that allows you to intercept the anonymous@undisclosed.example.com (Anonymous) Thu, 31 Oct 2024 19:32:37 +0000 https://wiki.foxycart.com/v/2.0/pre_payment_webhook?rev=1773336442&do=diff Pre-Payment Webhook The pre-payment hook functionality sends a request to an endpoint of your choosing right before Foxy would otherwise submit the payment to the payment gateway, and allows for stores to apply custom validations for transactions prior to the request being set to the chosen payment method. A payload containing information about the current transaction is sent to the endpoint configured for this functionality, allowing the endpoint to respond to either approve or reject the tran… anonymous@undisclosed.example.com (Anonymous) Thu, 12 Mar 2026 17:27:22 +0000 https://wiki.foxycart.com/v/2.0/products?rev=1712068212&do=diff Products and FoxyCart: What They Are and What They Aren't Where Are Your Products? If you haven't already read “FoxyCart is different” a dozen times by now, we'll state it again: FoxyCart is different, and we recommend reading more about what FoxyCart is and isn't. Most e-commerce systems have a built in anonymous@undisclosed.example.com (Anonymous) Tue, 02 Apr 2024 14:30:12 +0000 https://wiki.foxycart.com/v/2.0/receipt?rev=1758313808&do=diff The Receipt... ...And All the Wonderful Things You Can Do With It The FoxyCart receipt is much like the checkout in terms of how it can be customized, but obviously the function of the receipt is to display the information about the successful transaction that just took place on the checkout. While it might sound rather dull, the receipt is actually quite an exciting place to be, for a few reasons: anonymous@undisclosed.example.com (Anonymous) Fri, 19 Sep 2025 20:30:08 +0000 https://wiki.foxycart.com/v/2.0/reporting?rev=1656091893&do=diff Reporting NOTE: The reporting functionality described on this page is for new reporting functionality, not for the reporting currently available in the Foxy admin. All timestamps in generated reports are for the store's configured timezone. All Reports Generated anonymous@undisclosed.example.com (Anonymous) Fri, 24 Jun 2022 17:31:33 +0000 https://wiki.foxycart.com/v/2.0/security_and_privacy_considerations?rev=1579826004&do=diff Security & Privacy Considerations for FoxyCart Stores With any complex system there are things that might not be immediately obvious but are nonetheless important to understand and consider to ensure you're making the best decisions for your project. This is especially true with ecommerce, which collects sensitive information. None of the information on this page is intended to scare you; rather, it's to help you make good decisions based on your unique needs. anonymous@undisclosed.example.com (Anonymous) Fri, 24 Jan 2020 00:33:24 +0000 https://wiki.foxycart.com/v/2.0/session_variables?rev=1533225493&do=diff The Myriad Uses of Session Variables What Session Variables Are “Session Variables” allow you to store information (as name/value pairs) in a user's cart, independently of any products in the cart. Unlike a product, which is visible in the cart and added by the customer, session variables aren't necessarily visible to the visitor, nor would the visitor know that a session variable has been set. You can think of session variables as a way to attach extra information to the anonymous@undisclosed.example.com (Anonymous) Thu, 02 Aug 2018 15:58:13 +0000 https://wiki.foxycart.com/v/2.0/shipping?rev=1689170718&do=diff Shipping A Shipping Haiku ... Prior to launching FoxyCart we had months of discussions about shipping. One of the scenarios that we discussed was a mattress store. The mattress store may need to ship very large and heavy items, but also may need to ship pillows. They may also need to ship things via custom shipping carriers or freight options. In our early discussions, the afore-attributed anonymous lead developer said something like, anonymous@undisclosed.example.com (Anonymous) Wed, 12 Jul 2023 14:05:18 +0000 https://wiki.foxycart.com/v/2.0/sidebar?rev=1558566391&do=diff v2.0 Products * Getting Started * Subscriptions * Downloadables Business Rules * Products: In Depth * Product Categories * Shipping * Coupons and Discounts * Taxes * Fraud Prevention Templates * Template Overview * Customers & Guest Checkout * The Cart * The Checkout * The Receipt * Email Receipts Advanced Topics * Product/Template Cheat Sheet * foxycart.js * How we use JSON and JSONP * Storing Session Variables * HMAC Product Verification API & B… anonymous@undisclosed.example.com (Anonymous) Wed, 22 May 2019 23:06:31 +0000 https://wiki.foxycart.com/v/2.0/snippets?rev=1663584321&do=diff Advanced Code Snippets for v2.0 Looking for snippets for version 1.1 or older? You can find all the old snippets available on this page. If you're using version 2.0 and a snippet you require isn't yet available below, get in touch with us. Please note that advanced manipulation of the cart or checkout via javascript is anonymous@undisclosed.example.com (Anonymous) Mon, 19 Sep 2022 10:45:21 +0000 https://wiki.foxycart.com/v/2.0/sso?rev=1746631650&do=diff Single Sign-On (SSO) About Single Sign-On FoxyCart's SSO allows customers who are already logged into your website to proceed through to checkout without needing to re-enter their username and password. This allows for far greater integration options, and can provide for a significantly improved checkout flow if you have customers who may already be logged into an external system. In order to prevent possible security issues, SSO checkouts still require the customer to enter the anonymous@undisclosed.example.com (Anonymous) Wed, 07 May 2025 15:27:30 +0000 https://wiki.foxycart.com/v/2.0/start?rev=1748561187&do=diff FoxyCart v2.0 Documentation Welcome to the documentation for FoxyCart v2.0. If you're on a different version you can find it from the documentation homepage. If you're looking to upgrade from an earlier version please view the upgrade notes or visit the changelog to see what's changed since the previous version. anonymous@undisclosed.example.com (Anonymous) Thu, 29 May 2025 23:26:27 +0000 https://wiki.foxycart.com/v/2.0/store_secret?rev=1739375463&do=diff The Store Secret Key Some Foxy functionality relies on a secret key to help secure information it contains. This includes the legacy XML datafeed, the legacy API, link/form validation and our Single Sign-On functionality. When creating a store, a random 60 character secret key is assigned to the store, and this value is used for each different feature mentioned above. This can be customised from the Foxy administration. anonymous@undisclosed.example.com (Anonymous) Wed, 12 Feb 2025 15:51:03 +0000 https://wiki.foxycart.com/v/2.0/subscription_xml_datafeed?rev=1493190150&do=diff The Subscription XML Datafeed The subscription datafeed does not send you a list of your subscriptions. Please see the import notes below as to what is contained in the subscription datafeed. If you want to be notified every time a subscription runs, please use the regular anonymous@undisclosed.example.com (Anonymous) Wed, 26 Apr 2017 07:02:30 +0000 https://wiki.foxycart.com/v/2.0/taxes?rev=1712941432&do=diff Taxes. And Death. And More Taxes. How Taxes Work in FoxyCart A “tax” in FoxyCart is a standalone set of properties that define a particular tax that can be applied to your product categories. Your store can have zero tax rates or 100, and they can be applied individually or in parallel, but the best way to understand how taxes work in FoxyCart is to dive into the admin to look at the available options. anonymous@undisclosed.example.com (Anonymous) Fri, 12 Apr 2024 17:03:52 +0000 https://wiki.foxycart.com/v/2.0/template_sets?rev=1568250689&do=diff Template Sets FoxyCart's template sets introduces the ability to group different settings together into a container which you can switch between based on the requirements for your store. Initially this is restricted to just the language and locale for your store - but we'll be expanding on it moving forward to incorporate more aspects of a FoxyCart store. anonymous@undisclosed.example.com (Anonymous) Thu, 12 Sep 2019 01:11:29 +0000 https://wiki.foxycart.com/v/2.0/templates_backup?rev=1493190150&do=diff Templates, Caching, and Template Customization with HTML + CSS Quick and Easy Customizations Get Your Logo In There! You can set your store logo in the Settings tab of your FoxyCart Store's Admin. There, you can add the url for your store's logo to the anonymous@undisclosed.example.com (Anonymous) Wed, 26 Apr 2017 07:02:30 +0000 https://wiki.foxycart.com/v/2.0/templates?rev=1748987092&do=diff Templates, Caching, and Template Customization with HTML + CSS FoxyCart's templates are beautiful and responsive out of the box with the new default templates available in 2.0. Paired with the new template configuration, you can even customise the templates without having to touch a single line of code. anonymous@undisclosed.example.com (Anonymous) Tue, 03 Jun 2025 21:44:52 +0000 https://wiki.foxycart.com/v/2.0/transaction_xml_datafeed?rev=1725877463&do=diff Transaction XML Datafeeds: Instant Transaction Notification Transaction XML Datafeed NOTE: The Transaction XML Datafeed is deprecated Though this legacy datafeed works and will continue to function in the future, it will not see any new functionality. We recommend any new integrations requiring a feed of transactions use FoxyCart's JSON Webhook: anonymous@undisclosed.example.com (Anonymous) Mon, 09 Sep 2024 10:24:23 +0000 https://wiki.foxycart.com/v/2.0/unified_order_entry?rev=1493190150&do=diff The "Super Password": Unified Order Entry What UOE Is “Unified Order Entry” (UOE, aka The Super-Password, aka The Glorified Virtual Terminal) is a method by which a store admin can enter and complete orders on behalf of customers, using the same FoxyCart checkout flow as the customers themselves would use. It provides a way to unify your order channels through FoxyCart, allowing you to maintain any 3rd party integrations you may have set up through FoxyCart while giving you a single place wher… anonymous@undisclosed.example.com (Anonymous) Wed, 26 Apr 2017 07:02:30 +0000 https://wiki.foxycart.com/v/2.0/upgrading?rev=1493190150&do=diff Changelog and Upgrade Notes for v2.0 Note: This page is geared towards upgrading from v1.1. Please make sure you view all the version notes for versions you may be skipping (ie. from 1.0 -> 1.1 -> 2.0). Changelog Summary FoxyCart v2.0 has some big, big changes from previous versions, but some things remain almost entirely unchanged. First, what's changed: anonymous@undisclosed.example.com (Anonymous) Wed, 26 Apr 2017 07:02:30 +0000 https://wiki.foxycart.com/v/2.0/using_foxy_without_the_cart?rev=1518506100&do=diff Using Foxy Without the Cart Skill Level: Advanced. There are a few situations where FoxyCart's “cart” functionality isn't needed. Though an uncommon situation, some examples include: * Integrations where a persistent cart already exists, and where Foxy is replacing just the checkout flow (to offload PCI compliance burdens, most frequently). anonymous@undisclosed.example.com (Anonymous) Tue, 13 Feb 2018 07:15:00 +0000 https://wiki.foxycart.com/v/2.0/webhooks?rev=1776163173&do=diff Webhooks Overview Foxy's Webhook functionality allows you to create integrations which subscribe to notifications of events from your Foxy store, such as new transactions, renewals or changes to subscriptions, or changes to customers. When one of these events occurs, we send a anonymous@undisclosed.example.com (Anonymous) Tue, 14 Apr 2026 10:39:33 +0000 https://wiki.foxycart.com/v/2.0/zapier_webspears?rev=1493190150&do=diff Zapier integration What Is Zapier? Zapier lets you easily connect the web apps you use, making it easy to automate tedious tasks. You can wait for third-party app developers to offer the SaaS integrations you need. You can hire expensive freelance programmers to build custom software for you. anonymous@undisclosed.example.com (Anonymous) Wed, 26 Apr 2017 07:02:30 +0000