Stop typing, start uploading — your shortcut for adding new recipients
Paying someone new? Don’t waste time typing out their bank details or double-checking their IBAN. Upload a screenshot or invoice instead. Our new AI feature...
Wise Public Widgets for Partners
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.
| Variable | Description | Example |
|---|---|---|
| sourceCurrencyCode | Set the source currency | "EUR", "GBP", "USD", "INR", etc |
| targetCurrencyCode | Set the target currency | "EUR", "GBP", "USD", "INR", etc |
| sourceAmount | Set the initial value of money to be converted | 1000 |
| callToActionLabel | Set the value of the CTA button | "Get started" |
| hideCta | Set to true to hide the call to action button | true or false |
| hideDetails | Set to true to hide the rate, savings, etc | true or false |
| affiliateLink | Your affiliate link | "https://wise.prf.hn/click/camref:11001XXXX" |
| lang | Sets the language of the text in the calculator | "en", "pt", "es", "fr", "de", "ru" |
| width | Sets the width of the calculator widget | "580px" |
| height | Sets 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
Wise Partner Program – Your Onboarding Guide
Welcome to the Wise Partner Program! In this guide, you will find all the information you need to get started, optimize and succeed as a Wise partner. Simply...
Spend Less Time Typing: The Faster Way to Pay Invoices with Wise
We're thrilled to introduce a powerful new feature designed to save you time and eliminate the frustration of manual data entry when sending money. Now,...
Meet the new Wise card in Brazil
The new Wise Card is here! 🇧🇷
Your Wise account now with all the convenience of Pix
We have great news for our customers in Brazil! You can now set up your own Pix key directly in the Wise app
Your Wise Card Transactions: Understanding Invalid Disputes
From time to time, you might make a purchase with your Wise card and run into an issue — maybe something you bought didn’t arrive, wasn’t as described, or you...
