ImaCash integration

evoPOS

ImaCash beta for importing JSON transactions from MADIC UK’s evoPOS: folder, permissions, currency and scope of local confirmation.

MADIC UK evoPOS product image showing terminals and logo
Retail and service stations

Technical beta: The integration for evoPOS, developed by MADIC UK, is ready for controlled testing with real JSON exports before production use.

Required configuration

Open Configuration > Integration, choose POS > evoPOS and select the folder in Sales. Close Configuration and confirm saving. Saving checks only that the folder exists; it does not prove permissions, receipt or payment. The currency configured in ImaCash must match the currency in the tender lines.

Prepare a dedicated folder

The Windows user running ImaCash needs to read and move files and create subfolders. Dedicate the folder to this installation and confirm terminal, user and store mapping. This profile does not request a SQL server, port, username or password.

Deliver complete files

The exporter must finish writing before making each .json file visible in the main folder. Subfolders are not scanned and date/time settings do not recover history. Files over 10 MiB are rejected; locked or incomplete files may wait for another read.

Amounts and payment methods

Positive amounts and a single recognised type are accepted: cash or card. The sale total is used, not cash tendered or change. Mixed payments, unknown or inconsistent methods and incompatible currencies are rejected; cancelled, suspended and training sales are set aside. Refunds are not supported. Accept cards does not prove bank payment or a card total.

What the subfolders mean

processed means local file persistence, not physical payment. error holds unsupported files or import failures; ignored separates excluded transactions and duplicate holds duplicates detected during one read. Review the cause with support; do not restore or rename files to force another attempt. Duplicate prevention is not guaranteed in every scenario.

Scope of this beta

The current specification does not yet define an outbound confirmation, cancellation or status update to evoPOS. Confirming or rejecting in ImaCash does not close or cancel the sale in evoPOS or prove the machine’s outcome.

Verify the complete workflow

Arrange authorised anonymised samples and supervised testing of receipt, amount, currency, references and outcome. This profile does not provide items, shifts or terminal and salesperson catalogues. The synthetic test does not validate physical devices. If the outcome is uncertain, check evoPOS, ImaCash and actual cash before repeating, restoring input files or restarting.

Official evoPOS information from MADIC UK

Beta integration available

The next step is validation with real evoPOS exports

Contact support to prepare the exporter and arrange supervised testing before enabling commercial use.