top up manual

8/6/2019 Top Up Manual

1/19

T O P U P V E N D I N G S Y S T E M O V E R V I E W

Page 1

Top Up Vending Overview

WHAT IS TOP UP VENDING?

Top up is a facility for adding pre-paid minutes directly to a customers cell phone account. It is veryconvenient for the user because no complicated dialing sequences or PIN numbers are required tocomplete the transaction.

The Top Up Vending system from Technik Manufacturing enables the customer to purchase top upminutes from a self-service vending machine. The machine provides a way for the customer to select thecell phone company, number of minutes, and the cell phone account to receive the minutes. The machineaccepts cash in payment for the sale.

HOW DOES IT WORK?

The vending machine uses the Internet to communicate with a central host system. The host records thedetails of each request and translates it into the format required by the selected cell phone company. Thehost communicates with the server at the cell company to perform the actual purchase. The host thenreturns the results of the transaction to the vending machine.

Although each airtime seller may use a different transaction protocol, communications between thevending machines and the host use a common protocol regardless of which companys product is to bepurchased. By connecting with the appropriate port on the host the vending transaction will be translatedand routed to the appropriate company.

There are two transactions performed by the vending machine for each purchase: Check and Buy.

TheCheck transaction is used to make sure that the purchase can be completed before money is acceptedfrom the customer. The product and price to be purchased and the telephone number to be topped upare sent to the host. The host verifies that the telephone number is valid and that the requested product isavailable.

The Buy transaction performs the actual purchase. A reference to a successful Check transaction ispassed to the host. If the reference is valid the host contacts the phone company server to transfer thetime to the customers account.

HOST COMPUTER RECOMENDATIONS

Operating System Microsoft Windows 7 ProfessionalProcessor Multi-core (4 recommended) Low wattageMemory 4GBDisk storage (2) Western Digital Black 640GBDisplay resolution At least 1280 horizontal. More is better.Ethernet port 1 or more depending on network configurationDatabase software Microsoft SQL Server or SQL Server Express (may reside on a local server)


2/19


Page 2

The Top Up Vending Machine

BUYING MINUTES FROM THE VENDING MACHINE

Purchasing cell phone time is quick and easy. On screen prompts guide the customer through threesimple steps.

1. Select product. Press the button next to the carrier and number of minutes to be purchased.

2. Enter phone number. The phone number is entered twice using the numeric keypad.

3. Insert Cash. The phone number and product have been checked and are valid. Inserting thecorrect amount of money into the bill acceptor completes the sale. Minutes are automaticallyadded to the cell phone account.

A sales receipt is printed. It shows:

The machine location.

Sale date and time.The product name.The product price.The phone number.The transaction reference number.Other relevant information.

If there are questions about the sale, the transaction number can be used to trace the sale through the host.


3/19


Page 3

USING SERVICE MODE

The vending machine has two operating modes: Vend mode and Service mode. These modes are selectedby the position of the key switch on the lower right side of the machine. Turn the key switch clockwise toenter Service mode. Be sure to return the switch to the counter-clockwise position (Vend Mode) whenfinished.

Service mode can be used to perform several functions using the display and numeric keypad. Thesefunctions include printing reports, testing the bill acceptor and keypad, and viewing or changing mostmachine settings.

Some settings such as the product setup cannot be changed using the keypad. To access all machinesettings use theBrowser Interface.

When the key is t urned to the Service m ode posit ion the f irst screen that appears is:

Press the 1 key t o display the log in screen.

Enter the four-digit passcode and press enter. The main menu is displayed.

Each of these four options will be described below.

1) Service

This procedure is used to produce documentation and reset accounting when collecting money from themachine. When 1 is pressed a sales report will print for reconciling the amount of cash collected and thefollowing screen will display:


4/19


Page 4

Selecting OK resets all period counters to zero and prints a before and after sales report.

2) Reports

Press 1 to print the current sales report.


5/19


Page 5

3) Tests

The bill acceptor can be tested without adding credits to the machine or affecting the accountinginformation. The value of the bills is displayed as they are inserted.

The keypad test can used to check that the buttons are working correctly. Keys pressed on the keypad willbe shown on the display. The X key returns to the Tests menu.

4) Setup

Setup > Communications

