Search results for "{{ search.query }}"

No results found for "{{search.query}}". 
View All Results

Pricing, currency and tax

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 currently support 100 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 what currency appears on the checkout page
Overriding the price
Handling tax in your 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 will be 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 will show 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 will remain 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 will 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 will be 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 what currency appears on the checkout page

By default, the checkout page will automatically appear 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 BuyNow 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

How

To use the override price feature, you will 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 have finished, 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

Handling tax in your checkout pages

To charge tax or VAT on your shopper’s orders you will need to calculate the tax or VAT amount on your side, for example by integrating with a tax calculation provider. You can then pass the tax amount to the checkout page and include it in the amount charged to the shopper.

Step 1: Gathering required tax details and connecting with your tax calculation provider

In order to calculate the correct amount of tax or VAT, you will typically need to gather specific information from your shoppers and then pass that information to your tax calculation provider. The required information varies based on location, but usually includes the shopper’s country, state/region, and VAT ID or tax ID and amount.

You should work with your tax calculation provider to define which data is required and then make sure that you gather this data from the shopper on your site. You can then pass this information to your tax calculation provider to determine what tax or VAT % needs to be charged based on the country and whether or not they are tax or VAT exempt.

Once you have received the amount of tax/VAT from your tax provider to be charged to your shopper, you can then pass it to the checkout page as described in step 2.

Step 2: Passing the tax amount to your checkout form

After you have determined the amount of tax/VAT to charged, you can pass this information to the checkout page using one of the two solutions described below.

Note: When you send the shopper to the checkout page you may wish to prepopulate some of the fields, such as the country, with the information you already gathered from the shopper. This will reduce checkout friction, as the shopper will have to complete fewer fields in order to finish checking out. To pass information into the checkout page, you can use our BuyNow parameters. For details, see BuyNow parameters.

Solution 1: Add the tax to the total amount

With this solution, you will use the override price capability to send the new price, including tax, for display on the checkout page. For example, if the product price is $30 and you charge $5 tax, you can override the main contract price to set it to $35. If you are using this solution, you may also want to change the main contract’s name to indicate that it includes tax.

The benefit of this option is that the tax amount will carry forward on a subscription. For example, if our Subscription Manager is being used and the total price (product + tax) is $35, then the shopper will be charged $35 each period. The drawback of this option is that there is no separate reporting on tax.

This is an example of the order information on a checkout page where the price was overridden to include tax:

How
Use the override price capability to change the price on the checkout page to include the tax amount you have calculated. See Overriding the price.

Solution 2: Add a separate contract for the tax

With this solution, you will set up an additional contract for the tax, and then use URL parameters and the override price capability to add the tax contract to your checkout page and override its price with the relevant tax amount. For example, if the product price is $30 and you charge $5 tax, you can add a contract for the tax and override that tax contract’s price to set it to $5.

The benefit of this option is that the tax will be represented on all BlueSnap reports as a distinct amount from the main product. The drawback is that tax will not carry forward on any recurring charges when using our Subscription Manager.

This is an example of the order information on a checkout page where a separate contract was added for tax, and the tax amount was overridden to show the relevant value:

How

  1. Create a new product just for tax purposes, with a one-time contract under the product. You may want to name the product “Tax” and the contract “amount” so that it will appear as “Tax amount” on the checkout page.
  1. Add the tax contract to the main products checkout page by adding the tax contract’s ID number in the checkout page, using the sku{contractID}=1 parameter. For example, the following checkout page URL is for a contract with ID 2269665, and the tax contract with ID 2274747 is added to the end of the URL:
    https://sandbox.bluesnap.com/buynow/checkout?sku2269665=1&storeid=17125&sku2274747=1

  2. Use the override price capability to change the price of the tax contract to show the tax amount you have calculated. If the shopper is not taxable, you can always set the contract’s price to $0. See Overriding the price.

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 will be converted based on USD.

Typically, you will 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 will still display 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 will be 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, currency and tax