Foxy Setup

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

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

Supported features

Auth/Capture and Separate Auth and Capture
Built-in Fraud Prevention and Risk Management
Chargeback Management
Credit and Debit Card Processing
Multiple Currencies and Multiple Languages
Partner Sandbox Testing
Payment Analytics and Reporting
Payment Optimization
Vaulted Shoppers


Foxy and BlueSnap accounts

You must have accounts at both Foxy and BlueSnap to proceed.
 If you need a Foxy account, go to the Foxy site to sign up.
 If you need a BlueSnap account, go to the BlueSnap website to get started.

Supported currencies

BlueSnap supports the currencies listed here. We recommend configuring your store to only accept currencies supported by BlueSnap.

Supported countries

BlueSnap supports the countries listed here. If a shopper is located in one of these supported countries, they will be able to purchase with the BlueSnap payment module.

PCI compliance

A PCI compliance level of SAQ-A is required.

Before you begin

Contact an Implementation Specialist to get your account ready. BlueSnap provides you with the gateway credentials you use in Step 2.

Step 1: Configure your BlueSnap account settings

Complete these steps in your BlueSnap Console for production or sandbox.

  1. Get your BlueSnap API credentials and define the authorized IP addresses for your server. Both of these actions are performed on the same page; for instructions click here.

  2. Set up your statement descriptor. The statement descriptor is the description that appears on the shopper's credit card statement or bank statement for each transaction and helps the shopper identify the transaction.

  • Go to Settings > General Settings.
  • In the Branding Settings section, enter a Default Statement (Soft) Descriptor and Support Phone Number (both appear on the shopper's statement).
  • Click Submit.
  1. To get paid, you need to configure your payout settings. Refer to Payout for more information.

Step 2: Configure your Foxy account settings

Complete these steps in your Foxy account. You need your gateway credentials from BlueSnap.

  1. Go to Store > payment at the top of the page.

  2. Configure the following settings:

  • In the bank card payment method drop-down list, 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 Foxy 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.

Updated 5 months ago

Foxy Setup

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

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.