19
VX680 User Manual Date: 07/11/17 Version 1.0.0 Copyright © Adyen B.V. 2017 Simon Carmiggeltstraat 6 - 50 1011 DJ Amsterdam The Netherlands www.adyen.com

VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

  • Upload
    lamnhi

  • View
    227

  • Download
    0

Embed Size (px)

Citation preview

Page 1: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential11

VX680 User Manual

Date: 07/11/17

Version 1.0.0Copyright © Adyen B.V. 2017Simon Carmiggeltstraat 6 - 501011 DJ AmsterdamThe Netherlands

www.adyen.com

Page 2: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Table of Contents

1 Legacy instructions for firmware version 11 - VX680 4

2 Prerequisites - VX680 4

2.1 Provided components 5

2.2 Steps 5

2.3 Steps 5

2.4 Turn on and turn off the VX680 6

2.4.1 Turn on the VX680 6

2.4.2 Turn off the VX680 6

2.5 Steps 6

2.6 Steps 7

3 Board the terminal - VX680 7

3.1 Before you begin 7

3.2 Steps 7

3.2.1 Board with the Adyen POS App 7

3.2.2 Board with the Adyen Customer Area 8

3.2.3 Board the terminal with the Adyen Platform in standalone mode 9

3.2.4 Board the terminal with custom integrations 9

4 Basic functionality - VX680 9

4.1 EMV (chip) transaction 9

4.1.1 Steps 9

4.2 Magnetic stripe transaction 10

4.2.1 Steps 10

4.3 Shift and end-of-day reports 10

4.3.1 Steps 10

4.4 Refund 11

4.4.1 Perform a refund 11

Page 3: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

5 Use the Installer framework - VX680 11

5.1 Open the Installer menu 11

5.1.1 Steps 11

5.2 View, install and update releases 11

5.2.1 Steps 11

5.3 Delete packages and releases 12

5.3.1 Steps 12

6 Make special payments - VX680 12

6.1 Steps 12

7 Maintenance - VX680 13

7.1 Inspect device security - VX680 13

7.1.1 Steps 13

7.2 Replace paper rolls 13

7.2.1 Steps 13

8 Use the admin menu - VX680 15

8.1 Steps 15

8.2 Admin menu functions - VX680 15

8.2.1 Main menu 15

8.2.2 1. Network menu 15

8.2.3 2. Installer menu 16

8.2.4 3. Merchant menu 17

8.2.5 4. Totals menu 18

8.2.6 5. Transactions 18

9 VX680 WF/BT technical specifications 19

10 Troubleshooting and support VX680 19

10.1 In case of a malfunction 19

10.2 Request assistance 19

Page 4: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential4

Here we describe how to set up, configure and use the Wi-Fi payment device as a stand-alone payment VX680device.

VX680

If the terminal shows an exclamation at the top bar, this means that the terminal holds data that it failed to synchronise with the Adyen platform due to lack of an outgoing internet connection.

Legacy instructions for firmware version 11 - VX680

To download the PDF instructions VX680 firmware v. 11, click .here

Prerequisites - VX680

VX680 Supported payment cards

Page 5: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential5

1.

2.

3.

4.

5.

6.

7.

1.

2.

3.

VX680 Supported payment cards

Visa

VPay

Mastercard

Maestro

American Express

Discover

Diners club international

UnionPay

JCB

Provided componentsVX680 PED

Charging cradle

Power supply

Battery

1 paper roll

Steps

Lift the printer cover latch to open it, and then lift the cover.

Remove any partial roll of paper in the printer tray.

Loosen the glued leading edge of the paper or remove the protective strip from the new roll of paper.

Unwind the paper roll past the glue residue.

Hold the roll so that the paper feeds from the bottom of the roll when the terminal is inverted.

Drop the paper roll into the printer tray and close the latch.

Close the cover and tear off any excess paper.

Steps

Connect the charging cradle to the power supply cable, and then the power supply to the electrical grid.

Place the VX680 terminal on the cradle to charge the device and to power it on.

To fully charge the VX680, place it on the cradle for at least 6 hours, until the led indicator remains lit.

Page 6: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential6

1.

2.

1.

2.

3.

4.

5.

6.

7.

8.

Turn on and turn off the VX680

