Automatic update of NBP exchange rates with margin

PP-M022
Integrations & API
  • 1.7.7 + | 8.x | 9.x
  • EN, FR, IT, DE, PL
  • 1.0.0
  • 2026-02-26

Automatic currency rate updates is a PrestaShop module that automates a critical area of e-commerce: updating exchange rates based on the NBP API and your own margin rules. The ideal solution for B2B/B2C sales, where outdated conversion rates directly reduce the profitability of your offer. The administrator gains full control and access to logs, whilst the technical team benefits from a secure synchronisation process using CRON in a multistore environment.

52.20 € Tax excluded

Information Parameters:

  • 1.0.0
  • Store Version PHP Version
    1.7.7 + 7.1 – 7.4
    8.x 8.1 – 8.3
    9.x 8.1 – 8.5
  • 2026-02-26
  • EN, FR, IT, DE, PL

Key Benefits

  • Stable pricing policyautomatic retrieval of rates from the NBP API reduces the risk of selling based on outdated conversion rates.
  • Currency margin control — independent adjustments (fixed or percentage-based) per currency allow you to manage the profitability of your offer with precision.
  • Reduced operational workload — a secure CRON schedule and manual update reduce the time spent administering prices in the shop.
  • Secure production process — SSL-only mode and token security limit the risk of abuse and erroneous script invocations.
  • Multistore scalability — the configuration and logic of the PrestaShop currency converter operate independently per shop, without conflicts between contexts.

Use Cases

  • Export shops settling sales in multiple currencies and requiring daily rate synchronisation.
  • B2B e-commerce with individual margin policies, where precise exchange rate differences affect the final commercial offer.
  • D2C brands running several storefronts and requiring consistent price conversions in a multistore model.
  • Shops with high price turnover that need to shorten response times to market changes and eliminate manual corrections.

Features – Back Office

1. Status and On-Demand Update

The administrator can see the date of the last update, the date of the retrieved NBP table, and the shop's default currency.

  • Manual update triggered with a single click from the admin panel.
  • Operational control without the need to log in to the server.
  • Quick monitoring of rate changes from a single, clear view.

2. Margins per Currency

The panel allows separate configuration of a fixed margin (e.g. in PLN) and a percentage margin (%) for each currency in the shop.

  • Full control over sales profitability across individual markets.
  • Data validation and automatic rejection of invalid values.
  • Immediate recalculation of rates after saving new settings.

3. NBP Integration and Table Selection

The module fully supports currency tables A, B, and A+B depending on the range of target markets.

  • Data source matching to a specific sales model.
  • Support for currencies unavailable in a given table (the script does not block the update process).
  • Cross-rate support for shops with a default currency other than PLN.

4. CRON and Security

The system generates ready-to-use URLs and a CLI command for automating rate updates on the server.

  • Tokenised endpoint for authorising CRON invocations.
  • Security token regeneration with a single click, without any code changes.
  • SSL-only mode (active by default) for protecting production environments.

5. Logs and Retention

The built-in update log records INFO / WARNING / ERROR entries with the option of automatic clearing.

  • Full process audit and rapid diagnosis of any potential issues.
  • Log retention prevents excessive database growth.
  • Improved technical workflow between administrator and developer.

Features – Front Office

1. Invisible to the Customer, Critical for Pricing

The module does not add any heavy UI widgets to the Front Office, but directly updates the core PrestaShop data, which affects the final prices displayed in the shop.

  • Better pricing UX thanks to always up-to-date and consistent conversions.
  • Fewer complaints resulting from exchange rate discrepancies at the basket stage.
  • Greater credibility of the offer in the eyes of international customers.

Impact on Sales and SEO

  • Automation reduces response time to market changes from many hours to a scheduled CRON interval.
  • Stable conversion rates reduce pricing errors and improve the conversion rate on currency-specific landing pages.
  • Consistent prices across channels (product page, listing, checkout) build trust and reduce the abandoned basket rate.
  • For SEO: price consistency across the shop prevents errors in structured data (Schema.org), protecting the offer from rejection in Google Merchant Centre and sudden drops in visibility.

