Medusa Plugin Currency Exchange Rates

A plugin that fetches the current exchange rates for every store currency every 2 hours.

Compatibility

This plugin is compatible with versions >1.20.6 of @medusajs/medusa

Probably also works with earlier versions 1.20 and 1.19 versions

Requirements

This plugin requires you have the Medusajs' Admin. @medusajs/admin

Getting Started

Installation

  yarn add medusa-plugin-currency-exchange-rates
  OR
  npm install medusa-plugin-currency-exchange-rates

Add to .env and Replace <YOUR_API_KEY> with your API Key that you can obtain from exchangeratesapi.io

  EXCHANGERATESAPI_API_KEY=<YOUR_API_KEY>

Add to medusa-config.js

  ///...other plugins
  {
    resolve: `medusa-plugin-currency-exchange-rates`,
    options: {
      enableUI: true,
      apiKey: process.env.EXCHANGERATESAPI_API_KEY
    },
  },

Run Database Migrations

  npx medusa migrations run

Start the server

  medusa develop

Roadmap

Once the medusajs v2.0 is released and stable, I will migrate this plugin to the newest version. This will probably be around end of this year, worst case next year.

Quick Notes

The Rates are fetched every even 2nd hour (0:00, 2:00, 4:00, ...) 24 hours a day - so 12 times in a day.
I recommend you purchase the Basic Plan for 10$, as it allows you to fetch exchange rates for ~28 currencies throughout a whole month.
Unfortunately, the Free Tier only allows for HTTP fetch requests and limits monthly request to 250, therefore I have not implemented functionality for it. It also limits you to only be able to fetch the rates for the Euro.