Overview
A production-ready exchange rate provider that pulls daily rates from the Central Bank of the Republic of Türkiye (TCMB) and feeds them into nopCommerce's native currency conversion. Works whether your primary currency is TRY, USD, EUR, GBP, or any other
TCMB-published currency.
Features
- Two TCMB sources — Public XML feed (free, no API key) and EVDS3 API (requires free key). Auto mode falls back from EVDS to XML.
- Cross-rate calculation against any primary currency.
- Rate type selection — Forex Buying / Selling, Banknote Buying / Selling, Forex Average.
- Markup pricing — global percentage + per-currency overrides.
- Rate effective timing — use new rates immediately when TCMB publishes, or apply on next business day (banking T+1 convention).
- Caching with configurable TTL (TCMB publishes once per business day).
- Resilience — serves last-known-good snapshot when TCMB is unreachable.
- Multi-store — every setting can be overridden per store.
- Test Connection probe in admin to verify rates without saving.
Supported currencies
USD, EUR, GBP, CHF, JPY, AUD, CAD, DKK, NOK, SEK, SAR, KWD, BGN, RON, RUB, IRR, CNY, PKR, QAR, KRW, AZN, AED (per-100 unit handling for JPY/KRW/IRR is built-in).
Requirements
- nopCommerce 4.90
- .NET 9 runtime
- Public XML mode: no extra setup
- EVDS API mode: free EVDS account & API key (instructions in bundled README)
Installation
Upload the zip via Admin > Local plugins > Upload plugin, install, and select "TCMB Exchange Rate Provider" as the active exchange rate provider in Configuration > Settings > General Settings.
Support
Bundled README.md covers configuration, troubleshooting, and EVDS key acquisition step by step.
