at.tecs.smartpos.data

Class Transaction

java.lang.Object

at.tecs.smartpos.data.Transaction

All Implemented Interfaces:

java.io.Serializable

public class Transaction
extends java.lang.Object
implements java.io.Serializable

Data class representing transaction request.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	Transaction.Currency Defines constants for Currency code - ISO 4217 Alpha Currency Code.
static interface	Transaction.MessageType Defines constants for Message types.
static interface	Transaction.TransactionOriginIdentifier Defines constants for Transaction Origin Identifier.
static interface	Transaction.TransactionOriginIndicator Defines constants for Transaction Origin Indicator.

Field Summary

Fields

Modifier and Type	Field and Description
java.lang.String	amount Transaction Amount.
java.lang.String	authorNum For Gratuity (msg type 0009): authorization number of the original transaction.
java.lang.String	cardNum Depends on the transaction scenario: Standard Pin Pad transaction: should be empty. Manual PAN input: card number + "_" + exp.
java.lang.String	currency ISO 4217 Alpha Currency Code (e.g.
java.lang.String	cvc2 Card Verification Code.
java.lang.String	dateTime Transaction date and time (Format = yyyymmddhhmmss).
java.lang.String	desCurrency ISO 4217 Alpha Currency Code (e.g.
java.lang.String	ecrdata ECR Data field is used to transfer user information for private labeled cards like Fleet Card Company (e.g.
java.lang.String	ID Transaction unique numeric identifier.
java.lang.String	langCode ISO 639-1 language code used by Pin Pads user interface during the transaction (e.g.
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
java.lang.String	originInd 0 = request for card data on PIN PAD.
java.lang.String	password Password - currently not used (filled with spaces).
java.lang.String	paymentReason Payment reason (e.g.
java.lang.String	personalID Identification of current user of the ECR or Terminal.
java.lang.String	receiptLayout Receipt layout identifier.
java.lang.String	receiptNum Receipt number.
java.lang.String	sourceID Identification number of the authorization source.
java.lang.String	terminalNum Terminal number.
java.lang.String	transPlace First 5 characters should contain formatted zip code.
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

Constructor Summary

Constructors

Constructor and Description
Transaction()

Method Summary

Modifier and Type	Method and Description
java.lang.String	getTag()
void	setTag(java.lang.String tag)
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

ID

public 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

public 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

public 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

public 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

public 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

public java.lang.String cvc2

Card Verification Code.

Length : 4
Type : Alphanumeric

amount

public 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

public java.lang.String currency

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

Length : 3
Type : Alphabetic

receiptNum

public java.lang.String receiptNum

Receipt number.

Length : 20
Type : Numeric

paymentReason

public 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

public java.lang.String transPlace

First 5 characters should contain formatted zip code.

Length : 13
Type : Alphanumeric

authorNum

public java.lang.String authorNum

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

Length : 9
Type : Alphanumeric

originInd

public 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

public java.lang.String password

Password - currently not used (filled with spaces).

Length : 8
Type : Alphanumeric

ecrdata

public 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

public 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

public java.lang.String receiptLayout

Receipt layout identifier.

Length : 3
Type : Alphanumeric

desCurrency

public java.lang.String desCurrency

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

Length : 2
Type : Numeric

txOrigin

public 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

public java.lang.String personalID

Identification of current user of the ECR or Terminal.

Length : 50
Type : Alphanumeric

dateTime

public java.lang.String dateTime

Transaction date and time (Format = yyyymmddhhmmss).

Length : 14
Type : Numeric

Constructor Detail

Transaction

public Transaction()

Method Detail

setTag

public void setTag(java.lang.String tag)

getTag

public java.lang.String getTag()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object