Exchange Rates Configuration
Bagisto Exchange Rates lets you automatically refresh currency exchange rates by using outside API services.
In the admin panel, you can quickly input API credentials, choose your favorite service provider, and arrange a timetable for automatic updates.
This makes sure your store’s currency rates are correct without needing to do it by hand.
To set up exchange rates, navigate to: Configuration > General > Exchange Rates, as illustrated in the image below.
Exchange Rates Configurations
Below are the detailed steps of the exchange rates configurations.
1) General Settings
In this part, you can pick the default exchange rate service that Bagisto will use.
You can choose between Exchange Rates API and Fixer API, based on what you like and what you need.
2) Fixer API
Here, you have to put in the API key you got from fixer.io.
Fixer gives you both real-time and past exchange rate information. It also has a free plan, but you can only make a limited number of API requests.
3) Exchange Rates API
In this section, you need to enter your API key from exchangerate-api.com. This service offers real-time exchange rates for over 160 currencies.
The free plan lets you make up to 1,500 requests each month, which is good for most small to medium-sized stores.
4) Scheduled Import
You can turn on scheduled updates to automatically refresh exchange rates at set times.
Once you turn it on, you can pick how often to update — daily, weekly (every Monday), or monthly (on the 1st day of the month).
You can easily add this from the settings as shown below.
You have to set the start time using the 24-hour format, like this: 03:00.
To ensure that scheduled updates function correctly, you need to have the Laravel task scheduler running.
You can start it by using this command:
php artisan schedule:work
Environment Variable Backup
If you forget to put API keys in the admin panel, Bagisto will automatically grab the API keys from your .env file.
For the Fixer API, you can use FIXER_API_KEY.
For the Exchange Rates API, you can use EXCHANGE_RATES_API_KEY.
Example .env configuration:
FIXER_API_KEY=your_fixer_api_key_here
EXCHANGE_RATES_API_KEY=your_exchange_rates_api_key_here
Manual Update
Besides automatic updates, you can also change exchange rates by hand.
To do this, go to the admin panel, then click on Settings > Exchange Rates and hit the Update Rates button.
Alternatively, you can use the command in the CLI: php artisan exchange-rate:update
Exchange Rates API (exchangerate-api.com):
Endpoint Example: v6.exchangerate-api.com/v6/{API_KEY}/latest/{BASE}
Fetches all currency rates in a single API call
Free tier: 1,500 requests/month
Sign up: https://www.exchangerate-api.com
Supported Services
Bagisto Exchange Rates API (exchangerate-api.com)
This tool gets all the currency exchange rates with just one API call. You can make 1,500 free requests every month.
Fixer API (fixer.io)
Endpoint: http://data.fixer.io/api/{date}
Fetches rates per currency pair
Free tier: 100 requests/month
Sign up: https://fixer.io