Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

A LoginRequest was accepted by the Retail Module

No response

Logout

A LogoutRequest was accepted by the Retail Module

No response

Disconnection

A Disconnection was detected by the Retail Module

Note

The absence of this event is not a guarantee that a connection is still active with the Sale System. The presence of this event is a guarantee that the connection is or was broken.

No response

PaymentRequest

A PaymentRequest was received from the Sale System while the system was available

Note

This Event type requires a response, even if the operation was unsuccessful

Content

A TLV stream containing the Request elements in Arkos-specific format, including (but possibly not exclusively):

BER Tag

Count

Field Name

Format

Nexo Retail Source (under PaymentRequest)

Miscellaneous Information

0xCE

[1-1]

SelectedService

Byte (enum)

PaymentTransaction.PaymentType

Mandatory - Defaults to Normal(7)

0xDFCF06

[1-1]

SaleTransactionIdentification

Text

SaleData.SaleTransactionID.TransactionID

Mandatory

0xDFCF01

[0-1]

SaleReferenceIdentification

Text

SaleData.SaleReferenceID

If present

0xDF47

[1-1]

CurrencyCodeA3

ANS3

PaymentTransaction.AmountsReq.Currency

Mandatory

0xD5

[0-1]

TransactionAmount

BCD12

PaymentTransaction.AmountsReq.RequestedAmount

If present

0x9F02

[0-1]

AmountAuthorised

BCD12

Same as TransactionAmount

If present

0xDFFF47

[0-1]

TransactionAmountBeforeAdjustment

BCD12

Same as TransactionAmount

If present

0xD6

[0-1]

CashbackAmount

BCD12

PaymentTransaction.AmountsReq.CashBackAmount

If present

0xCF

[0-1]

SupplementaryAmount

BCD12

PaymentTransaction.AmountsReq.TipAmount

If present

0xFFCF0A

[0-1]

RetailSaleData

DO

If not empty

0xFF01

[0-1]

|-SaleItems

DO

If present

0xFF01

[0-n]

|-ItemOccurrence

DO

PaymentTransaction.SaleItem

Multiple

0xC0

[1-1]

|-ItemID

Text

PaymentTransaction.SaleItem.ItemID

Mandatory

0xC1

[1-1]

|-ProductCode

Text

PaymentTransaction.SaleItem.ProductCode

Mandatory

0xC6

[1-1]

|-ItemAmount

DecimalText

PaymentTransaction.SaleItem.ItemAmount

Mandatory

0xC5

[0-1]

|-UnitPrice

DecimalText

PaymentTransaction.SaleItem.UnitPrice

If present

0xDF37

[0-1]

ReferenceData

Text

PaymentTransaction
.OriginalPaymentTransaction
.POITransactionID
.TransactionID

If present

Response

DisplayRequest

A DisplayRequest was received while the System was available

...

Field

Type

Usage

displayID

String

The Display ReferenceID requested by the Sale System (null if unapplicable)

No response

InputRequest

TBD

AdminRequest

...

Code Block
// To convert to a Java String
String errorMessage = new String(event.GetData());

No response