Cashmatic¶

Cashmatic cash machines automate cash transactions by accepting cash and dispensing change. When integrated with NightPOS Point of Sale, payments are processed directly through the machine from the POS register.

Note

The integration with the Cashmatic cash machine only supports payments and refunds.
Tasks such as filling and emptying the machine must be performed directly through the cash machine interface or via the MyCashmatic app (available on Android or iOS) or website.

Cash machine configuration¶

Important

Two separate sets of credentials are provided with the machine: one for the cash machine, required to configure it in NightPOS, and one for the MyCashmatic app or website, required to configure the cash machine itself.
The Cashmatic machine must be on the same local network as the device running NightPOS Point of Sale and must be assigned a static IP address to ensure stable operation.
Setting up the Cashmatic machine requires the hardware administrator’s password and technical knowledge. Contact your Cashmatic integration partner for configuration support if assistance is needed.

Configuring the Cashmatic machine as a payment method in NightPOS requires locating the machine’s IP address and preparing for connection over HTTPS or HTTP.

Note

HTTPS provides a more secure connection and requires additional configuration, including installing a valid certificate. HTTP allows communication through Local Network Access and is recommended as it is simpler to set up.

Locate the IP address¶

To locate the Cashmatic IP address, use one of the following methods:

On the Cashmatic machine, log in with the provided credentials, then go to Settings ‣ IP address.
In the MyCashmatic app or on the website, sign in to your account, then go to Settings ‣ Network.

Note the IP address displayed on the machine’s or the device’s screen, as it is needed for the NightPOS configuration step.

Connection over HTTPS¶

To connect the Cashmatic machine over HTTPS, a valid certificate is required. To generate and download the certificate, follow these steps:

Open a web browser and type the IP address in the address bar to access the Cashmatic web interface.
In the interface’s side menu, go to Settings ‣ Device.
Scroll down to the Use Cashmatic CA option and enable it.
Click Save and refresh the page. A Download HTTPS Certificate link appears at the bottom left of the side menu.
Click the Download HTTPS Certificate link.

To install the certificate on the device running NightPOS Point of Sale, contact your integration partner, as the process depends on the device’s operating system.

Connection over HTTP¶

To connect the Cashmatic machine over HTTP, use one of the following methods:

On the Cashmatic machine, log in, go to Settings ‣ Trusted mode, then click Yes.
In the MyCashmatic app or on the website, sign in to your account, go to Settings ‣ System, then enable Unsecured APIs.

NightPOS configuration¶

To connect the Cashmatic machine to NightPOS, follow these steps:

Install the POS Cashmatic Cash Machines (pos_cashmatic) module.
Go to Point of Sale ‣ Configuration ‣ Payment Methods and click New.
Set the Journal field to Cash.
Select the relevant POS in the Point of Sale field.
Set the Integration field to Cash Machine (Cashmatic).
In the Cashmatic Settings tab, enter the Cashmatic machine’s IP address in the Cashmatic IP field.
Enter the provided Cashmatic credentials in the Cashmatic Username and Cashmatic Password fields.
Optionally, enable Cashmatic Local Network Access to connect the machine over HTTP.