How to get your BlueSnap API credentials

You must have a BlueSnap account to get API credentials. If you don't have an account yet, it's easy to sign up for one here.


API credentials in the HTTP Basic Authentication header

You include your BlueSnap API user key and password in the Basic Authentication header when you make calls to our API. For more information, refer to Authentication & Headers.

Follow these steps to get your API credentials.

  1. In the top menu of the Merchant Portal, go to Settings > API Settings.
  2. Define your API password by entering it in the Password and Verify your password fields.
    Remember your API password; you will need it later.

    Password rules

  • Minimum 12 characters
  • Maximum 128 characters
  • ASCII characters only: a–z A–Z 0–9 _ ~ ! @ # & $ % ^ * ( ) | ' -
  • Must include 1 uppercase letter
  • Must include 1 lowercase letter
  • Must include 1 digit
  • Cannot be the same as the user key
  • Cannot be formatted like an email address
  1. Complete the Authorized IPs section. You can add up to 15 IP addresses or a subnet.
  • To enter a single IP address, enter the first IP and then click Add for additional addresses.
  • To enter a range of IP addresses, enter the first IP address in the first four boxes and then add the last digits of the range in the fifth box.
  1. (Optional) If you want IP Checking performed, leave the Disable IP Checking option clear and then. If you do not want IP Checking performed, select the Disable IP Checking option.


  • Do not Disable IP Checking unless absolutely necessary because it provides security to your account.
  • Regardless of the setting of the Disable IP Checking option, if you add any IP addresses, you can not remove all of them. After you add an IP address, you must always have at least one.
  1. Click Request API credentials. The credentials are generated and your new API User Key is shown.