Open Exchange Rates provides real-time rates for all the main currency pairs via a free API access. We are using this API for our multi-currency features and to convert prices on several components of the Maestrano Suite.

1 - Signup on OpenExchangeRates.org

1. Access https://openexchangerates.org/ and click on "signup" on the top-right corner
   
   
   
   
2. Select the "Enterprise plan" by clicking on "Sign up here" in the corresponding frame. In Connec! and Impac!, the rates are going to be retrieved only once for each day, and cached for the following calculations. The 100,000 API requests/month proposed by the enterprise plan should be way enough. You will still have the possibility to upgrade your account later on if necessary.
   
   
   
   
3. Enter your personal details and click "Continue"
   
   
   
   
4. Enter your credit card details, and finish the account creation process.

2 - Activate your API keys

After the signup process is finished, you should be redirected to your account dashboard. You will need to create API keys for your different environments. Let's assume you want to use OpenExchangeRates for a UAT and a PROD environments.

1. Click on "App IDs" in the left menu
   
   
   
   
2. You will need to create 2 API keys: one with the label "UAT", one with the label "PROD". Once the API keys have been created, you should be able to see their auto-generated values:
   

3 - Configure Impac!™ and Connec!™ to use your OpenExchangeRates account

To configure Impac!™ and Connec!™, you only need to pass them your API credentials via environment variables.

• If you are using Nex!™, simply save the following env vars to your UAT and PROD containers for Impac!™ and Connec!™:

  nex-cli apps:vars container_name --add OPENEXCHANGERATES_APP_ID=your-app-id

• If you are deploying the Maestrano Suite using the Ansible scripts, you will need to update the files your_project_uat.yml and your_project_prod.yml:
  
  

  mnohub_config:
    secrets:
      open_exchange_rate_id: your-app-id