FAQ
Do I need a Scalapay account? Yes, a Scalapay merchant account and its API key. For first tests the add-on uses the public sandbox key Scalapay publishes in its documentation.
Who pays the instalments, and who carries the risk? Scalapay. The customer agrees to the plan with Scalapay on Scalapay’s page; you receive the order amount from Scalapay under your contract, minus Scalapay’s fees.
Which currencies and countries? Euro only, and delivery to Austria, Belgium, Finland, France, Germany, the Netherlands, Italy, Portugal and Spain, as Scalapay states for its plugins. A shop whose main currency is not the euro can still offer Scalapay if euro is set up: the order total is converted once with your euro rate when the payment is created.
Where do the minimum and maximum come from? From your Scalapay contract; enter them in the settings. Scalapay publishes no API to read them; its plugin documentation names 5.00 EUR as the default minimum.
Should I capture at once or later? At once is Scalapay’s standard flow. Delayed capture (if enabled for your account) keeps the authorization for up to 5 days until you ship; capture or void it in time.
Can I capture in several parts? No, one capture per order (the full or a lower amount); Scalapay documents capturing “up to the total”, not several partial captures. Refunds can be partial and repeated.
Is the widget required? No. It is Scalapay’s own element, loaded from Scalapay’s CDN only on the pages you switch on, and shown only while the page shows euro.
Does it work with the full page cache of CS-Cart 4.21? Yes by design: the product page widget prints only data that is the same for every guest of that page, language and currency. Cart, checkout, return, webhook and cron are never cached.
What about the EU Consumer Credit Directive (CCD2)? Directive (EU) 2023/2225 applies through national laws from 20 November 2026 and covers buy now, pay later credit. The add-on helps you present Scalapay neutrally (no pre-selection, no claims about cost, ease or speed, details from Scalapay’s own widget and page, an optional information line). Check your wording with your adviser; this is not legal advice.
Does it change core files? No. Hooks, its own controllers and templates only.
My license shows “Pending verification”
Section titled “My license shows “Pending verification””This status appears in older add-on versions when you use a CS-Cart Marketplace license number that our license server has not matched with the Marketplace yet. The add-on is fully working in this state: no feature is switched off and you do not need to do anything. Newer versions show it as Active (Marketplace license). We confirm Marketplace numbers on our side; click Check now on the add-on’s License tab (Add-ons → Manage add-ons → the add-on) a little later and it shows Active. If it has not changed after 24 hours, contact support with your Marketplace order number.
Still stuck?
Section titled “Still stuck?”Work through the troubleshooting guide, then contact support with your CS-Cart version, edition, PHP version and the add-on version (1.0.0).