Serialized Form

Package at.tecs.smartpos

Class at.tecs.smartpos.PaymentService extends java.lang.Object implements Serializable

Serialized Fields

postman

at.tecs.smartpos.Postman postman

Class at.tecs.smartpos.SmartPOSController extends java.lang.Object implements Serializable

Serialized Fields

postman

at.tecs.smartpos.Postman postman

postmanPrint

at.tecs.smartpos.Postman postmanPrint

Package at.tecs.smartpos.data

Class at.tecs.smartpos.data.Response extends java.lang.Object implements Serializable

Serialized Fields

response

java.lang.String response

creditCardIssuer

java.lang.String creditCardIssuer

Acquirer name + ";" + card brand (e.g. "VISA").

cardNum

java.lang.String cardNum

Depends on transaction scenario:

Standard transaction: Card number + "_" + exp. date (YYMM).

For terminals activated for Card Reference number:

• "REF" + reference no + "_" + expiry date (YYMM) + "_" + last 4 digits from PAN + "_" + first 6 digits from PAN.
• Cancellation/capture/credit note: "TXID" + transaction number as entered in request
• Non ISO based Card numbers: Card prefix + Card number.
• Card prefixes are defined by TECS and are stated in document NonISO_CardIssuer_Prefixes provided by TECS.

Length : 40
Type : Alphanumeric

transactionType

java.lang.String transactionType

Transaction type.

Length : 2 Type : Alphanumeric

responseText

java.lang.String responseText

Response text - description of the response code.
Text is UTF-8 encoded. Binary size of the field is 80 bytes in this case.

Length : 80
Type : Alphanumeric

responseCode

java.lang.String responseCode

Response code.

Length : 4
Type : Numeric

authorNum

java.lang.String authorNum

Authorization number generated by TECS Authorization Host.

Length : 9
Type : Alphanumeric

length

java.lang.String length

Message length in bytes.

Length : 4
Type : Numeric

transID

java.lang.String transID

Transaction unique identifier (it should be same as sent in the authorization request).

Length : 20
Type : Numeric

msgType

java.lang.String msgType

Message type.

Length : 4
Type : Numeric

transactionDateTime

java.lang.String transactionDateTime

Transaction date and time (Format = yyyymmddhhmmss).

Length : 14
Type : Numeric

VUNum

java.lang.String VUNum

Merchant Contract number with acquirer.

Length : 15
Type : Alphanumeric

operatorID

java.lang.String operatorID

Identification of the operator of tecs-engine installation.

Length : 12
Type : Alphanumeric

serienNR

java.lang.String serienNR

If present, should be printed on receipt.

Length : 9
Type : Alphanumeric

origTXID

java.lang.String origTXID

Original transaction ID (for Cancellation).

Length : 20
Type : Numeric

stan

java.lang.String stan

TECS Trace Number.

Length : 6
Type : Numeric

origStan

java.lang.String origStan

STAN of original transaction (for Cancellation).

Length : 6
Type : Numeric

svc

java.lang.String svc

Service Code (returned by TECS Server). Value must be printed on receipt.

Length : 3
Type : Numeric

ecrData

java.lang.String ecrData

ECR Data field is used to transfer user information for private labeled cards like Fleet Card Company (e.g. UTA, outex and so on).
This field is sent from TECS Server to ECR as it was received.

Length : 250
Type : Alphanumeric

exchangeRate

java.lang.String exchangeRate

Exchange rate at the time of transaction (e.g. 000000000000001,1223).

Length : 20
Type : Alphanumeric

foreignTXAmount

java.lang.String foreignTXAmount

Transaction amount in desired currency.

Length : 20
Type : Alphanumeric

balanceAmount

java.lang.String balanceAmount

Max.Amount available.

Length : 20
Type : Alphanumeric

merchantName

java.lang.String merchantName

Merchant Name.

Length : 25
Type : Alphanumeric

merchantAddress

java.lang.String merchantAddress

Merchant Address.

Length : 50
Type : Alphanumeric

receiptHeader

java.lang.String receiptHeader

Receipt Header.

Length : 100
Type : Alphanumeric

receiptFooter

java.lang.String receiptFooter

Receipt Footer. Has to be printed on the receipt.
This field contains the authentication method, 'PIN VERIFIED' or 'SIGNATURE', tags "AID:" and "AC:".
It is mandatory to print the present one on the receipt.

Length : 100
Type : Alphanumeric

bonusPoints

java.lang.String bonusPoints

Actual Bonus Points.

Length : 100
Type : Alphanumeric

exFee

java.lang.String exFee

Exchange Fee.

Length : 20
Type : Numeric

reconciliationResponse

java.lang.String reconciliationResponse

endOfDayResponse

java.lang.String endOfDayResponse

merchantReceipt

java.lang.String merchantReceipt

customerReceipt

java.lang.String customerReceipt

scanData

java.lang.String scanData

signature

java.lang.String signature

Class at.tecs.smartpos.data.Transaction extends java.lang.Object implements Serializable

Serialized Fields

tag

java.lang.String tag

ID

java.lang.String ID

Transaction unique numeric identifier.
This number has to be unique for every transaction performed on specified Terminal (field 10).

