FoxyCart Setup

Learn how to connect FoxyCart's shopping cart platform to BlueSnap's payment gateway technology.

FoxyCart provides a robust, e-commerce platform that can adapt to just about any business model. By connecting FoxyCart and BlueSnap, you can process global card payments, as well as derive key insights using BlueSnap’s reporting capabilities.


FoxyCart and BlueSnap accounts

You must have accounts at both FoxyCart and BlueSnap to proceed.

If you need a FoxyCart account, go to the FoxyCart site to sign up.
If you need a BlueSnap account, go to the BlueSnap website to get started.

PCI compliance

A PCI compliance of SAQ-A is required.

Before you get started:

Contact an Implementation Specialist to get your account ready. BlueSnap will provide you with gateway credentials that you will use in Step 2.

Step 1: Configure your BlueSnap account settings

Please complete these steps in your BlueSnap Console.

  1. First, you'll set up your statement descriptor, which is the description that will appear on the shopper's credit card/bank statement for each transaction to help them identify the purchase.

    Go to Settings > General Settings. In the Branding Settings section, enter a Default Statement (Soft) Descriptor and Support Phone Number (both will appear on the shopper's credit card/bank statement). When you're done, click Submit.

  2. To get paid, you will need to configure your payout settings by going to Settings > Payout Method. Click here for more information.

Step 2: Configure your FoxyCart account settings

Please complete these steps in your FoxyCart account. Note that you'll need your gateway credentials from BlueSnap at this time.

  1. Go to Store > payment at the top of the page.
  1. Please configure the following settings:
    • From the bank card payment method dropdown, select NMI.
    • In the account username field, enter your gateway username that BlueSnap provided.
    • In the transaction key field, enter your gateway password that BlueSnap provided.

      When you're done, save your configuration settings.

Best practices & tips

Currency conversions

Depending on your FoxyCart configuration, you might be charging the shopper in their preferred currency or in your store’s base currency.

If the former situation is true, be aware there may be a discrepancy between the rates you use to display prices on your website and the rates BlueSnap uses for payout. For payout reconciliation, use BlueSnap’s payout reports.

If the latter situation is true, we recommend including a note on your checkout page that informs shoppers of potential price variations. For example: “The price listed is approximate and may vary slightly”.


Use BlueSnap's reporting capabilities to gain a comprehensive understanding of your business through the detailed transaction and payout reports, through payment conversions reports, and much more. Reports can be viewed right in your BlueSnap Console or pulled via the Reporting API to be parsed or pushed to your third-party reporting tools.