This article is for our legacy version, discontinued in 2017 and incompatible with new machines.
Please use the latest setup instructions if you've recently received a machine.
This is a resource for existing operators still on the old generation platform.
This article continues the setup process after the instructions contained in the 'Santo Tirso physical setup' article.
Updating the software
Updating the machine
Contact us at email@example.com to update your machine's software to the latest version that contains support for cash-out.
Afterward, the cash-out screen options won't be enabled until the server-side configuration is complete.
Updating the backend
If you've received the Douro and Santo Tirso together, and have not yet set up the backend for the machine, follow this walkthrough for setting up a new server and admin.
Once set up and paired with the machine, continue with the 'Configuring cash-out settings' section below.
If you're upgrading an existing one-way machine to a two-way, you will need to check if your server version is compatible. In your server's terminal, check by running:
npm -g ls lamassu-server
If the result is below firstname.lastname@example.org, contact our support team for the best upgrade procedure in your case.
Now let's configure the two-way software.
Configuring cash-out settings
Assigning machine names
For easy reference, we'll assign a name to the machine. Run the command:
You'll be presented with a randomly generated two-word name and associated fingerprint. Run this command anytime to retrieve the machine name.
If you have multiple machines paired to a single server, they may be distinguished by fingerprint. If these have not be previously recorded, reach out to our Support and they can retrieve each machine's fingerprint remotely.
To set the country for SMS redemption, run the lamassu-set-locale command using your country's two digit ISO code. Example for Hungary:
This is distinct from when you set your machine's currency and language. If these have not already been set, run lamassu-set-locale with your country code, currency, and locale (further info):
We'll need to tell the server what denominations you'll be placing in each cartridge. For instructions and an example, run the command:
If the machine named
taco-truck will use $5 bills in the upper cartridge, $20 bills in the lower, and present a screen option for a virtual $10 bill (2 x $5), run:
ssu-cartridges 5 20 10
Upon initially stocking the machine, and each time refilling the cartridges thereafter, update the bill count.
For examples on usage and to see the machine's current bill count, run:
taco-truck has 200 bills in the top cartridge, 50 bills in the bottom cartridge, run:
ssu-bills taco-truck 200 50
The machine will rely upon this bill count number in the server to determine how much is available to dispense. If the amount in the server is set higher than the actual cartridge amount, it will allow for a transaction which dispenses less cash than the user requested. When refilling the cartridges, be sure to count the amount and run the
ssu-bills script again as above with updated figures.
Your machine works with three limits, the maximum per cash-in transaction (previously set in the admin), the maximum per cash-out transaction, and the amount up to which you'll accept cash-outs with zero-confirmations (with SMS redemption enabled above this).
For examples of usage, run:
To set a $1000 limit for cash-in, $500 limit for cash-out, and zero-confirmation cash-out transactions for $200 and under, run:
ssu-limits -a 1000 -d 500 -z 200
Your machine communicates with Raqia, our service to provide double-spend detection for zero-confirmation transactions as well as SMS redemption support for transactions above your zero-confirmation limit.
For your machine to access the secure service, you'll be provided an API key. Please contact Support to be assigned a key. Once assigned, update your server with the key:
To now enable two-way mode, restart the server with the following command:
Then, physically reboot the machine. For Trofa models, hold down on the Nexus tablet's power button (upper, right corner) for ~7 seconds. For Douro models, press once on the Aaeon tablet's power button, wait for full shutdown to black, then press once more.
Use care when manipulating the two flaps which retain the bills in each cartridge. Inside the top of the opened cartridge you will see a guideline for how to align the bills.
Bills can end up in the dispenser's reject tray if they are of the incorrect length or the denomination in the server is set incorrectly. The Santo Tirso will attempt to dispense the next bill from the bottom of the cartridge stack until it detects a note of the correct bill length. If set incorrectly, it will reject all notes in the cartridge.
The machine will generate a new address for each cash-in transaction.
For any reason, if you wish to disable two-way mode, run the command:
Afterwards, the machine should be rebooted.