When Communications is selected the following screen is displayed. The first line is the machines IPaddress on the local network. Enter this address in to a web browsers address bar to access the machinesbrowser interface.

Setup > Communications > Local Network

Option 1 toggles between DHCP and static addressing on the local network. In DHCP mode, themachines local network settings are retrieved automatically from a server on the network. A router orfirewall typically performs DHCP server functions.

In static mode, all network parameters must be explicitly set using option 2.


6/19


Page 6

Setup > Communications > Host Settings

This menu selection displays a sequence of three screens for setting the host IP address, TCP port and callinterval.

Setup > Communications > Host Settings

This number is used to identify the vending machine to the host. It must be unique.


7/19


Page 7

THE BROWSER INTERFACE

The Top Up vending machine provides a web interface that allows setting machine parameters using aweb browser such as Internet Explorer. This is the preferred method of setting up the machine sincemany important parameters can only be accessed in this way.

Connecting to the browser interface

The browser interface can be accessed by typing the IP address (or URL if one is assigned) into theaddress bar of a web browser. For a new installation the machine may be assigned a fixed IP address orthe address can be obtained from a DHCP server. If a fixed address is not assigned and there is noDHCP server available, the machine will revert to the default address 10.111.110.11. The machines IPaddress can be viewed on the LCD display by accessing the Service Mode menu: Setup/ Communications.For more information on the operator menus functions refer to the Using Service Mode section of thismanual.

Browser interface pages

Home

The home page displays the machines ID number and location name as well as the current date and time.Links are provided for navigation to the other pages.


8/19


Page 8

LocationInformation

The Location page allows the Unit ID and location name to be set.

The unit ID is a unique six-digit number that the host uses to identify a machine at a particular location. If

a machine needs to be replaced the new machines ID should be set to the number used in the oldmachine. This will maintain continuity in host sales reporting.

The location name appears on reports, receipts, and log information at the host. Each machine shouldhave a unique location name.


9/19


Page 9

Date & Time PageThis page allows the machines clock to be set and the date display format to be selected. If Synchronizewith server clock is selected, the machines time and date will be adjusted based on the hosts clock. Thesynchronization will occur the next time the machine contacts the host and each time thereafter. TheTime zone correction field is used to set the machines time to an offset from UTC.


10/19


Page 10

Network Settings

Select local network settings.


11/19


Page 11

Host Settings

The address of the host computer can be set here. The host port and polling interval are used to accessthe administrative host channel. The default administrative host port is 7200. The polling interval setshow often the machine will report to the administrative host.


12/19


Page 12

Vendor Settings

A different program at the host services each airtime vendor. In order to connect to the correct hostprogram the machine needs to know the port number that each one listens to. Enter the name and portnumber for each vendor. The name will appear on the display, sales receipt, and sales report.


13/19


Page 13

Assign Buttons

This Page maps products and prices to the buttons on the front of the machine. First select a vendor foreach button from the drop down lists and click Save Changes. Next enter the price and description foreach product. The description does not need to contain the vendor name as they are retrieved from thevendor list. The number of minutes might be a good choice.


14/19


Page 14

Top up Host Software

THE T OP UP HOST SYSTEM

Each cell phone carrier uses a different protocol for processing top up transactions. Instead of trying tosupport all the various protocols directly by the vending machine, a host computer is used as a proxyserver to translate and route requests from the machines to the appropriate companys server.

In addition to allowing standardized access by the vending machines, the host maintains records of alltransactions. This provides centralized audit capabilities and aggregation of sales across all machinesserviced by the host.

A separate program runs on the host for each supported phone company. Requests from the vendingmachine are routed to the correct program by using a TCP port number assigned to that program. Eachprogram listens for messages sent to that port on the host machines IP address.

For the host system to be able to receive messages from the Internet, a fixed public IP address is needed.There are several ways that the host computer can be accessed from the Internet using the public IP

address. The simplest but perhaps least secure is to directly expose the hosts Ethernet port by assigning itthat address and connecting to the Internet gateway in pass through mode. Another would be to assignthe address to a hardware firewall or router and use the devices port forwarding feature to routeconnections for the assigned ports to the hosts address on the local network. The Internet ServiceProvider can provide help with this.

