Spreedly Setup

Use this guide to learn how to connect Spreedly and BlueSnap for global payment processing.


Spreedly lets you securely store credit cards and returns a universal credit card token that can be used for transactions with BlueSnap. This simplifies transactions by eliminating the need to store payment data and reduces customers' PCI scope by handling capture and storage of sensitive payment card data.

Supported Features

3D Secure
Auth/Capture and Separate Auth and Capture
Built-in Fraud Prevention and Risk Management
Chargeback Management
Level 2/3 Data compliant
Multiple Currencies and Multiple Languages
Partner Sandbox Testing
Payment Analytics and Reporting
Payment Methods: ACH/ECP, Credit/Debit Cards, and Splitit
Payment Optimization
Vaulted Shoppers


Spreedly and BlueSnap Accounts

You must have accounts at both Spreedly and BlueSnap.

 If you need a Spreedly account, go to the Spreedly website 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

No additional PCI requirement

Spreedly Setup

Step 1: Configure your BlueSnap account settings

Complete these steps in your Merchant Portal for production or sandbox.

  1. Get your BlueSnap API credentials and define the authorized IP addresses for your server. (You can find the IP addresses here.) 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 Spreedly settings

To configure BlueSnap as your payment gateway, you must run a gateway API request specifying blue_snap as the gateway_type and providing your BlueSnap API credentials. For specific details, refer to Spreedly's BlueSnap Gateway Guide.

Best Practices & Tips

3D Secure

If you would like to use 3D Secure, please refer to the following docs to learn how to get this feature set up.

Considering shopper impact of currency conversions

While transactions are placed in your store’s base currency, you might have your store configured to display product prices in multiple currencies. To account for any differences between the currency conversion rates used to display prices on your website and the rates used by the shopper’s issuing bank, 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 detailed transaction and payout reports, payment conversion reports, and much more. Reports can be viewed right in your Merchant Portal or pulled via the Reporting API to be parsed or pushed to your third-party reporting tools.