Wise Public Widgets for Partners

Marija Krasnopjorova

The Wise public widgets provide an easy way to embed rich, interactive content onto your website. All the Wise widgets feature powerful configuration options to enable you to tailor their functionality to suit your audience. By including your personal affiliate link in the code, it’s also possible to use the widgets to generate commission from visitors to your website.

In this post, we will show two available widgets and instructions for their implementation on your site:

  • Calculator: A currency exchange calculator with route selection, real-time exchange rate, and a transfer quote. Instructions below.
  • Comparison: A money transfer comparison table, with or without selectors for the route and amount. Instructions below.

The default calculator looks like this:

The default comparison table looks like this:

Adding the calculator widget to your site

1. Add the HTML tag

Place the following code onto your page where you want the calculator widget to appear:

2. Add the calculator script tag

Add the following JavaScript code to your page immediately before the closing tag:

3. Configure the script tag

Note the variables at the start of the script tag above. These can be changed to suit your requirements, according to the table below. Examples of various setups are shown later in this guide.

VariableDescriptionExample
sourceCurrencyCodeSet the source currency"EUR", "GBP", "USD", "INR", etc
targetCurrencyCodeSet the target currency"EUR", "GBP", "USD", "INR", etc
sourceAmountSet the initial value of money to be converted1000
callToActionLabelSet the value of the CTA button"Get started"
hideCtaSet to true to hide the call to action buttontrue or false
hideDetailsSet to true to hide the rate, savings, etctrue or false
affiliateLinkYour affiliate link"https://wise.prf.hn/click/camref:11001XXXX"
langSets the language of the text in the calculator"en", "pt", "es", "fr", "de", "ru"
widthSets the width of the calculator widget"580px"
heightSets the height of the calculator widget"470px"

Note the default width and height settings (580px wide x 470px high) assume you have details set to true. If details is set to false, the height of the widget container can be reduced accordingly (580px wide x 240px high).

Examples

USD to MXN in Spanish with custom CTA button and hidden details:

GBP to INR in English with custom CTA button and full quote breakdown:

Adding the comparison widget to your site

1. Add and configure the HTML tag

Place the following code onto your page where you want the comparison widget to appear. Note that the link will be replaced when the table loads.

The HTML above must be configured depending on which version of the widget you’d like to use. The class attribute on the first line should be set to one of the following two options:

  • Comparison complete widget: For a full comparison table with selectors for route and amount, set the class to tw-comparison (note this is the default in the code above).
  • Comparison table only: For a static comparison table that is fixed to a particular route and amount, set the class to tw-comparison-table.

Next, set the source currency, target currency, and amount by editing the href attribute. For example, to compare prices for sending 850 GBP to USD in a static comparison table, you’d configure the HTML as follows:

2. Set any optional parameters

You can configure the table to behave differently using the following optional parameters. They are set as data attributes on the element.

  • data-lang: string ISO 639-1. Sets the language of the comparison table. Default is en.
  • data-source-country: string ISO 3166-1 alpha-3. Filters results by source country. i.e the origin country from where a user may want to send money from.
  • data-provider-country: string ISO 3166-1 alpha-2. Filters by provider country. i.e the country which the provider belongs to (e.g Natwest - GB, ANZ - AU). This property is also useful for only showing national banks, rather than “global” providers (like Western Union, Moneygram, etc).
  • data-max-visible-providers: number by default shows 3 providers and the rest are hidden under ‘Show more providers’ link.
  • data-expand-disclaimer: boolean. Setting to true will render the table with the disclaimer already opened and scrolls the element into the visible area of the browser window.
  • data-affiliate-link: string Your affiliate tracking link. This will determine where users are sent when the click the Send Money CTA.

Examples of possible configurations are provided at the end of this guide.

3. Add the comparison table script tag

Add the following JavaScript code to your page immediately before the closing tag:

Examples

To render a full comparison table in Spanish, showing quotes for sending 850 GBP to USD, limiting the quotes to 4 specific providers, and using your own personal affiliate link in the CTA, you’d use the following HTML:

To render a static comparison table in English, showing quotes for sending 1500 GBP to USD, you’d configure the HTML as follows:

Known limitations

  • It’s currently only possible to render a single comparison widget per page
  • It’s not possible to carry over the selected currencies onto the calculator on the Wise homepage when the readers clicks through to wise.com from the widget

*Please see terms of use and product availability for your region or visit Wise fees and pricing for the most up to date pricing and fee information.

This publication is provided for general information purposes and does not constitute legal, tax or other professional advice from Wise Payments Limited or its subsidiaries and its affiliates, and it is not intended as a substitute for obtaining advice from a financial advisor or any other professional.

We make no representations, warranties or guarantees, whether expressed or implied, that the content in the publication is accurate, complete or up to date.

Money without borders

Find out more

Tips, news and updates for your location