8/9/2019 Point v3403

1/14

8/9/2019 Point v3403

2/14

Content

1. How to Contact Point ...................................................... ................................................................. ............................. 32. Basic Information ............................................................ ................................................................. ............................. 3

3. How is Certification Handled? ..................................................................................................................................... 3

4. Description of Best Practice ........................................................................................................................................ 4

5. Configuration of the Test Terminal ................................................................ .............................................................. 4

5.1. Special Function Configuration ........................................................................ ................................................... 4

6. Connect a Terminal to ECR ....................................................... ................................................................. .................. 4

7. How to Connect the Terminal ............................................................... ................................................................. ....... 5

7.1. Ethernet Demands .............................................................. ................................................................. .................. 5

7.2. Ethernet - How the Terminal can obtain an IP Address ..................................................................................... 6

7.3. Ethernet Network Required Addresses/Names ................................................................ ............................... 6

7.4. IP and Ports used during Certification ...................................................................................................... .......... 7

7.5. Change of Host/Port PBS IFS/FTD during Certification ........................................................ ............................. 7

8. What is needed to make a Test Transaction ............................................................ ................................................... 7

9. Demo Programs in C-sharp ....................................................... ................................................................. .................. 8

9.1. Register PointTerminal.ocx in Windows Environment ................................... ................................................... 8

9.2. Important Info about Demo Test Programs ................................................................. ........................................ 8

10. Ingen kvittering No Receipt ......................................................... .............................................................. .......... 8

10.1. Using ADMIN and Teknikpasord ............................................................................................................ .......... 8

11. Important Info about ECR Application ...................................................................................................................... 912. Error Codes - Nice to Know ..................................................... ................................................................. ................ 10

13. Meaning of other Errors ........................................................... ................................................................. ................ 10

14. Systemfejl Errors not listed in OTRS ................................................................. ................................................. 11

15. Handling of Different Transaction Types .......................................................................... ...................................... 11

15.1. PIN Purchase Transactions ................................................................................................ .............................. 11

15.2. Signature Purchase Transactions ......................................................... ........................................................... 11

15.3. Offline Purchase Transactions .............................................................. ........................................................... 11

15.4. Refund Transactions ........................................................ ................................................................. ................ 11

16. Terminal Messages from DK to UK....................................................................................................................... 12

17. Common ECR Problems in Certification ................................................................ ................................................. 13

17.1. Handling of Multipart Receipts .............................................................. ........................................................... 13

17.2. Handling of Receipt Reprint ................................................................................................ ............................. 13

17.3. Reprint of Receipts in a given Period ............................................................. ................................................. 13

17.4. Password Protection of some Admin Functions ................................................................ ............................ 13

17.5. Large Transactions ........................................................................................................................................... 13

17.6. Handling of NO RECEIPT ............................................................ ................................................................. ..... 13

18. Traces in Case of Problems .................................................................................................................................. 14

8/9/2019 Point v3403

3/14

1. How to Contact Point

Questions about interfacing Your Electronic Cash Register (ECR) application and

Points flexterminal, can be send to Points development department at this emailaddress: udvikling@point.dkPoint will answer as fast as possible, normally within 12 working hours. This only meanswe start looking at the task/problem within this timeframe, some tasks/problems takeslonger to solve.Questions about buying terminals and other services must be directed to this emailaddress: salg@point.dkEnd user support of certified solutions in production is handled by Points customersupport, at this email address: kundeservice@point.dk or by phone: +45 44 53 75 00.

2. Basic InformationWhen contacting udvikling@point.dk we need to know the following basic information inorder for us to help you the best way possible:

Problem is found on terminal number.Events leading to the question/problem.How often do you see the problem?Can this problem be reproduced or was it a single event.Was the OCX or DLL used?Version of OCX/DLL, as found under properties.If possible - tracefiles containing the problem, with some before/after data.Time of the problem.

3. How is Certification Handled?

Nets have to approve the results of a test performed with your ECR application andPoints flexterminal before the solution may be used in real life. Point can help with apre-certification before the certification at Nets, pointing out missing functionality in yourapplication to be corrected before Nets certification.

Contact qa@point.dk for pre-certification.Contact certificering@pbs.dk for the final certification.

Read more about certification on Nets homepage.

