What is Bluesnap?

BlueSnap provides an All-in-one Payment Platform designed to accelerate commerce for B2B and B2C businesses. BlueSnap integration allows you to accept Credit Card payments from all around the world.

For more information visit: https://bluesnap.com/

How does it work?

💳 In-page implementation
Our Bluesnap CC integration allows you to load the credit card fields inside the checkout page for a frictionless experience.

The Credit Card fields are loaded directly from Bluesnap’s servers ensuring a secure connection between Bluesnap and the Customer. ( Checkout X doesn’t handle any card details )

🔒 3DS Secure

The Bluesnap CC integration is compatible with 3DS secure payments, which means that all payments are compliant with European Directives.

When enabled, the 3DS Secure screen is shown only when requested by the bank of the customer and it doesn’t bring any extra payment fees.

👆 One-click upsells

When using Bluesnap, you can offer one-click post-purchase upsells. To learn more about them, visit this guide 👈

How to connect your BlueSnap account?

1 - Locate your API username inside your BlueSnap account

To connect your Bluesnap account, we’ll need your API Username and Password.
To find your API keys:

  1. Log in your BlueSnap dashboard

  2. Click on Settings in the top right corner

  3. Click on API Settings

⚠️ Important: Your API Password is not visible. If you don’t remember it, please contact Bluesnap support to help you reset it.

2 - Add a new Payment Method on Checkout X

Next, you need to Add a Payment method in Checkout X:

  1. Go to Configuration > Payment Methods

  2. Click on Add a Payment Method

  3. Select Bluesnap

3 - Add your API Keys

We also need you to add your Bluesnap API Username/Pass inside the Checkout X App:

  1. Copy your API Username from Bluesnap and paste it in Checkout X

  2. Enter your Bluesnap API Password ( Contact Bluesnap support if you can’t remember what it is )

  3. Scroll down and Save Payment Method

4 - Add Authorised IPs in Bluesnap

Last but not least, you need to add Checkout X’s Authorised IPs inside Bluesnap:

  1. Write down the following IPs: 54.72.12.1:2 and 54.72.77.249:250

  2. In Bluesnap’s API settings, scroll down to the section Authorized IPs

  3. Fill the first IP and click Add

  4. Fill the second IP and click Add


Additional options

While adding the payment method on Checkout X, you’re also able to configure a couple of additional options.

Enable test mode

Test mode will not allow you to process any real credit card transactions - only test cards will be available. This feature is meant to be used only if you are using a Bluesnap test ( sandbox ) account.

If you want to use a test BlueSnap account, just check the Enable test mode checkbox and click Save Payment Method

In any other case - leave the Enable test mode unchecked.

3DSecure support

If you have customers in the European Union, you need to enable 3DSecure payments to comply with PSD2.

To do so, just check the Enable 3DSecure checkbox and click Save Payment Method

⚠️ Important: Before you enable 3DS on your Checkout X account, contact your Bluesnap account manager to make sure 3DS is enabled on your Bluesnap account.

Credit Card Logos

The credit card logos option allows you to display which CC brands are accepted on your checkout.

👍 Your checkout with Credit Card logos selected

👎 Your checkout without Credit Card logos selected

We recommend that you select the logos that your customers might be using, to avoid unnecessary confusion.

⚠️ Important: This setting is purely for cosmetic purposes. To control which credit card brands are accepted, visit your Bluesnap account.

Custom transaction description

An example of a Credit Card transaction in Revolut,
with “Mantastyle Shop” being the transaction description.

Each Credit Card transaction has a “Description” field which the customer can see when they open their internet banking account. This description is set by Bluesnap, but you can override it by adding a Custom transaction description.

The custom transaction description has a maximum limit of 20 symbols.

❓ FAQ ❓

🙋‍♀️ Do I need to have a Bluesnap account?

Yes, you need to create your Bluesnap account on your own -> you can do it from Bluesnap.com

🙋‍♀️ Do I need to have a company?

Yes, BlueSnap doesn’t accept account applications made by individuals without a registered company.

🙋‍♀️ In which countries is BlueSnap available?

Find the full list of available countries here.

🙋‍♀️ My BlueSnap account got suspended. What to do?

Contact BlueSnap and resolve the situation with them. We can’t help in any way. 🙁

🙋‍♀️ Do I need to pay additional fees to Checkout X?

Checkout X transaction fees are charged separately from your BlueSnap fees. For more information visit our guide on billing here 👈


Did this answer your question?