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


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.

Step 1: Configure your BlueSnap account settings

Please complete these steps in your BlueSnap Console for production or sandbox.

  1. Get your BlueSnap API username and password. For instructions, see API Credentials.

  2. Add the necessary IP addresses for the Spreedly production environment to be used for API calls. You can find the IP addresses here.

Example of the Authorized IPs screen

Example of the Authorized IPs screen

  1. In this step, you set up your statement descriptor, which is the description that appears 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 must configure your payout settings. See 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

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 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.

Spreedly Setup

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

Suggested Edits are limited on API Reference Pages

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