mailto:Udvikling@point.dkmailto:Salg@point.dkmailto:Kundeservice@point.dkmailto:qa@point.dkmailto:certificering@pbs.dkmailto:certificering@pbs.dkmailto:qa@point.dkmailto:Kundeservice@point.dkmailto:Salg@point.dkmailto:Udvikling@point.dk

8/9/2019 Point v3403

4/14

4. Description of Best Practice

A description of best practice can be found in TRG OTRS v. 3 bog 1.pdf section 9. Bestpractice gives a good introduction to the development project you are going to make.The OTRS can be found on Nets website.

5. Configuration of the Test Terminal

To ensure correct setup on the test terminal, Point need to know the terminal number ofthe terminal you will use during development.

Test terminals have a 99XXXX number. After changes of setup parameters in Points internal database system, data is ready tobe downloaded into the terminal. This download is always initiated from the terminal.

Functions to be used if you have an Operator Unit (OPU):

Menu 4 3 Download parametersMenu 4 4 Download program

You will be asked for a password to be allowed to perform these tasks, its the 4 digit

number You selected upon buying the test terminal.

Your final ECR (Electronic Cash Register) application should also be able to performdownload of parameters, programs etc. Or you might use one of our demo programs toperform the task in the startup phase.

5.1. Special Function Configuration

Some of the more advanced functions in the terminal require a special parameter setup.Likewise the functions must be enabled in the OCX/DLL for correct function.

Some examples:TokenGratuityIP RoutingReceipt typeFee calculationLocal card checkDCC (Direct Currency Conversion)

6. Connect a Terminal to ECR

Points terminals can be connected in two ways to your ECR application.

8/9/2019 Point v3403

5/14

Via RS232o A special serial cable is needed to connect the terminal to the PC running

your ECR application. This cable is delivered with the test terminal, if thecable is missing a new can be ordered at salg@point.dk.

Via Etherneto An ordinary Ethernet cable connected to a hub/switch with Ethernet

connection to the PC running your ECR application.

7. How to Connect the Terminal

Via RS232:

LINE Ethernet connection, for connection to Nets and Point.ECR (Electronic Cash Register), serial cable to PC running Your ECR application.Power.

Via Ethernet:

LINE Ethernet connection, for connection to PBS/Point and PC running your ECRapplication.Power

NB The terminal must be rebooted if you will use the OPU (Operator Unit), afterconnection the OPU. Likewise the terminal must be rebooted after removing the OPUfrom the setup.

Normally OPU is used in a startup phase to operate the terminal, so it s ready with latestparameters/software etc. without the need to have a running ECR application.

7.1. Ethernet Demands

To get the optimal usage of Point flex terminal its network connection should be isolatedfrom surrounding network traffic. The reason for this demand:

Often networks experience broadcast storms and the flex terminals cant cope with theextra dataload.

The terminal has limited processing power and compared with a PC its very limited.

Different network traffic has different demands to decode of incoming packets.

mailto:salg@point.dkmailto:salg@point.dk

8/9/2019 Point v3403

6/14

All packets have to be decoded according to type and first at the appropriate ISOlevel it can be accepted or rejected. The higher the ISO level, the more processingpower has been used.

7.2. Ethernet - How the Terminal can obtain an IP Address

IP addresses for the terminal can be set in different ways:

Default DHCP is used, and the terminal receives its IP address via this method.Point enters a IP address for the terminals Ethernet in Points internal databasesystem, and this data is downloaded to the terminal by a call to download parametersfrom the ECR application or by installing the Operator Unit (OPU) and calling menu 43Using the OPU you have access to menu 6 3 IP addresses

Using menu 6 3 to enable DHCP after entering password use this sequence to allquestions:

0 -> Corr (Slet Yellow button) -> OK (Godkend Green button) to all questions about IPetc.

7.3. Ethernet Network Required Addresses/Names

To connect to Nets (formerly PBS) and Point, the terminal must be able to reach boththrough the network, using DNS-lookup on specific names, and in the same wayspecific ports must be open.

Default DNS-names, IP-address, and port:

pbs1.point-ts.dk Port 19000pbs2.point-ts.dk Port 19000test.point-ts.dk Port 22000test2.point-ts.dk Port 22000

time.point-ts.dk Port 13rtl.point-ts.dk Port 5214param.point-ts.dk Port 24000

Point has developed a test application to verify access to the above DNS-names, and tocheck the ports are available.

