Automatic update of NBP exchange rates with margin

PP-M022
Integrations
1.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.

    174.00 zł Tax excluded

    Enter domain for this product

    event Important: Domain change possibility expand_more

    If the module will be tested, enter a test domain during purchase.

    You will report the change to a production domain later.

    In case of an incorrectly entered domain, please contact us as well.

    Changing the domain to a production one is possible once and requires reporting within 3 days of starting its use.

    Reports: shop@prestapremium.com

    In the content, provide:

    • order number
    • product name
    • current domain
    • new domain

    Details

    shopping_cart Will be added to cart 1 pieces of this product (one for each domain)

    Information Parameters:

    • 1.0.0
    • 2026-02-26
    • 1.7, 8.x, 9.x
    • 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.

    ## [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

    • 1. What payment methods do you accept?

      We accept payments by credit/debit card, bank transfer and online payment systems such as Przelewy24, PayPal. Details can be found on the payment page.

    • 2. Can I test the module before purchasing?

      We do not provide modules for testing on individual PrestaShop instances. If a given module has a demo version, it is available on our test store, where you can familiarize yourself with its functionality. On the product page you will also find a detailed description, screenshots and instructional materials. In case of questions, please contact us - we will be happy to provide additional information.

    • 3. 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.

    • 4. How can I download a purchased module?

      After you pay for your order and the payment is posted, the link to download the module will appear in your account in the "Order History and Details" tab ("Details" button). Additionally, we will send you an email with a download link.

    • 5. Can I get help installing a module or template?

      Yes, we offer installation and setup service as an additional option. You can add it to your cart when purchasing the product or order it separately.

    • 6. Are the modules compliant with GDPR regulations?

      We design our modules with GDPR compliance in mind. If a module processes personal data, you will find detailed information on compliance with the regulations in its description. We make every effort to ensure that our solutions meet current data protection standards.

    • 7. Can I have my store audited before purchasing a module?

      Yes, we offer a store audit service to help you choose the right modules and identify areas for improvement. Contact us for more information.

    • 8. Can I get a discount as a regular customer?

      Yes, for our regular customers we offer a loyalty program with attractive discounts. Check the details in your customer panel. If you do not see such an option, contact us - we will be happy to help!

    • 9. What should I do if the product does not meet my expectations?

      If the product does not meet your expectations, please contact our customer service department. Any returns are considered individually, in accordance with our regulations.

    • 10. Can I modify a purchased module or template?

      Yes, you can modify purchased products for your own needs, but you cannot resell them or share them with third parties. Details can be found in the license terms and conditions.

    • 11. Can I use the purchased module in multiple stores?

      Purchased modules are licensed for a single store. The exception is the use of the multi-shop feature within a single PrestaShop installation. In this case, you can use the module on multiple stores, even with different domains, provided that:

      • all stores run on the same PrestaShop installation,
      • the module is compatible with the multi-shop feature.
    • 12. How can I check if a module will work with my other installed modules?

      Our modules are designed to be as compatible as possible with other popular PrestaShop extensions. If you have any doubts, contact us and send us a list of your modules - we will help verify it.

    • 13. Are the modules translated into different languages?

      Most of our modules are available in several languages, including Polish and English. Information about available languages ​​can be found in the module description.

    • 14. How long does it take to process an order?

      The order is fulfilled automatically after the payment is posted. The product can then be downloaded immediately after the order has been paid for.

    • 15. What to do if module installation ends with an error?

      Check if your PrestaShop version is compatible with the module and if you have the right permissions for installation. If the problem persists, contact our technical support - we will help you solve the problem.

    • 16. Can I order a module that is not available in your offer?

      Yes, we do custom module creation. Contact us for details and pricing.

    • 17. How can I extend technical support or access to updates?
      • Extension of support and updates:

        • If the option to extend support and updates is available, you can order it directly from our store.
        • Simply add the appropriate option to your cart and complete the purchase.
      • No available extension option:

        • If support and update extensions are not offered, purchasing the module again will be required.
    • 18. How long can I use the module after purchase?

      Purchased products are available for use without time limits. However, access to updates and technical support is usually limited to 6 or 12 months from the date of purchase, depending on the product. (details on updates/support are always included on the respective product card)

    • 19. Do you offer technical support for products?

      Yes, we provide technical support within the support period assigned to a given product. You can contact us via the contact form or e-mail.

    • 20. Can I update the module to a newer version?

      Yes, you can download new versions of the product for free during the support and update period. After that time, you can renew your update subscription.

    • 21. Can I ask you to adapt the module to my needs?

      Yes, we offer a module personalization service. Describe your needs and we will prepare an individual quote.

    • 22. What should I do if I have problems downloading the module?

      If you have trouble downloading the module, please make sure your payment has been processed. If you still have trouble, please contact us and we will manually provide you with the module.

    • 23. Do you offer help with store optimization after installing the modules?

      Yes, we can help you optimize your store so that your modules run at full efficiency. Ask about our technical support service.

    • 24. What does the module update process look like?

      If the module requires an update, you can download the latest version from your client panel. We recommend backing up your store before updating.

    • 25. Can I change the domain on which the module runs?

      Yes, if you want to transfer the module to another domain, please contact us to discuss the details and conditions of the license transfer.

    • 26. What should I do if my store stops working after installing the module?

      If your store encounters problems after installing the module, please contact our technical support immediately. We will help diagnose and resolve the issue.

    • 27. Can I ask for advice in choosing a module?

      Of course! Contact us and we will advise you which module best suits your needs.

    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!