Please Note!

Before deploying to production, perform a full backup (shop files + database) and test the CRON configuration and SSL policy in a staging environment. Changing the NBP table, CRON token, or margins directly affects prices throughout the entire shop, therefore we recommend following a change management procedure and preparing a rollback plan for rapid system recovery.

Download:


PrestaShop module installation (625.83KB)

Universal documentation describing the module installation process for PrestaShop.

## [1.0.0] - 2026-02-25

### Added

- Initial public release of `ppcurrencyautoupdate`.
- NBP API integration with table selection: `A`, `B`, `A + B`.
- Manual update action in BO (`Update rates now`).
- CRON support (HTTP and CLI) with security token.
- Per-currency margin management:
  - fixed margin (PLN),
  - percentage margin (%).
- Automatic recalculation of PrestaShop conversion rates after margin save.
- Validation summary after save: saved/rejected/recalculated counters.
- Update log panel with levels `INFO`, `WARNING`, `ERROR`.
- Log retention settings with automatic old-entry cleanup.
- SSL mode switch with secure default (`SSL-only = ON`) and optional dev fallback.
- Non-PLN default currency handling (cross-rate computation).
- BO tabbed interface: Status, Exchange rates & margins, Settings, CRON Configuration, Update log.
- Multistore-aware configuration and per-shop processing.
- Integration with PP updater and admin tab installer components.

### Changed

- Improved admin UX for margin editing and save feedback.
- Clearer help text for fixed margin behavior (net/gross clarification).
- Persistent active tab in BO after form submissions.

### Fixed

- Updater output visibility issue caused by namespace mismatch.
- Immediate propagation of recalculation flow after margin save/settings changes.
- Translation coverage in `pl`, `de`, `fr`, `it` language files.

FAQs

  • Are the modules compatible with my version of PrestaShop?

    Each module in our store contains information about compatibility with specific PrestaShop versions. Please check this information carefully before purchasing. If you are not sure, contact us.

  • Where does the module obtain exchange rates for updates?

    The module retrieves rates from the National Bank of Poland API. In the configuration, you can select table A, B, or A+B according to the markets and currencies used by your store. It also handles currencies that are absent from the selected table without blocking the entire update.

  • Can I set a separate margin for each currency?

    Yes. The panel lets you define an independent fixed or percentage adjustment for every currency. This helps maintain your own profitability policy across different markets. The module validates the entered data and recalculates rates after settings are saved, so changes are immediately reflected in the current store configuration.

  • How do I enable automatic exchange-rate updates?

    Automatic updates are handled through CRON. The module generates a ready-to-use URL and CLI command that can be added to the server scheduler. Updates can also be started manually from the administration panel. The CRON call is protected by a token, which can be regenerated when necessary without changing the module code.

  • Do exchange-rate updates work in a multistore environment?

    Yes. The configuration and recalculation logic operate independently for each store in a multistore environment. This makes it possible to maintain different exchange-rate and margin rules without conflicts between store contexts. Administrators can therefore manage updates separately where the offer requires distinct currency settings and pricing policies.

  • How can I review the currency synchronisation process?

    The module records an update log with INFO, WARNING, and ERROR entries. The logs let you review the process and diagnose potential issues more quickly. Log retention is also available to remove older entries automatically, helping limit database growth and keep operations organised.

Do you need additional features or custom solutions?

  • Module customisation tailored to your specific requirements.
  • Extending functionality to enhance your store's capabilities.
  • Developing bespoke modules designed to meet your unique needs.
  • Integrating external systems and additional tools.
  • Optimisation and improvements for better performance and user experience.

Do you have ideas on how to improve this software? Share your suggestions for optimisation, new features, or bug reports – we’ll be happy to review them!