FoxyCart eCommerce - Setting up FoxyCart

  • Create your Free FoxyCart Account

    Create your Free FoxyCart Account
    The first step to getting setup on FoxyCart is to create your Free FoxyCart Account.

    FoxyCart is a full service cart and checkout system that integrates with dozens of different payment providers. This allows Jamroom to work with payment gateways all over the world using the same code base.

    It doesn't cost anything to get setup and integrated with FoxyCart:


    Its free to create an account and will remain free for as long as you are in testing mode. When you decide its time to take your site live, then payment for the service begins (via a FoxyCart subscription).
  • Create your FoxyCart Store

    After you have created your account and logged in, the next step is to configure your FoxyCart account so it will work correctly with Jamroom.

    There are several questions on the signup screen to help you get setup, but instead of outlining those details which are only accessible once, just skip through them using the default answers.

    Once you've moved through the "welcome" questions, you'll be viewing the FoxyCart Admin interface where you will configure your account as outlined below.
  • FoxyCart Admin "Settings" Section

    FoxyCart Admin "Settings" Section
    The first place you want to configure is the "Settings" section. Click on "Settings" under the STORE section in your FoxyCart admin - it should be at this URL:

    https://admin.foxycart.com/admin.php?ThisAction=EditStore

    Set the following settings (make sure and use YOUR Jamroom site URL!). For settings that are NOT listed here, leave them set to their default value:

    Store Name: - Set this to the name of your site

    Store URL - this should be the URL to your Jamroom site (no trailing slash) - i.e. "https://www.jamroom.net"

    Receipt Continue URL - this should be the URL to the "return" view in your FoxyCart module - i.e. "https://www.jamroom.net/foxycart/return"

    Logo URL - this is a URL to the LOGO you want to use on the checkout page - you can set this to any URL you want - we use the logo for the skin - i.e. "https://www.jamroom.net/skins/ActiveSkin/img/logo.png"

    Store Sub Domain - enter whatever sub domain you would like to use here (you can use whatever you want as long as FoxyCart allows you to save it)

    Store Version - it is recommended to set this to "2.0" for new stores

    From Email - set this to the same email address you have set in your Jamroom Email Support "From Email Address" Global Config.

    The rest of the settings on this page can be setup if you want (Shipping Location and Locale, Currency and Timezone) - Jamroom however does not use them.
  • FoxyCart Admin "Advanced" Section

    FoxyCart Admin "Advanced" Section
    Next, click on the "Advanced" link under the STORE menu - it should be at this URL:

    https://admin.foxycart.com/admin.php?ThisAction=EditAdvancedFeatures

    Set the following options - again, make sure you are using the URL yto your Jamroom site (the URLs shown here are examples so you can compare your settings to ours):

    Would you like to Enable your Store Datafeed? - this should be checked

    Datafeed URL - This should be the URL to the "webhook" FoxyCare module view on your Jamroom site - i.e. "https://www.jamroom.net/foxycart/webhook"

    Wold you like to enabled Cart Validation? - checked

    Use CSRF checking on the Checkout? - checked

    Enable Single Sign On - checked

    Single Sign On URL - this is the URL to the "sso" FoxyCart module view on your Jamroom site - i.e. "https://www.jamroom.net/foxycart/sso"

    Customer Password hash Type: - set this to "phpass, portable mode"

    Customer Password hash Config: set to "12"

    Again - any other setting just leave set to the default, and save your changes.
  • FoxyCart Admin "Payments" Section

    FoxyCart Admin "Payments" Section
    Next, click on the "Payments" section under the STORE menu. This is where you decide what Payment Processor you want to receive money under (i.e. PayPal, Stripe, etc.).

    You must already have an account with your Payment Processor in order to configure this section! If you don't have a PayPal account, a Stripe account, etc. now is the time to get a new account setup with one of the supported "Payment Gateways":

    https://wiki.foxycart.com/gateways/start

    You information you need to enter here is going to change depending on which gateway you are using, so make sure and set it up correctly.

    If you have questions in this area you'll want to contact FoxyCart support for their assistance in setting this up. For the most part however it should be pretty straight forward to get this configured.

    Make sure and save your changes.
  • Configure your Jamroom FoxyCart module

    Configure your Jamroom FoxyCart module
    Next we're going to come back to YOUR Jamroom site, so open a new tab in your browser and get logged in to your Jamroom site as the master admin.

    Click on "ACP" to enter the Admin Control Panel. Click on the "Ecommerce" section in the module menu, and select the "FoxyCart eCommerce" module. Once clicked you will be viewing the Global Config for the module.

    Make sure and configure the following settings:

    API Key - your unique API Key is found in the FoxyCart admin in the "Advanced" section under the STORE menu. Go to your FoxyCart tab and copy and paste it into this setting.

    Store Sub Domain URL - this is the URL to your uique FoxyCart checkout page. Go back to the FoxyCart admin and click on the "Settings" section in the STORE menu. You will see the value you entered for "Store Sub Domain" - that needs to be entered here. For example, ours is:

    https://the-jamroom-network.foxycart.com

    Yours will be different, but enter the ENTIRE URL here.

    Store Version - set this to "2.0" unless you know for sure you must use version 1.1 of the API.

    Store Sub Domain - enter JUST the sub domain part here - i.e. for Jamroom.net our sub domain is just "the-jamroom-network".

    You can configure the other options here to suit your needs, or just ignore them for now and save your settings.

    You're all set now - your FoxyCart module is all setup. You can now configure the FoxyCart module as you would other modules (i.e. setup your Quotas, etc.)
  • Other FoxyCart admin pages

    When logged in to FoxyCart you probably noticed there are quite a number of other pages that can be configured and tweaked - feel free to check those out when you get a chance - most of them are related to "customizing" the check out experience for your users, with some areas being quite advanced.

    What we've outlined here are just the settings that Jamroom will use - you're free to customize your account more if you would like. If you have questions on what these extra settings are and how they are used, we recommend checking out the FoxyCart documentation:

    https://wiki.foxycart.com/

    or contacting FoxyCart for help.

Tags