The ECR admin function network report makes this test on the terminal.

If OPU connected, you could run menu-7-6 (menu-test-network).

8/9/2019 Point v3403

7/14

Network Address Translation (NAT) is possible; with this setup it is possible to use otheraddresses internally on the network. Addresses must be routed to the correct ones atsome point in your network.

This test doesnt guarantee the terminal will function correctly, the terminals IP interfaceonly accept DNS lookup if data found directly on the DNS configured, PCs IP interfaceuse another algorithm for DNS lookup, including lookup on neighbor DNS servers. Inother cases the PC might be known on a firewall in the network, where the terminal isunknown.

If you experience network problems with the terminal in a network with a firewall, trymoving the terminal to the outside of the firewall, if it works here a network expert mustconfigure your firewall to allow terminal traffic.

7.4. IP and Ports used during Certification

Nets IFS 62.66.241.173 port 25000 PSAM 540Nets FTD 62.66.241.173 port 26000 PSAM 540

Nets uses a white-list for the above mentioned services and your external internetaddress must be known before contact attempts will be answered. Make sure your ownfirewall is open as well.

Contact: certificering@pbs.dk with information of your external internet address, to beput on this white-list.

7.5. Change of Host/Port PBS IFS/FTD during Certification

The terminal must be configured through a param download to use the abovementioned services. A call to kundeservice@point.dk during certification will enable theterminals to use the services after next param download.

8. What is needed to make a Test Transaction

From Nets you must have a development agreement (udviklingsaftale) and buy a testPSAM for your test terminal and some test cards to be used for test transactions.

You can read more about TEST PSAMs and TEST cards on Nets website.

mailto:certificering@pbs.dkmailto:kundeservice@point.dkmailto:kundeservice@point.dkmailto:certificering@pbs.dk

8/9/2019 Point v3403

8/14

9. Demo Programs in C-sharp

Point has developed demo programs showing how to make basic transactions usingour:

PointTerminal.ocx Point Terminal Active X (COM)flxdrv.dll Flex DriverLPP Local Payment Protocol.

Use the code to get ideas on how to implement OCX/DLL or LPP in your ECR solution.

9.1. Register PointTerminal.ocx in Windows Environment

In the folder containing PointTerminal.ocxr egsvr32 c:\FolderContainingOCX\ Pointterminal.ocx

You may have to be administrator on never versions of windows, to get a perfectregistration of the OCX.

9.2. Important Info about Demo Test Programs

Programs are as they are - Point do not give any support - programs are only madeto test/demo basic functions on the terminal. The same apply to the source code, it isas it is- with no support.

Programs have been run with success on Win 7, Vista and Windows XP .

10. Ingen kvittering No Receipt

After a param download to the terminal, some old data might reside in the terminal. Ifyou try to solve this problem using one of our demo programs you get an error 65539

No receipt or Ingen kvittering No Receipt, unable to be unlocked by calling functionUNLOCK_LASTRECEIPT, LAST_RECEIPT. Try to run Administration functions:

Get last receipt from terminal and unlock terminal.

To solve this:

10.1. Using ADMIN and Teknikpasord

1. Reboot terminal.2. Wait for the text ADMIN? In lower right corner of display and within 3 seconds, press

rightmost up-arrow. (Xenta: Right button, of the three just below display)3. Enter teknikpasord 746578. Now a menu is shown below is used for unlocking no

receipt state on a test terminal.

8/9/2019 Point v3403

9/14

4. With arrow in lower left corner, select menu 18 FLERE FUNKTIONER and then 1 LS INGEN KVIT.OP press green button (GODKEND) to approve.

5. After this you must reboot the terminal.NB - Operator Unit (OPU) must NOT be connected during this operation.

11. Important Info about ECR Application

Developers often have administrative rights on the machine used for test anddevelopment. To allow a normal user to use the application as intended, with limitedrights its a good idea to check the application on another PC, with this limited rights orby logging on as an ordinary user.

If you are using the flxdrv.dll its not allowed to rename it. The f lxdrv.dll name is used tolookup the position to place tracefiles and to get the version information for this dll.

If you are using the PointTerminal.ocx its not allowed to rename it.Tracefiles for the OCX are placed in the directory defined by SetConfiguration - printeroptions - param2.PointOcxTraceXXXX.txt contain OCX specific trace informationflxComTrace.txt contain information about the communication between ECR andTerminal.PtFxDrTr@XXXX.txt Low level trace information.