Turn on the VX680

Steps

Press and hold for a couple of seconds.

When the device is fully booted, it displays the Adyen logo or the merchant logo, in case you provided us with a logo and we have already registered the terminal to your account.

Turn off the VX680

Steps

Press and hold . The device will beep repeatedly and then power down.

Steps

Ensure the VX680 is fully chargedTo fully charge the Terminal, leave plugged into the powered USB cable until the LED indicator remains lit.

Press + .9

Enter the admin PIN code to unlock the device.

No admin PIN code is required if the terminal is not yet boarded.

If you do not know the code, contact the to obtain the specific admin PIN code for POS Support Teamyour device.

Scroll through menus using the and buttons for scrolling up and down respectively.* #

Press . 1.Network

Press .2. Wifi

Press 2. Networks

Press to scan for a network or to manually add a network.1. Scan 2. Add

When scanning, the terminal displays the message "Scanning network", while it looks for a network.

Page 7: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential7

9.

10.

11.

1.

2.

3.

4.

5.

6.

1.

2.

Choose the desired network and enter the wireless password. The terminal will connect to the network.

The terminal sets the network as default automatically, and connects to it.

Exit the network menu to begin boarding the device.

StepsUse the quick info menu to quickly view terminal information:

Press and at the same time.5

The quick info menu opens and displays the:

IP address

Terminal ID

Software version

QR code with an encoded IP, MAC address, Network name, Store name, Merchant Account and Terminal ID.

Board the terminal - VX680

Before you beginEnsure the VX680 fully charged. To fully charge the terminal, leave plugged into the powered USB cable until the led indicator remains lit.

Board the terminal only after successfully following the steps in .Prerequisites - VX680

Steps

Board with the Adyen POS App

Press + to open the admin menu.9