Length : 20
Type : Numeric

terminalNum

java.lang.String terminalNum

Terminal number. It is provided by TECS. For Cancellation/Capture (msg type 0013) – the terminal number of the original transaction.

Length : 8
Type : Numeric

msgType

java.lang.String msgType

Message type, one of following:

• 0001 = Purchase, Balance or Preauthorization (See field 21),
• 0005 = Purchase with authorization number,
• 0009 = Gratuity,
• 0011 = Credit note,
• 0013 = Cancellation/Capture,
• 0015 = Pre-paid (Mobile Recharge),
• 0017 = Abort ongoing transaction
• 0018 = External reader device restart command
• 0027 = Voucher/Coupon generation,
• 0029 = Card to Card transfer,
• 4544 = Kill application
• 9043 = Get terminal status,
• 9999 = Initiate CTLS tap event simulator,
• 2667 = Get connection status.

Length : 4
Type : Numeric

sourceID

java.lang.String sourceID

Identification number of the authorization source.

In the cancellation message (message type = 0013), By the Gratuity (0009), By the Credit note (0011) it should be the identification source ID of the original transaction.
It is provided by TECS.

Length : 2
Type : Numeric

cardNum

java.lang.String cardNum

Depends on the transaction scenario:

• Standard Pin Pad transaction: should be empty.
• Manual PAN input: card number + "_" + exp. date (YYMM).
• Swiped card on ECR: Track2.
• Cancellation/capture (msg type 0013): "TXID" + transaction number (message field 2) of the original transaction.
• Gratuity (msg type 0009): "TXID" + transaction number (message field 2) of the original transaction.
• Credit note (msg type 0011) over a reference transaction: "TXID" + transaction number (message field 2) of the original transaction.
• Cancellation/Capture from different terminal id: "TXID" + + "_" + + "_" + eg. "TXID00000000001234567890_01_88091234"

Length : 40
Type : Alphanumeric

cvc2

java.lang.String cvc2

Card Verification Code.

Length : 4
Type : Alphanumeric

amount

java.lang.String amount

Transaction Amount.
According to currency exponent defined in ISO 4217 is used as follows, e.g. for amount in EUR (urrency exponent=2) 12,55 EUR = "1255" EUR, for amount in BYR (currency exponent=0) 15000 BYR = "15000" BYR.

Length : 11
Type : Numeric

currency

java.lang.String currency

ISO 4217 Alpha Currency Code (e.g. "EUR", "USD").

Length : 3
Type : Alphabetic

receiptNum

java.lang.String receiptNum

Receipt number.

Length : 20
Type : Numeric

paymentReason

java.lang.String paymentReason

Payment reason (e.g. "Taxi journey"). Should be agreed with acquirer.
For Prepaid/Mobile recharge (msg type 0015): "+" + Operator Code and optional phone number.
Text is UTF-8 encoded. Binary size of the field is 39 bytes in this case.

Length : 39
Type : Alphanumeric

transPlace

java.lang.String transPlace

First 5 characters should contain formatted zip code.

Length : 13
Type : Alphanumeric

authorNum

java.lang.String authorNum

For Gratuity (msg type 0009): authorization number of the original transaction. Otherwise empty.

Length : 9
Type : Alphanumeric

originInd

java.lang.String originInd

0 = request for card data on PIN PAD.
1 = Face to Face (Magswipe performed on ECR) – no Pin Pad involved. 2 = Mail order, Telephone order, Manual keyed in card data - no Pin Pad involved.

Length : 1
Type : Numeric

password

java.lang.String password

Password - currently not used (filled with spaces).

Length : 8
Type : Alphanumeric

ecrdata

java.lang.String ecrdata

ECR Data field is used to transfer user information for private labeled cards like Fleet Card Company (e.g. UTA, outex and so on).
This field is sent from ECR to the TECS Server as it was received.

Length : 250
Type : Alphanumeric

langCode

java.lang.String langCode

ISO 639-1 language code used by Pin Pads user interface during the transaction (e.g. en, de, es, pt, fr, ..).

Length : 2
Type : Alphanumeric

receiptLayout

java.lang.String receiptLayout

Receipt layout identifier.

Length : 3
Type : Alphanumeric

desCurrency

java.lang.String desCurrency

ISO 4217 Alpha Currency Code (e.g. "EUR", "USD") in which transaction will be processed.

Length : 2
Type : Numeric

txOrigin

java.lang.String txOrigin

• 1 = Face to Face : if Customer is present
• 2 = MOTO : Customer not Present
• 4 = Capture/Completion
• 5 = Pre Authorization
• 7 = Balance

Length : 1
Type : Numeric

personalID

java.lang.String personalID

Identification of current user of the ECR or Terminal.

Length : 50
Type : Alphanumeric

dateTime

java.lang.String dateTime

Transaction date and time (Format = yyyymmddhhmmss).

Length : 14
Type : Numeric

Package at.tecs.smartpos.exception

Class at.tecs.smartpos.exception.BluetoothException extends java.lang.Exception implements Serializable

Class at.tecs.smartpos.exception.TransactionFieldException extends java.lang.Exception implements Serializable

Serialized Fields

TransactionFieldName

java.lang.String TransactionFieldName