Avoid Virus scanning of files used by the DLL/OCX, if the Virus scanner locks a fileduring a transaction, the transaction might be rejected, take longer or cause other hardto find errors.

Receipt text received by the ECR must be printed without delay.Customer is expected to receive a receipt at specific times in the transaction flow andthis must be printed at once. The flow of the receipt text is:

Saved in the ECR databasePrintECR reply is send to the terminal indicating receipt saved and printed OK or not.

Make sure your application is none blocking. In our demo applications this is done bythreading.

8/9/2019 Point v3403

10/14

12. Error Codes - Nice to Know

If the terminal encounters an error according to the OTRS specification, this error ispassed through to your application.

Point has added some extra codes starting at 0x10000 = 65536.

0x1632 Bitmap error

If this error occur during PSAM installation it indicates, that the PSAM type is wrong. AFTD PSAM is used instead of a KOPI PSAM or the reverse. To correct, either changethe PSAM or request an update of the terminals TLCMDB for the PSAM used. If Netshas service on the KOPI environment this error could be the result as well.

0xFFF2 Handler timeout , on a new terminal the problem might be caused by anincorrect TLCMDB entry. Contact Point with terminal number 99XXXX and let Pointverify, that the setup is correct. In Points terminal DBS, Communiacation must be set toNET.

If communication is set to NET-PBSIFS and must be so, let Nets check the setting ofintegrators public IP with Nets positive list for IFS.

0xFFF3 Handler error, a general error, but during start-up of a new terminal it is

often: PSAM not installed.0xFFF6 Handler insufficient . Terminal cant reach PBS during PSAM installation,check network setup. PSAM must be in slot 2. Make a terminal report using OPU menu5 3 and check the PSAM ADRESSE:, if it say 3 its normally enough to switch power offor 10 seconds and then try menu 5 3 once more, otherwise move the PSAM to anotherslot.

0xFF24 No card present , the PSAM is not installed.

0xFFFF General error. Given this error during PSAM installation indicate the PSAM

type is wrong. A FTD PSAM is used instead of a KOPI PSAM or the reverse. To correct,either change the PSAM or request an update of the terminals TLCMDB for the PSAMused. If PBS has service on the KOPI environment this error could be the result as well.If the PSAM has not been used for a long time, PBS might have closed the PSAM,contact Nets TC-vagten to reopen PSAM.

13. Meaning of other Errors

Points demo programs have a field in which to enter an error code and a button toshow the basic text representation of this error code. It is possible to enter the errorcode in hex or decimal. Demo programs show the error codes from many sources,OTRS, TAPA, flxdrv.dll and PointTerminal.ocx so its up to the user to select the correctone, but even with this limitation it often helps in debugging an application.

8/9/2019 Point v3403

11/14

14. Systemfejl Errors not listed in OTRS

5000 - Money left on terminal5001 - Unable to read batch data5002 - Unable to generate new OTRSLOG_LOGFILE5003 - PBS - rejected an advice5004 - Failed to remove a token from the terminal.

15. Handling of Different Transaction Types

The following paragraphs will describe how to handle different transaction types.

15.1. PIN Purchase Transactions

PIN based transactions can be initiated from either the terminal by inserting/swiping acard, or from the ECR, by sending purchase information to the terminal. If initiated fromthe terminal, the user must enter the PIN code and wait for the amount from the ECR. Ifinitiated from the ECR, the user is requested to insert/swipe a card, enter a PIN codeand press Godkend (OK).

15.2. Signature Purchase Transactions

Signature based transactions can be initiated from either the terminal byinserting/swiping a card, or from the ECR, by sending purchase information to theterminal. After initiating the transaction the user is requested to insert/swipe a card andapprove the amount. This transaction type generates two receipts, unless host rejectsthe transaction or a communication error occurs. In this case only 1 receipt isgenerated. In case of successful host communication and verification, one receipt isgenerated, by the terminal and immediately sent to the ECR. The receipt must beprinted, the user must sign and the operator must verify the signature. The secondreceipt is then generated based on the operators decision (signatureaccepted/rejected).

15.3. Offline Purchase Transactions

If contact to Nets host system is not possible, some c ard issuers allow an offlinetransaction to be made. Contact Nets in order to get an authorization code, to beentered as part of the start up of the offline transaction. Otherwise an offline transactionmay be handled like signature purchase see above or as an offline pin purchase.

