Valina
Valina
Valina
VALINA
the next generation
compact, convenient, complete
The information in this document is subject to change without notice and shall not be construed as a
commitment by Worldline S.A./N.V. (“Worldline”)
The content of this document, including but not limited to trademarks, designs, logos, text, images, is
the property of Worldline and is protected by the Belgian Act of 30.06.1994 related to authors’ rights and
by the other applicable Acts.
The word VALINA and other trademarks used in this document are the property of Worldline. Worldline
trademarks used in this document are indicated. Linux is a registered trademark of Linus Torvalds, Java
is a registered trademark of Oracle and/or its affiliates and Android is a trademark of Google Inc.
The contents of this document can be reproduced by or on behalf of third parties with the prior written
consent of Worldline and following its instructions. Worldline accepts no responsibility for errors and
omissions introduced when translating or reworking this document.
Except with respect to the limited licence to download and print certain material from this document for
non-commercial and personal use only, nothing contained in this document shall grant any licence or
right to use any of Worldline's proprietary material.
While Worldline has made every attempt to ensure that the information contained in this document is
correct, Worldline does not provide any legal or commercial warranty on the document that is described
in this specification. The technology is thus provided “as is” without warranties of any kind, expressed
or implied, included those of merchantability and fitness for a particular purpose. Worldline does not
warrant or assume any legal liability or responsibility for the accuracy, completeness, or usefulness of
any information, product or processes disclosed.
To the fullest extent permitted under applicable law, neither Worldline nor its affiliates, directors,
employees and agents shall be liable to any party for any damages that might result from the use of the
technology as described in this document (including without limitation direct, indirect, incidental, special,
consequential and punitive damages, lost profits).
These terms shall be governed by and construed in accordance with the laws of Belgium. You
irrevocably consent to the jurisdiction of the courts located in Brussels for any action arising from or
related to the use of this document.
Document information
document title VALINA integration manual
security unrestricted
last modified 6 June 2016
owner Luc Luyckx
author Niels Grundtvig Nielsen
document release 0.1
© Worldline 2016
Contents
unrestricted i
im_valinaTOC.fm document release 0.1 last updated 6/6/16
ESD immunity............................................................................................. 32
Safety ......................................................................................................... 32
VALINA with GSM ...................................................................................... 32
VALINA with WLAN.................................................................................... 32
Figures
unrestricted iii
im_valinaLOF.fm document release 0.1 last updated 6/6/16
unrestricted 1
im_vln_about.fm document release 0.1 last updated 6/6/16
The VALINA is an intelligent all-in-one terminal for unattended payments with and
without PIN, supporting a range of standards including EMV and Mifare. It handles
payments by chip card, NFC cards and devices, and magstripe card.
The VALINA is PCI 4.x certified, SRED included. It has been designed to provide a
complete solution for EMV payments, and can run either newly-developed Android apps
or legacy apps (written for the MAPS platform) from Worldline.
Key hardware features include:
• onboard Ethernet, serial interface, MDB, USB host and USB device meet most
communications requirements out-of-the-box
• proximity detector (patented) for improved power management
Typical integration scenarios for the VALINA include:
unrestricted 3
im_vln_keyFeatures.fm document release 0.1 last updated 6/6/16
For more information on connectors, see Power supply, ports and pin-outs, on page 17.
3. Safety
Follow the guidelines in this manual when integrating the VALINA. Neither Worldline nor
its vendor will bear any responsibility or cost for malfunctioning, breakdowns or any
anomaly that may result from incorrect handling of the VALINA. Worldline declines any
liability if the instructions and precautions contained in this manual are not observed.
If you notice that any VALINA component blocks, does not fit, or shows any other
malfunction, contact your vendor. Do not try to repair or alter it in any way.
Use only accessories (power adaptor, cables and so on) provided by your vendor or by
an approved source.
Check that the VALINA has completed the required application-loading and key-loading
stages.
Operating safety
Keep the VALINA away from excessive heat, fire, high voltage, radiation, shocks and
abrasive chemicals.
To guarantee safe operation of the VALINA, make sure:
• the VALINA is firmly fixed in the kiosk/vending machine and correctly powered
• the kiosk/vending machine where the VALINA is mounted is protected from
dust, strong sunlight, rain, wind and flying debris (for example, stones thrown
up by passing traffic)
• the operating temperature of the VALINA remains between -20°C and 70°C
This corresponds to an environmental temperature of -20°C to +50°C, depending
on the position of the terminal (in direct sunlight, sheltered …)
Always:
• use only the power adaptor supplied, or a power adaptor compliant with the
appropriate specifications
• disconnect the power adaptor before cleaning the housing and for servicing or
repair
Never:
!
• drop, throw, slam or vibrate the VALINA
• let oil, water or other liquids enter the VALINA
unrestricted 5
im_vln_safety.fm document release 0.1 last updated 6/6/16
• use extension cables to extend the power cable between the power adaptor
and the VALINA
• connect any unused cables to the VALINA
• store, install or use the VALINA
– near any source of excessive voltage fluctuations, electromagnetic fields or
microwave radiation (for example, electric motors or high-frequency devices)
– in a deep-freeze or a defrosting system
• store the VALINA near food, or with explosive substances such as lighter fuel
or petrol
• open the VALINA
Contact your vendor for information on how to dispose of your VALINA at the end of its
life. Do not discard, give away or sell your VALINA as it contains materials that can be
recycled and must be treated by a professional party.
6 unrestricted
last updated 6/6/16 document release 0.1 im_vln_safety.fm
4. Installing VALINA
85.50
118.10
17.80 50.80
86.40
110.00
• make sure the front panel of the vending machine is smooth and rigid with no
unfinished edges on any of the holes or openings.
• installing a SAM card (described on page 12) and installing an optional
communications board (described on page 14) are easier before installing the
VALINA in a vending machine
unrestricted 7
im_vln_installing.fm document release 0.1 last updated 6/6/16
• make sure the VALINA cannot be removed from the vending machine after
integration
Selecting a location
The terminal is designed for unattended use both indoors and outdoors. Electrical
installations where the VALINA is installed must comply with local and regional codes for
office and residential electrical wiring, such as International Electrotechnical Commission
(IEC).
Finding a proper location is an important aspect of installing VALINA components.
Follow the guidelines given here, and also check local requirements:
• select a location on the machine that is conveniently accessible
• on the front side of the vending machine, make sure that:
– the VALINA fits in the mounting position
– the VALINA faces the cardholder and will be clearly visible
– the display is readable
– the card slot is accessible
• avoid a position that exposes the VALINA to rain or hostile weather
• make sure air can circulate freely around the components
• to avoid reflections and guarantee readability, do not expose the display to direct
sunlight
• for the security of the card-holder, make sure that PIN privacy is guaranteed:
– locating the display outside the field of vision of cameras, mirrors and so on, and
away from stairs
– check all local regulations and requirements for PIN privacy
• for the convenience of the technician, make sure there is sufficient space on the
vending machine to:
– access the ground connection
– guide the cables without folding them, and use cable ties
– fit the mounting brace that fastens the terminal tightly into the machine
– access the rear side of the VALINA
• the maximum permitted length of the cable between the VALINA and the vending
machine controller (VMC) is 3m
8 unrestricted
last updated 6/6/16 document release 0.1 im_vln_installing.fm
Packaging
packaging
quantity item
1 VALINA terminal
2 fixing plates
1 gasket
optional items
1 power adaptor
cable(s) RS232 VALINA serial cable 2m (ePOS/ECR to VALINA), Ethernet, RS232,
USB, power (TTL)
Inspect the package for damage, and make sure it contains all the items listed. In case
of doubt, or if items are missing or damaged, contact your shipping company and/or
vendor.
If you are going to attach the mounting plate direct to the vending machine, you will also
need four M4 locknuts. These are not included in the package.
2. Clamp the EVA frame to the rigid front plate of the machine using four locknuts.
note: these locknuts are not included in the terminal package
3. Tighten the locknuts in a Z-pattern.
To avoid damaging the VALINA, do not over-tighten the nuts. 0.7Nm is
recommended, depending on the material the front plate is made from.
After mounting the VALINA on the vending machine, continue by connecting the power
and communications cables as described under Power up VALINA and fasten cables, on
page 10
Step 3. Connect power and communication cables at the back of the VALINA
There are six numbered interfaces on the back of the VALINA, for connections to
external peripherals.
unrestricted 9
im_vln_installing.fm document release 0.1 last updated 6/6/16
For detailed information on pinouts, see Power supply, ports and pin-outs, on page 17.
table
To reduce wear on the connectors, use a cable tie to fasten the cables to the strain-relief
point on the EVA frame of the VALINA.
10 unrestricted
last updated 6/6/16 document release 0.1 im_vln_installing.fm
In normal state, the status LED on the front of the VALINA lights up steadily as soon as
! you power up the terminal. In tampered state, the device displays a warning message
and it is not possible to use the terminal to make a payment. When a warning message
is displayed:
1. remove the terminal from service
2. contact the supplier immediately, who may then report the problem to Worldline
3. keep the terminal available for possible forensic investigation
unrestricted 11
im_vln_installing.fm document release 0.1 last updated 6/6/16
• install any SAM card before installing the optional communications board
• install both SAM card and communications board before installing the VALINA in
the vending machine.
1. open TELECOM cover
Remove the retaining screw of the TELECOM cover (if present) and open the
cover.
12 unrestricted
last updated 6/6/16 document release 0.1 im_vln_installing.fm
If you will be installing the optional micro SD card or the optional communications
board, do not close the TELECOM cover yet
If you are using a retaining screw for the cover, use one 8 torx screw (included). Do
not over-tighten the screw.
unrestricted 13
im_vln_installing.fm document release 0.1 last updated 6/6/16
If you will be installing the optional communications board, do not close the
TELECOM cover yet
If you are using a retaining screw for the cover, use one 8 torx screw (included). Do
not over-tighten the screw
Do not plug in cables before installing the communication board in the VALINA
5. Fit the SIM in the SIM card holder
The SIM card is required for 2G/3G.
valinaSIM
Insert the SIM card as shown. Make sure the card is completely inserted, then close
the SIM card holder.
6. Guide the cable or antenna and close the TELECOM cover
Guide the cable or antenna through the notch in the back housing, then close the
TELECOM cover while holding the cable or antenna cable in place. If you are using
a retaining screw for the cover, use one 8 torx screw (included). Do not over-tighten
the screw.
unrestricted 15
im_vln_installing.fm document release 0.1 last updated 6/6/16
This chapter describes the power supply / data connectors on the VALINA.
Power supply
The VALINA is powered from an external power adaptor through port 5 (TTL) or port 6
(MDB).
unrestricted 17
im_vln_connections.fm document release 0.1 last updated 6/6/16
The VALINA is CE certified in combination with the Powertech ADS 0271-B adaptor. If
any other power supply is used, the distributor is responsible for compliance with local
safety requirements and regulations.
VALINA cannot be powered through the USB device interface: it always needs an
! external power supply.
18 unrestricted
last updated 6/6/16 document release 0.1 im_vln_connections.fm
RS-232 interface
The VALINA has one RS-232 interface with RTS/CTS flow-control, for connecting to
peripherals such as a vending-machine controller, ePOS equipment or a printer.
VALINA cannot be powered through the USB host interface: it always needs an external
! power supply.
The pin-out of the USB host interface is as follows:
unrestricted 19
im_vln_connections.fm document release 0.1 last updated 6/6/16
Power consumption
The VALINA is fitted with a proximity sensor that helps supports smart energy
consumption by switching between different states.
state details
6. JTAG/DEBUG port
For development and repair purposes, the VALINA is equipped with a JTAG/Debug port,
underneath the SAM cover. This port can be used to connect a PACIFIC Debug Interface
for debugging and logging purposes. This port can also be used to connect a JTAG
Interface for repair and reflash purposes. The following interfaces are available on this
port:
The JTAG/Debug port uses a spring-loaded connector with 2.54 mm pins. It is available
on all terminals (normal, production, and development).
The following interfaces are available on this port:
1 3V3 2 JTAG_TSEL(0)
unrestricted 21
im_vln_jtag.fm document release 0.1 last updated 6/6/16
22 unrestricted
last updated 6/6/16 document release 0.1 im_vln_jtag.fm
7. Cleaning
For optimal functioning of your Worldline terminal and accessories, clean them regularly.
1. Disconnect the equipment from the power supply.
2. Clean the equipment with a soft damp cleaning cloth.
3. Clean the display with a soft dry anti-static cleaning cloth.
4. Clean card readers every two weeks, with an appropriate cleaning card.
Contact your vendor for information about cleaning cards.
After cleaning, do not forget to re-connect the equipment.
Do not:
! • immerse the products in water, or use a lot of water while cleaning
• spray water directly on to countertop or portable terminals
• let dirt enter the card readers
• use detergents, solvents, alcohol or abrasive products
These products may damage surfaces and make transparent parts opaque.5.
Cleaning cards
valinaCleanChip
Follow the instruction found on the packaging of the cleaning card. This card can be used
for up to 12 cleanings of the reader before you need to replace it.
valinaCleanMag
Follow the instructions on the packaging of the cleaning card. This card can be used for
up to 8 cleanings of the reader before you need to replace it.
unrestricted 23
im_vln_cleaning.fm document release 0.1 last updated 6/6/16
All servicing other than the actions described in this manual must be performed by
Worldline or an approved service centre.
When a VALINA or any of its accessories is at the end of its life, it must not be simply
thrown away, given away or sold on. As terminal vendor, you are responsible for the
correct decommissioning of terminals and their components or accessories at their end
of life. Remember that:
• security awareness requires erasing cryptographic components securely and
completely
• sustainability requires recycling as many components as possible
• environmental awareness requires disposing of hazardous materials professionally
Step by step
Inspect the terminal for completeness, signs of intrusion and tampering, as explained
under Security recommendations, on page 17.
If you find any evidence of tampering, report the problem to Worldline and keep the
terminal available for possible forensic investigation
1. If you do not find any evidence of tampering, dispose of the terminal following local
rules and regulations for disposal of electronic equipment, such as WEEE. Make
sure that the person or organisation responsible effectively destroys the terminal
and its components.
2. Log the physical disposal of the terminal in the assets register.
unrestricted 25
im_vln_decommission.fm document release 0.1 last updated 6/6/16
display
3.5”, 320 x 480 pixels, 64K colour, capacitative touchscreen (backlit)
communications – on-board
Ethernet 10/100
RS-232
communications – optional extensions
2G/3G – GSM, GPRS, EDGE / UMTS, HSDPA
Bluetooth/WiFi
interfaces
Ethernet
RS232, to serial peripherals (for example, vending machine controller or printer)
Microfit 43045, power input/output socket (12V DC, 2A)
MDB
USB host and USB device
chip security modules
2 SAM slots type ID 0
2G/3G interface board contains 1 SIM slot
processing capabilities
hardware cryptographic accelerators
memory
512 Mbytes RAM
4 Gbytes Flash memory
micro USD
power supply
12V DC, 2A (when using Microfit)
24 – 45 VDC (when using MDB)
proximity detector
weight
573 g
unrestricted 27
im_vln_techSpecs.fm document release 0.1 last updated 6/6/16
Dimensions
For exact measurements, including tolerances, download drawing 3034910003 from the
Partner Extranet.
integration dimensions (excluding gasket)
mounting aperture: 110 * 146 (height/width)
clearance: min. 88 (depth)
28 unrestricted
last updated 6/6/16 document release 0.1 im_vln_techSpecs.fm
Optional accessories
• communications boards
• debug interface
• power adaptor
input100-240 VAC, 50 – 60 Hz; output 12 VDC 2A
unrestricted 29
im_vln_techSpecs.fm document release 0.1 last updated 6/6/16
Environmental conditions
operating temperature/humidity
-20°C to +70°C (for VALINA without display); 0% to 90% RH non-condensing
storage temperature/humidity
-25°C to +70°C; storage humidity: 0% to 95% RH
flammability rating
ANSI/UL 94 V-0
dust-/waterproof rating
IP65
protection classification
vandal-proof class IK08
Software
• Android and Linux® OS
• Linux-based development kit (C and Java™)
• secured remote download of software (RTL server)
Appendix B. Approvals
Worldline declares that the VALINA complies with Radio and Telecommunications
Terminal Equipment directive 1999/5/EC, based on test results referencing
harmonised standards. The declaration of conformity (DoC) can be consulted on the
partner extranet or on the terminal website:
• terminals.worldline.com, under Technology and Innovation
• internationalpartners.extranet.worldline.com
The product is designed for operation in commercial or residential structures that have
electrical installations in compliance with local and regional codes for office and
residential electrical wiring, such as International Electrotechnical Commission (IEC) 364
parts 1 through 7.
The VALINA has been approved/certified in line with international standards including:
Approvals/certification
• PCI PTS 4.x (SRED and Open Protocols)
• MasterCard TQM
• EMVCo Level 1 contact V4.3
• EMVCo Contactless V2.5
• CE directives 1995/5/CE, 2004/108/CE, 2006/95/CE
• Environmental directives Reach, RoHS 2, WEEE
• FCC
unrestricted 31
im_vln_approvals.fm document release 0.1 last updated 6/6/16
ESD immunity
Safety
• EN301 489
– Part 1: Common technical requirements
– Part 17: Specific conditions for 2.4 GHz wideband transmission systems and 5
GHz high performance WLAN equipment
• EN300 328 Electromagnetic compatibility and radio spectrum matters (ERM)
Wideband transmission systems
32 unrestricted
last updated 6/6/16 document release 0.1 im_vln_approvals.fm