Professional Documents
Culture Documents
Document Type
Version
Date
Confidentiality
By
This Document is the property of Point Transaction Systems A/S. It is transferred under the conditions of Active Non-Disclosure.
Use of this document is subject to the terms of this NDA (Non Disclosure Agreement).
This document will be returned under request to Point Transaction Systems A/S.
Content
1 Gavekort Scan Bar Code
1.1 Flex driver (DLL) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.1.1 Callback pcbPutScanBarCode . . . . . . . . . . . . . . . . . . . . . . . . .
1.1.2 Saldo and expire data in callback pcbGetReceipt/pcbGetReceiptVB . . . .
1.1.3 Example binary receipt of prepaid scanned bar code purchase . . . . . . .
1.2 Point Terminal (OCX) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2.1 CallBackType.ScanBarCode EventID 24 . . . . . . . . . . . . . . . . . . .
1.2.2 Another way to put the scanned bar code to the OCX . . . . . . . . . . . .
1.2.3 Saldo and expire date in callback EventID 7: Get extra receipt information .
1.2.4 Example Extendedreceipt callback of prepaid scanned bar code purchase .
1.3 Local Payment Protocol (LPP) . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.3.1 LPP start scanned bar code transaction . . . . . . . . . . . . . . . . . . . .
1.3.2 LPP prepaid scanned bar code to ECR . . . . . . . . . . . . . . . . . . . .
1.3.3 LPP PTAG_RECEIPT now contains PTAG_SALDO and PTAG_EXP_DATE
1.3.4 Example LPP Start of scanned bar code purchase from terminal to ECR .
1.4 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
3
3
3
3
3
5
5
5
5
5
7
7
7
7
7
9
To support prepaid scanned bar code in the terminal Points flexdriver (flxdrv.dll) now have a new
callback to put the scanned bar code to the terminal.
1.1.1
Callback pcbPutScanBarCode
1.1.2
Two fields added to the extra receipt information, with prepaid info
Saldo;ExpireDateYYMM
expire date as digits (first: year (bcd) 00-99, second: month (bcd) 01-12)
The terminal must be configured to convey this information ReceiptType with bit 5 set. This is done
by a param download, after Point has set the terminals configuration in Points terminal database.
1.1.3
BINARY RECEIPT:
1.2
To support prepaid scanned bar code in the terminal Points OCX PointTerminal.ocx now have a
new callback to put the scanned bar code to the terminal.
1.2.1
CallBackType.ScanBarCode EventID 24
1.2.2
1.2.3
Saldo and expire date in callback EventID 7: Get extra receipt information
1.2.4
total
: 6
extra
: 0
fee
: 0
gratuity
: 0
currency
: 208
Stan
: 746
PSAM_Creator
: 2129592318
PSAM_ID
: 103651
Action Code
: 0000
Asw1Asw2
: 0000
CvmStatus
: 8
Authorization Code
: 014B00
Cardname
: GK Gavekort
Terminal Ident
: 00990527
PBS Number
: 1978543
Name
: PBS ()
City
: Ballerup
Address
: testcenter
Zip
: 2750
Phone
: 44892299
CVR
: 123569
refNr
: 123456
Dcc Currrency
: 208
Dcc Rate
: 1.000000
Card CRC
: 46
Batch Number
: 270042
Cancallation Allowed
: 1
Vat
: (null)
Ereceipt
: 128774354
Saldo
: 3292
Cashback from ver 3.5.00 : 0
DCC total from ver 3.5.00: 0
DCC fee from ver 3.5.00 : 0
DCC gratuity from ver 3.5.00: 0
CardDataSource
: 0
AID
:
ATC
: 0
AED
: 000000
ARC
:
ExpDate
: 1712
1.3
To support prepaid scanned bar code in the terminal LPP now have to put the scanned bar code
to the terminal.
1.3.1
TR=0x00
PTAG_PREPAID=0x03
Refund
TR=0x01
PTAG_PREPAID=0x02
Original Auth.
TR=0x02
PTAG_PREPAID=0x01
The terminal must be configured to handle scanned bar code transactions, this is done by a param
download, after Point has set the terminals configuration in Points terminal database.
1.3.2
Data is put into a PTAG_DATA container, this must have a PTAG_CARDNUMBER containing the
scanned bar code.
1.3.3
You can obtain the cards saldo and expire date from the receipt container by looking at PTAG_SALDO
0xC3 it contains a 4 byte unsigned amount and PTAG_EXP_DATE 0xC5 with expire date as 2 byte
(first: year (bcd) 00-99, second: month (bcd) 01-12).
1.3.4
Example LPP Start of scanned bar code purchase from terminal to ECR
TimeStamp: 08:54:37
STX
: 02
SEQ
: 02
TAG
: 65 - PTAG_TRANSACTION Container
TAGlen
: 2e
TAG
: 4e - PTAG_MI
TAGlen
: 01
TAGvalue : 00
TAG
:
TAGlen
:
TAGvalue :
4c - PTAG_CU
DLE 02
00 d0
.D
TAG
:
TAGlen
:
TAGvalue :
56 - PTAG_TT
01
00
ETX
CRC
TAG
:
TAGlen
:
TAGvalue :
50 - PTAG_TR
01
00
TAG
:
TAGlen
:
TAGvalue :
4a - PTAG_REF_NO
04
00 01 e2 40
..@
TAG
:
TAGlen
:
TAGvalue :
48 - PTAG_AMOUNT
04
00 00 00 16
....
TAG
:
TAGlen
:
TAGvalue :
59 - PTAG_GRATUITY
04
00 00 00 00
....
TAG
:
TAGlen
:
TAGvalue :
57 - PTAG_VAT
04
00 00 00 00
....
TAG
:
TAGlen
:
TAGvalue :
94 - PTAG_TERM_ENV
01
00
TAG
:
TAGlen
:
TAGvalue :
92 - PTAG_CARD_SOURCE
01
04
TAG
:
TAGlen
:
TAGvalue :
93 - PTAG_PREPAID
01
DLE 03
..
:
:
TimeStamp:
ACK
:
SEQ
:
03
38c7
08:54:37
06
02
TimeStamp: 08:54:37
STX
: 02
SEQ
: 03
TAG
: 63 - PTAG_DATA Container
TAGlen
: 15
TAG
: 52 - PTAG_CARDNUMBER
TAGlen
: 13
TAGvalue : 36 30 37 35 31 30
TAGvalue : 37 31 31
30
30 30
711
30
30
30
30
31
31
34
6075100000000114
ETX
CRC
1.4
:
:
03
8d6d
Configuration
[SCAN_ENTRY]
"01"
[RECEIPT_TYPE]
"45"
// bit 5 - 32 must be set for
// SALDO / EXP_DATE in tagged receipt
// 13 + 32 = 45 or 141 + 32 = 173