Milan / Paylink System Manual Issue 1.5 29 January 2020
CONFIDENTIAL
Not to be disclosed without prior written permission from Aardvark Embedded Solutions Ltd
Page 9 of 71
Paylink
Installation
All aspects of actually installing Paylink software on a target PC are described in the companion
Application Program Interface document.
Money representation
Within Paylink all monetary figures are in 32 bit integers, which represent an amount of money in
terms of a single base unit. This would typically be pence or cents, but could be yen etc.
Where note acceptors are reading in high value notes, the acceptor will typically provide a conversion
factor, which enables Paylink to convert the notes. A “normal” dollar / euro acceptor will provide a
conversion factor of 100.
Acceptance
All money acceptance is handled by means of updating total counters. Before starting operation, the
application notes the current value of all the counters in which it is interested, and then monitors
these counters for changes.
This serves to remove all needs for queuing and for spotting events from the system - there is no way
that application can fail to have accurate information.
For the simplest application, there is a single total of all credit received. This actually totals the credit
received for the life of the unit, and hence can also be used for auditing / security purposes.
For a more complex understanding of the money received, Paylink provides a block of information for
each acceptor. As well as being able to use this block to disable specific coins / notes it also monitors
the insertion of each coin / note. For each coin / note the total number accepted since the Paylink unit
was reset is reported.
Payment
Paylink provides two similar mechanisms for paying currency out from dispensers to the users of the
system.
The original system used the Payout() function and with this the application specified the total
amount, and Paylink would attempt to pay out sufficient of the available notes and coins to total the
specified amount.
The new (1.12.6) precise pay system uses the SetDispenseQuantity() and PaySpecific() functions
to pay out a precisely specified set of notes and coins.
Payout Function
This method of paying money out using a Paylink is by calling the Payout() function, which takes a
value in Paylink base units.
Paylink maintains a count of the total of all credit paid out for the life of the unit. This total is updated
continuously as the process of paying money out proceeds, and can be used to check the amount of
credit that has been paid out in the event of a payout being in progress when power is lost.