Give’s Currency Switcher Add-on provides you with limitless flexibility to empower your donors to donate in the currency of their choice. Features like Geolocation detection, API-driven exchange rates and individualized gateway support make this a very powerful Add-on for all your currency needs.

Downloading and Activating Your Currency Switcher Add-on

In order to get started you’ll want to download, install, and activate your Currency Switcher Add-on. You’ll also want to activate your Add-on license so you have access to our Support and you get automatic update notices.

Learn How to Install & Activate Give Add-ons »

Overview of Currency Switcher

Currency Switcher provides you with both global options and per form override options. This enables you to set your most common currency options globally, while giving you the flexibility to customize one specific form for unique purposes.

There are four main features of Currency Switcher to be familiar with:

  • General settings — this is where Multiple Currency Support is configured.
  • Geolocation — setting the form’s primary currency based on your donor’s location.
  • Gateway Support — enabling/disabling currency switching per gateway.
  • Exchange Rate APIs — setting your exchange rates dynamically according to public APIs

General Settings

This screen allows you to enable Currency Switcher globally, and configure what currencies you will support. Here’s an overview of the General settings:

Currency Switcher

Settings Type: Radio buttons
Options:
 Enabled | Disabled
Default: Disabled

Enable this to enable Currency Switcher globally.

Currency Switcher Message

Settings Type: Text field
Default: The current exchange rate is 1.00 {base_currency} equals {new_currency_rate} {new_currency}.

This is the message that will dynamically appear below the amount field when your alternate currencies are chosen. The phrases in brackets ( i.e. {} ) are dynamic information and must be used exactly as-is.

Supported Currencies

Settings Type: Multi-check list
Options:
 All Give-supported currencies. See our full list here.
Default: Your site’s global currency setting found in “Donations > Settings > General > Currency”

Check as many currencies as you’d like to support for your donors.

Exchange Rates

Settings Type: Table matrix of settings
Columns:
 Currency, Exchange Rate, Set Manually, Rate Markup

As you select currencies in the “Supported Currencies” section, they will populate in this table for you to configure them individually. Here are the configuration options:

  • Currency — the currency you are configuring
  • Exchange Rate — this field is locked by default. You can either set this rate manually by checking the checkbox in the “Set Manually” column, or click the button below the table that says “Fetch Exchange Rates”. That button is only available if you have configured your Exchange Rate API in the “Exchange Rate APIs” section.
  • Set Manually — select this to set your own exchange rate for any given currency.
  • Rate Markup — you can add an additional flat amount to your exchange rates here.

Geolocation

This setting allows you to set the default currency of your form dynamically according to the donor’s location. Here are the settings:

Geolocation

Settings Type: Radio buttons
Options:
 Enabled | Disabled
Default: Disabled

Enable this to enable the Geolocation feature globally.

Base Currency (if fails)

Settings Type: Select field
Options:
 Dynamic based on the currencies you enabled in the “Supported Currencies” section

If your site is unable to determine the location of a donor, this will be the default currency the donor is shown.

Payment Gateways

You can enable or disable any currency based on each payment gateway that you have enabled.

Payment Gateways

Settings Type: Multi-select search field
Options:
 Dynamically populated based on your settings in “Donations > Settings > General > Payment Gateways”

Next to each gateway listed in the table, click into the text field to search for any of your supported currencies. Click the “x” next to any currency already populated in the text field to remove it.

Remove or enable currencies per gateway.

Exchange Rates API

You can dynamically set your exchange rates based on public APIs. Here’s the settings for that:

Exchange Rates Provider

Settings Type: Select field
Options:
 “Please select”, Google Finance, Fixer.io, Open Exchange Rates
Default: “Please select”

You can choose from these three available public exchange rate APIs:

Automatic Update

Settings Type: Radio buttons
Options:
 Enabled | Disabled
Default: Enabled

This determines whether your website will reach out to the public API on a regular basis or not to update your rate.

Update Interval

Settings Type: Select field
Options:
 Once hourly, Twice Daily, Once Daily, Once Weekly
Default: Once Daily

This determines how often your site will reach out to the public exchange rate API of your choice.