Enter the admin PIN code (If you don't know this code, contact the POS Support Team ). The terminal displays the admin menu.

Press .1. Network

Press .2. Wifi

Press . to view and make a note of the terminal's IP address.3 TCP/IP settings

Download and install the . or the iTunes Google Play Store

Board with an Android device

Open the Adyen POS App.

Enter your account details. These were provided in the registration email of your merchant account. If you do not have these, please email the .POS Support Team

Page 8: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential8

3.

4.

5.

6.

7.

8.

9.

1.

2.

3.

4.

5.

6.

7.

8.

9.

1.

2.

3.

4.

5.

6.

7.

8.

Tap .

Tap Payment device.

The app will prompt to select between Bluetooth and WiFi connection.

Enter the IP address of your terminal and tap Add Device.

The Adyen POS App identifies the terminal, synchronizes with the Adyen platform, and verifies the terminal configuration.

The terminal restarts.

Upon restart, the terminal is boarded and ready to use.

Board with an iOS device

Open the Adyen POS App on the mobile device.

Tap the icon.

Tap the ' at the top of the popup menu.+' Payment device

Enter the device hostname or IP.

The device will now be listed in the menu with the status "Not Boarded".Payment device

Tap the name of the device. The device displays a message saying the device is not configured, with options to or .Cancel Board device

Tap .Board Device

The terminal begins boarding and restarts.

Upon restart, the terminal is boarded and ready to be used.

Board with the Adyen Customer Area

Log in to the with your credentials.Customer Area

Open the menu.Point-of-Sale

Search your terminal serial number in the .Terminal Fleet Manager

Go to the page.Terminal Detail

Assign the terminal to a merchant account by selecting a merchant code from the dropdown menu.

Select a webservice user and assign the terminal.

Enter the one-time password from the terminal detail page on the terminal to board the terminal.

After rebooting, the terminal will receive the merchant configuration, and you can begin processing payments.

Page 9: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential9

1.

2.

3.

4.

5.

Board the terminal with the Adyen Platform in standalone mode

Board the terminal using the Adyen POS App once to register it to our Adyen platform and configure it for standalone mode. From there you can continue to use the terminal in standalone mode, without the use of the Adyen POS App or our integrations.

Board the terminal with custom integrations

our , To board the terminal with your own custom systems, review Java Native Interface Integration COM , and guides. For mobile POS applications, see our Extension for Windows integration C Library Integration

. For integration support, contact the .Android guide POS Support Team

See for information on processing payments.Basic Functionality - VX680

Basic functionality - VX680

If the terminal shows an exclamation at the top bar, this means that the terminal holds data that it failed to synchronise with the Adyen platform due to lack of an outgoing internet connection.

EMV (chip) transaction

Steps

Initiate a transaction via your app.

If the terminal is in standalone mode, use the select key in the middle of the directional pad to

select on the screen. Enter the amount and then press .Start

When the terminal is ready, insert the chip card into the terminal and allow it to read the card.

When prompted, the customer enters a PIN on the terminal and presses .

For CHIP & Sign, a signature prompt occurs instead of a PIN prompt. Compare (i) the name and (ii) the signature on the card with the shopper’s ID. If they match, you can (1 additional approvereceipt is printed) or (2 additional receipts are printed) the transaction on the device.decline

Do NOT remove the card until prompted to do so or the transaction will be void.

After the authorization is approved, the terminal displays and the card may be removed.Approved

Page 10: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential10

5.

a.

b.

1.

2.

3.

4.

5.

a.

b.

1.

2.

3.

4.

5.

After each transaction, at least 2 receipts are printed:

A merchant receipt

A shopper receipt

Magnetic stripe transaction

Steps

Initiate a transaction via your App or Cash Register.

If the terminal is in standalone mode, press on the screen, enter the amount and then Start

press the key.

After the terminal is ready, swipe the magnetic stripe card through the reader on the right side of the terminal.

Sign the transaction.

After authorization approval, message appears on the terminal signifying that the transaction Approvedis complete.

After each transaction, at least 2 receipts are printed:

A merchant receipt, and

A shopper receipt.

Shift and end-of-day reports

Steps

The terminal can print a summary with an overview of the total amounts processed since the last reset.

If you want to print a summary report periodically, reset the counters after printing the report.

To print the day totals, do the following:

Press + 9.

Enter the admin PIN code.

Press .4. Totals

Press to print the day totals.1. Print totals

After printing the day totals, press to reset the counter.2. Reset totals

If you do not have your admin PIN code, email [email protected]

Page 11: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential11

1.

2.

3.

1.

2.

1.

Refund

A shopper may decide to return previously purchased goods, and you might want to start a transaction refundto pay back the corresponding amount to the shopper’s card.For security reasons, Adyen enables refund functionality on a per-device basis. Moreover, you need to enter a password to perform a refund.

Perform a refund

To perform a refund, do the following:

Press + 8.

Enter the admin PIN code.

Enter the amount to refund, then proceed like in a normal transaction.

If you do not have your admin PIN code, email [email protected]

Use the Installer framework - VX680

The new Installer Framework allows you to download and install firmware packages directly from the Adyen platform. The Installer runs at midnight and fetches updates to your PED's firmware.

Use the new Installer to view releases that are ready to install and view the packages to be installed. You can retrieve and install the configured release on the Adyen platform, run the installer immediately (rather than at midnight), and delete packages and releases.

The installer framework is available from firmware v. 14.

Open the Installer menu

Steps

Press to open the admin menu. + 9

Press to open the Installer menu.2. Installer

View, install and update releases

Steps

From the Installer menu,

Page 12: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential12

1.

2.

3.

4.

1.

2.

3.

1.

2.

3.

a.

b.

i.

Press to view the latest available release.1. View ReleaseThis will show which packages the Installer will try to install when it runs.

Press to view packages installed.2. View PackagesThis will show the packages installed and the status of each. For example, download errors per package can be viewed here.

Press to download the file containing latest release information.3. Update release.json release.jsonThis will retrieve and install the release we have configured for you on the Adyen platform.

Press . to run the Installer immediately, rather than waiting until midnight. On restart, 4 Run Installerthe device begins installing from the Installer framework.

The PED will restart multiple times while it downloads and configures updated system files.

Delete packages and releases

Steps

Press . This will delete all packages installed so all packages will be re-installed on 5. Delete packagesthe next run.

Press . This will delete all packages installed so all packages will be re-installed 6. Delete single packageon the next run.

Press to delete the release. 7. Delete release This will remove the release pushed from the Customer but will keep the terminal registered to your merchant account.Area and install a firmware default

Make special payments - VX680

The special payment functions menu allows access to custom or ad-hoc payment options. Available entries in the menu may vary, depending on your merchant configuration.

StepsTo enter the special payment functions menu, do the following:

Press + .8

Enter the PIN code to unlock the device. If you do not know the code, contact the to obtain the specific PIN code for your device.

Review one or more of the following payment options, which are available depending on your configuration:

Normal payment - Choose this option to access the payment screen, where you can enter an amount.

Choose this option to access the payment screen. - Manual entry payment

Page 13: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential13

3.

b.

i.

ii.

1.

After entering an amount, press .

You are prompted to input the , and then the card expiry date.PAN

The transaction then follows the normal flow.

The special payment functions menu also includes the option to refund a payment. For more information, see .Basic functionality - VX680

Maintenance - VX680

Inspect device security - VX680

Adyen makes use of secure, certified payment terminals. The integrity of these devices is crucial, as they process sensitive card data.

Steps

Please make sure you and your store staff do the following:

Verify your device looks like the pictures in this manual.

The Adyen logo or your company logo should show up after powering on the terminal.

Do not use the device if it is damaged or covered with a sticker.

Verify the identity of any third-party persons claiming to be repair or maintenance personnel, prior to granting them access to modify or troubleshoot devices.

Do not install, replace, or return devices without verification.

Be aware of suspicious behaviour around devices (for example, attempts by unknown persons to unplug or open devices).

Report suspicious behaviour and indications of device tampering or substitution to appropriate personnel (for example, to a manager or security officer).

Replace paper rollsThe VX680 uses the following receipt paper:

57 mm x 35 mm x 12 mm thermal receipt paper

It is important you have sufficient stock of receipt paper, as without receipt paper it is not possible to accept payments. Replacing paper is the your responsibility (Adyen does not sell paper).

Steps

Gently pull the latch located on the bottom of the terminal to unlock the paper roll cover.

Page 14: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential14

1.

2.

3.

4.

5.

6.

7.

8.

9.

Lift the printer cover up and then back.

Remove any partial roll of paper in the printer tray by lifting it up.

Loosen the glued leading edge of the paper or remove the protective strip from the new roll of paper.

Unwind the paper roll past any glue residue.

Hold the roll so that the paper feeds from the bottom of the roll when the terminal is inverted.

Drop the paper roll into the printer tray.

Pull the paper up past the glue residue on the paper roll.

Close the paper roll cover by gently pressing directly on the cover until it clicks shut. Allow a small amount of paper past the glue residue to extend outside of the printer cover.

Page 15: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential15

1.

2.

Use the admin menu - VX680

Steps

To enter the terminal admin menu, press + 9.

Enter the admin PIN code (If you don't know this code, contact the POS Support Team ). The terminal displays the admin menu.

Admin menu functions - VX680

Main menu

Menu Option Description

1. Totals Print and reset totals.

2. Network View connection status, scan for networks and perform diagnostics.

3. Installer Download and install firmware packages directly from the Adyen platform. The Installer runs at midnight and fetches updates to your PED's firmware.

4. Merchant Make maintenance calls, download, view and erase configurations.

5. Restart Restart the terminal software.

6. Reboot Turn off/Shut down the terminal.

1. Network menu

Menu option Description

1. Connection Status

View the name and connection status of the network connection.

2. Ethernet List ethernet network settings, such as IP address, gateway, netmask, DNS and MAC address.

2. Wifi View TCP/IP settings, WiFi settings, reset and reload WiFi connections.

1. Wifi Switch to turn on or off WiFi.

2. Networks Scan for networks and add networks manually.

Page 16: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential16

Menu option Description

3. TCP/IP Settings

View IP address, MAC address as well as DHCP, gateway, netmask and DNS settings.

4. Wifi reset Erase the WiFi settings and reboot the terminal

5. Reload Wifi

Reload the WiFi profile configured on the backend.

3. Bluetooth View Bluetooth settings, scan and pair bluetooth devices, and set the terminal as discoverable to other devices. (VX690 only)

1. Bluetooth Switch that allows you to turn on or off Bluetooth.

2. TCP/IP Settings

View IP address, MAC address as well as DHCP, gateway, netmask and DNS settings.

3. Base station

Pair the terminal with a bluetooth base station.

4. Scan/Discovery

Scan for bluetooth devices or set the terminal as discoverable to bluetooth devices.

4. GPRS View terminal GPRS settings for a connection to a mobile network.

1. TCP/IP Settings

View IP address, MAC address as well as DHCP, gateway, netmask and DNS settings.

2. GPRS settings

View GPRS settings such as operator, Network, IMEI, signal, RSSI etc.

5. Diagnostics

Perform diagnostic tests to test connection.

1. Ping Ping a specific host with a specified packet length.

2. Test PSP connection

Perform a test to check connection to the PSP.

2. Installer menu

Menu Option Description

1. View Release (Only available on standalone terminals)

Page 17: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential17

Menu Option Description

Generate a receipt showing the total processed amount per currency per card type.

2. View Packages (Only available on standalone terminals)

Reset the counter.total amounts processed Do not forget to reset totals after your shift.

3. Update release Download the release.json file containing latest release information. This will retrieve and install the release we have configured for you on the Adyen platform.

4. Run Installer Run the installer immediately, rather than waiting until midnight. On restart, the device begins installing from the installer framework.

5. Delete packages Delete all packages installed so all packages will be re-installed on the next run.

6. Delete single package

Delete a single package installed so it will be re-installed on the next run. Use delete single package if there is an issue with the package that requires reinstallation.

6. Delete release Remove the release pushed from the Customer Area and install a firmware default but will keep the terminal registered to your merchant account.

3. Merchant menu

Menu option Description

1. Maintenance call

Make a maintenance call to invoke terminal actions configured on the backend.

3. Download configuration

Download a new merchant configuration. Do not execute this command unless instructed to do so by Adyen Support.

3. View configuration

Show the following information:

Firmware version the terminal is running

Merchant account the terminal is registered to

Additional details.

1. View settings

View settings such as configuration version, IPP keys loaded, PAL URL, Sync URL, Config URL, Firmware URL, transaction amounts, printing settings, Timezone, MKE settings, Bypass PIN, Magstripe, ICC, MSR, CTLS Signature and CDA mode.

2. View firmware

Page 18: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential18

Menu option Description

View version information, such as Bootstrap version, Application version, External printer settings, OS version, EOS version, Contact kernel version, Cardslot version, VSS version, CTLS modules installed.

3. View hardware

View Terminal ID, Serial port, internal printer settings, and CIB version.

4. Erase configuration

Erase the configuration from the terminal.

This requires re-boarding the terminal to your merchant account)

4. Totals menu

Menu Option Description

1. Print totals (Only available on standalone terminals)

Generate a receipt showing the total processed amount per currency per card type.

2. Reset totals (Only available on standalone terminals)

Reset the counter.total amounts processed Do not forget to reset totals after your shift.

5. Transactions

View a list of all transactions

Page 19: VX680 User Manual - Adyen developer documentationUser+Manual-v4-20171107_1539.pdf · VX680 User Manual Date: 07/11/17 ... Scroll through menus using the * and # buttons for scrolling

Page | © 2017 Adyen BV | Confidential19

VX680 WF/BT technical specifications

Processor 400 MHz, ARM11 32-bit RISC processor Power battery Li-Ion 7.2 V/1800 mAH

Memory 192 MB (128 MB Flash, 64 MB SDRAM) Environmental 0 ° to 50 C (32 to 122 F) ° ° ° operating temperature,-20 ° to 60 ° C (-4 ° to 140 ° F) storing temperature,5% to 90% relative humidity, non-condensing

Display 3.5" color QVGA, resistive touch screen Physical 72 mm L x 82 mm W x 62 mm H

Printer 18 lps, 38 mm paper roll Terminal 481 g; full shipping: 1,214 g

Card readers

Triple track MSR, landed smart card contactless ISO14443A&B, MiFare, ISO18092 capable, EMVCo L1 certification,supports major NFC/contactless schemes

Wi-Fi 802.11b/g/n

Peripheral Single multi-port connector supports RS-232, USB Host, USBslave and integrated charging

Other standard

Features 3 SAM slots, audio/video player

Troubleshooting and support VX680

In case of a malfunctionCheck our for articles that may help you find a solution for the issue.troubleshooting section

Request assistanceContact the .POS Support Team

Provide the following information:

Merchant account

PSP reference (if applicable)

Terminal serial number