Several levels of protection are in place to insure communication over the public Internet remain secure.All packets are encrypted using a rolling salt algorithm and each connection is authenticated using arandom challenge/ response exchange to verify that a valid machine initiated the connection. Eachtransaction is assigned a unique reference number by the host to prevent man in the middle replayattacks.

Connections between the host and the carriers servers will be established as required by the carrier.Typically this will be done over a VPN connection.


15/19


Page 15

THE H OST PROXY PROGRAMS

Each phone companys top up server is represented on the host system by a host proxy program. Theseprograms perform the following functions.

Accept requests from the vending machines.

Translate request into the format required by the specific phone company.

Connect with the phone companys server to perform the requested transaction.

Transmit the transaction result to the vending machine.

These programs can service requests from many vending machines at once. The maximum number ofsimultaneous requests that each will accept can be configured by the user.

Although the work performed by each host proxy varies based on the phone company it services, for theuser each program looks and operates identically.

Hardware lock. Each vending machine is assigned an unique six digit identif ication number. The hostkeeps a record of which physical machine is using each ID number. If the host detects that a differentmachine is trying to use a previously assigned ID number, its request will be rejected. If a machine or amachines computer needs to be replaced, this security check can be temporarily overridden.

Once the new machine successfully connects, the lock can be turned back on. The new machine will bethe new owner if the ID number.


16/19


Page 16

There are two types of requests that are serviced by the host proxy programs Check and Buy.

Check

This transaction is sent by the vending machine before accepting money from the customer. Itconfirms that the telephone number and product selection are valid. Ideally a successful Checkshould guarantee that a subsequent Buy request would be honored. The degree to which this is

true depends on how well the phone company supports this function.

Buy

This transaction performs the actual transfer of minutes into the customers account. A Checktransaction is required before a Buy request will be accepted.

Closing a host proxy program. When exiting a host proxy the following window may display:

If there are recent Check transactions that have not yet had a matching Buy request the host proxy willdelay shutting down for five minutes to allow those purchases to complete. New Check requests will notbe accepted during this time. Clicking the Force Shutdown button will cause the program to exitimmediately.

CLARO NU MBERS UPDATE PROGRAM

The Claro top up service provides no support for the Check function. In order to achieve a minimaldegree of safety for Claro purchases, the Claro host proxy does a local lookup to see if the phone numberis a valid Claro number.

In order to do this a database of Claro phone numbersis maintained on the host system. This database needsto be updated periodically to keep it as accurate aspossible.

The database is built and updated with the ClaroNumbers Update program. The program reads a textfile supplied by Claro and stores the numbers in the fileto the database.

The process of building the database takes less than aminute. During this time some Claro checktransactions may be rejected.


17/19


Page 17

THE H OST SETUP PROGRAMS

Each Host proxy program needs some basic information in order to function. The basic information is:

The IP address and port number to connect to on the phone companys server (host network).

The port number for accepting connections from the vending machines (local network).

The starting number of threads and the thread limit.

A word about threads: Each thread is a separate process that runs independently. It listens for aconnection from a vending machine and services the machines request. Each thread can only handle onemachine at a time. The starting number of threads is the number of listeners that will be running whenthe host proxy is first started. Whenever all running listeners are busy an additional thread will be startedunless the thread limit has been reached. The thread limit is the maximum number of machines that canbe handled by a given proxy at once. It should be set to value large enough to handle the maximumreasonable number of simultaneous requests (a typical request takes about 15 seconds to complete). Itshould not be set to high to limit the effect of denial of service attacks.

In addition to these basic settings, each phone company will have values that must be set in order toaccess their system.

These values are set using the host setup programs.


18/19


Page 18

THE LOG EXPLORER PROGRAM

A detailed record of all system activity is recorded. This record can be accessed to identify problems or toverify the results of a specific transaction.

Clicking the heading of any column will sort the list by that column. A specific transaction can besearched for by entering all or part of the time, reference number or phone number into the search box.

Double clicking on any transaction will display all the details of that transaction.


19/19


P 19

THE SALES REPORT PROGRAM

The SalesReport program provides versatile reporting of sales. The report can be organized either bymachine or by product. The time period that the report covers can be set to any range of dates. Reportoutput can be directed to the screen, a printer, or exported to an Excel spreadsheet or PDF file.

top up manual

Documents