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

123
  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

1
  EXCHANGERATESAPI_API_KEY=<YOUR_API_KEY>

Add to medusa-config.js

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

Run Database Migrations

1
  npx medusa migrations run

Start the server

1
  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.

Build your own plugins

Develop your own plugins with our API to speed up your processes.

Make your plugin available via npm for it to be shared in our Plugin Library with the broader Medusa community.

Built by

Category

Version