15.4. Refund Transactions

After ECR initiating the transaction the user is requested to insert/swipe a card (if notalready done) and then to approve the amount. This transaction type generates tworeceipts, unless the host rejects the transaction or a communication error occurs. In thiscase only 1 receipt is generated. In case of successful host communication and

8/9/2019 Point v3403

12/14

verification, the two receipts are generated by the terminal and immediately send to theECR. Both receipts must be printed, and the operator must sign the customer receipt.

16. Terminal Messages from DK to UK

Afbryder Disconnecting Afstemning End of day Afventer kort Waiting for card Afventer PIN/Belb Waiting for PIN/Amount Afvist Rejected Arbejder Working

Belb for hjt Amount too highBelb AmountCheck underskrift Check the signatureExtra GratuityForkert pin Wrong pinForretning MerchantGodkendt ApprovedIndls kort Swipe cardIngen kvittering No receiptKan ikke anvendes The card cannot be usedKommunikationsfejl Communication errorKortholder CardholderKort isat korrekt Card inserted correctKvittering udskrives Receipt is being printedKbet er afbrudt The purchase is abortedLukket ClosedModtager ReceivingPrver igen ReconnectingRetur RefundRing PhoneSender Sending

Slet Alt Delete AllSlet DeleteSprret inddrag Blocked card Withdraw cardSystemfejl System errorTast PIN Enter PINTeknisk fejl Technical errorTerminalen er klar The terminal is readyUdfr afstemning nu Make an EndOfDay nowUgyldig valuta Invalid currency codeUkendt kort Unknown cardVent Wait

8/9/2019 Point v3403

13/14

17. Common ECR Problems in Certification

17.1. Handling of Multipart Receipts

Multipart receipt means:Receipt for the merchant to keepReceipt for the customer to keep.Receipt with error code to indicate progress.

An example of this is the signature transaction receipt.

1. A receipt is printed for the customer to sign. For the shop to keep.2. The operator when have to validate the signature and accept or decline thesignature.

3. A second receipt is printed, with the result of the operators decision. For thecustomer to keep.

The refund transaction is another example giving multipart receipts.

17.2. Handling of Receipt Reprint

A copy of a receipt must be marked with a text to indicate it is a copy of an original.

17.3. Reprint of Receipts in a given Period

Reprint of receipts in a given period, either via ECR or BackOffice application must bepossible. This is done to ensure documentation in case of terminal breakdown.

17.4. Password Protection of some Admin Functions

This is to ensure the daily user of the ECR is unable to erase terminal transaction databy accident.

17.5. Large Transactions

During the certification transactions are made with large amounts; ensure that it ispossible to do this on the ECR. Normally 2 transactions are made to give a sum above1.000.000, 00 DKK.

17.6. Handling of NO RECEIPT

If connection is lost to the terminal during a transaction completion, the terminal will gointo the INGEN KVITTERING NO RECEIPT state. The ECR must be able to unlockthis state, for the transaction flow to continue.

8/9/2019 Point v3403

14/14

18. Traces in Case of Problems

Point expects your ECR application to be able to change the tracelevel, withoutrecompilation.

For the PointTerminal OCX, set tracelevel to 4 and verify you can find the

PointOcxTraceXXXX.txt, containing OCX specific trace information And the two files mentioned below

For the FlexDriver DLL, set tracelevel to CONF_EXTTRACE_PLUS and verify you canfind the

flxComTrace.txt containing information about the communication between ECRand Terminal. The LPP developer can use our demo programs to decode andwhereby obtain info, about how specific transaction scenarios look on the LPPlevel.PtFxDrTr@XXXX.txt containing FlexDriver Low level trace information.

If you are using TCP/IP to communicate with the terminal, Point expects you know howto trace/sniff the Ethernet by using HUB/WireShark or similar equipment. The networkused must by stable and without dropouts.

In the ADMIN? menu, see 10.1, you can enable trace ECR TRACE in the terminal,

the trace data is send with the next SEND LOG you make. Observe the trace file haslimited size and trace stop if limit reached. After a SEND LOG the ECR TRACE hasto be enabled again.

Inform udvikling@point.dk with terminal number and time/details about the problem youwant us to investigate , after making the SEND LOG.