Pricing and currency

BlueSnap offers flexible price and currency options, enabling you to set your base currency, define prices in multiple currencies, dynamically override the price, and more.

We support multiple currencies. By default, USD is used as the base currency for your account and contract prices are set in USD. Other currencies are dynamically converted and quoted from the base currency.

Learn more:

Setting the price in the contract
Setting fixed prices in multiple currencies
Setting the base currency
Defining which currency appears on the checkout page
Overriding the price
Taxes in checkout pages
FAQs

Setting the price in the contract

For each checkout page, the price is defined in the Price field in the contract settings. To get to the contract settings, go to Product Catalog > Products in the left menu, expand the relevant product, and then click on the name of the a contract.

The price you set here is in USD, regardless of what base currency you are using.

To learn how prices in other currencies are calculated and how to round up prices, see How is the price converted to other currencies?

Price change to a recurring contract impacts existing subscriptions

If you change a price of a recurring contract, the change is applied to all existing subscriptions under this contract, in addition to all new subscriptions.

Setting fixed prices in multiple currencies

To set a fixed price in a currency other than USD, follow these steps:

  1. Click the More Currencies link next to the Price field.

  2. Choose the currency you want in the Select currency to set price for menu, and enter the fixed price for that currency in the Price column.

  3. Click Submit.

  4. Select the checkbox in the Force Currency column for the currency you just added. This means that when the checkout page displays this currency then it shows the fixed price you just set for this currency.

  5. Click Submit.

Be aware of currency fluctuations if you use this option

If you set a fixed price, it remains in effect until you change it or clear the Force Currency checkbox. This means that if there is a fluctuation in the value of a currency you could potentially lose money because the price does not change with that fluctuation. Therefore, you should keep track of the fixed prices you set and the status of each currency.

Setting the base currency

By default, the base currency is USD. This means that when a shopper views the checkout page in a different currency, the price is converted based on USD.

To change the base currency for a contract, follow these steps:

  1. Click the More Currencies link next to the Price field.

  2. Choose the currency you want in the Select currency to set price for menu, and enter the fixed price for that currency in the Price column.

  3. Click Submit.

  4. Select the Base Currency option for the currency you just added.

  5. Click Submit.

Defining which currency appears on the checkout page

By default, the checkout page automatically appears in the currency used in the shopper's country, based on the shopper's IP address.

If you prefer, you can control which currency is displayed on the checkout page by adding the currency parameter to the checkout page URL. The value of the parameter should be the three-letter language code. For example, to show the page in Japanese Yen, you would add the following: &currency=JPY.

Example URL:
https://sandbox.bluesnap.com/buynow/checkout?sku2269035=1&storeid=17125&currency=JPY

For more information about using parameters, see Dynamic checkout customization with parameters and Hosted Checkout parameters.

Overriding the price

You can dynamically override the price using encrypted parameters that are sent to the checkout page. This is useful, for example, if you want to run a promotion and change the price that appears on the checkout page without setting up a coupon.

What is an encrypted parameter?

Without encryption, the actual parameter name and value appears in the URL. That makes it easy for anyone to see the parameter information, which can pose a security issue in some cases. Encryption, which involves transforming the parameter into a long string of assorted numbers and letters, allows the parameter to be passed securely.

For example, an unencrypted price parameter may look like this:
price=12.00
while an encrypted price parameter may look like this:
enc=dHCbO44MZJPA7V4%2FLQjyERh0Q5goZ7IcDe62FGmMAnJkblL5z%2F%2B7PJxAkVe3s50M43%2Bvk19re

To use the override price feature, you need to get BlueSnap API credentials and then configure the encrypted parameters. Follow these steps:

  1. Go to Settings > API Settings in the top menu of the BlueSnap Merchant Console.

  2. Define your API password by entering it in the Password and Verify your password fields.

  3. In the New IP Address field, enter the IP address to be used for API calls. You can add up to fifteen IP addresses or a subnet.

  4. Click Request API credentials. The credentials are generated and your new API username is displayed.

  5. Go to Checkout Page > Payment Methods in the left menu.

  6. In the Data Protection Key field, enter a password of at least 6 characters, and then click Submit.

  7. Go to Product Catalog > Products in the left menu.

  8. Expand the relevant product to view its contracts, and then click on the name of the contract where you want to override the price.

  9. In the Discounts area, in the Allow Override Price menu, select Yes, encrypted parameter.

  10. Click the Override Price Encryption Web Service Link.

  11. Enter these fields:

    • SKU: The SKU connected with the specific contract you are in
    • Price Amount: The price you want to show on the checkout page
    • Price Currency: The currency you want to show on the checkout page
    • Recurring Price Amount: The price you want to show on the checkout page if this contract uses recurring billing
    • Recurring Price Currency: The currency you want to show on the checkout page if this contract uses recurring billing
  12. When you finish, click Get Token.

  13. Add this token to your checkout page URL, as the value of the enc parameter. For example:
    https://sandbox.bluesnap.com/buynow/checkout?sku2268169=1&storeid=16883&enc=gIJ%2F2fyemHzwSQZEDFO6qi

Taxes in checkout pages

Coming Soon

To best support our merchants, we are partnering with Avalara to simplify the new complexities of calculating and charging tax. Until then, you can continue using our current method for supporting taxes.

FAQs

What is the difference between the base and force currencies?

The base currency is the currency that is used when calculating prices in all other currencies. By default, the base currency is USD, so when a shopper views the checkout page in a different currency, the price is converted based on USD.

Typically, you want to set the base currency to your domestic currency or accounting currency. So if you are in the United Kingdom, you may want to set the base currency to GBP. See Setting the base currency.

The force currency refers to a fixed price that you define in a currency other than the base currency. For example, if your base currency is USD but you also want to define a fixed price in EUR rather than letting the price be converted from USD, then you would set up EUR as a force currency. To do this, see Setting fixed prices in multiple currencies.

I set up Euros (or another currency) as my base currency, but I still see USD in the console. Why?

Regardless of what you set for base currency, the console still displays USD for most fields. Rest assured, the base currency you set still applies.

What if I don't want a single price for the checkout page? Is there a way to dynamically change the price?

Yes, you can dynamically change the price using encrypted parameters. See Overriding the price.

How is the price is converted to other currencies?

By default, prices in all other currencies are automatically calculated based on your account's base currency, using today's exchange rate. For example, if your base currency is USD and the price you set in USD is $20, then prices in any other currency is calculated based on the USD price and today's USD exchange rate.

If you prefer to set a fixed price in specific currencies, you can do this with the force currency setting. See Setting fixed prices in multiple currencies.

Rounding up prices in other currencies

The conversion of prices from the base currency to another currency can sometimes lead to an odd price such as $14.53. To prevent this, you can opt to round up the price using one of the methods available on the More Currencies page.

Pricing and currency


Suggested Edits are limited on API Reference Pages

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