Amadis

Set L2 Payment Parameters Command

Owned by Daniel Boucher (Unlicensed)
Last updated: May 25, 2022
2 min read

This Command allows setting L2 Payment Parameters prior to EMV Payment Transactions.

Command Parameters

Tag

Size (bytes)

Type

M/O/C

Description

‘C7’

1

b

O

Card Technologies Enabled for Card Detection

‘CA’

4

b

O

Bitmap for Exit Conditions during Contact Transaction

‘CB’

4

b

O

Bitmap of Exit Conditions during Contactless Transaction

‘CC’

1

b

O

Bitmap of activated Notifications

‘CD’

1

b

O

Force Contact Transaction to go Online:
00h    N/A
01h    Force Online

‘D2’

1

b

O

Contactless Start Point:
0Ah   Start A (Pre-Processing)
0Bh   Start B (Card Detection)
0Ch   Start C (Application Selection)
0Dh   Start D (Kernel Activation)

‘DF1B’

7

b

O

L2 Stack Configuration Parameters (see below)

‘DF3C’

Var.

b

O

Default Tag List of Data Elements returned by Contact Start Payment Transaction

‘DF3D’

Var.

b

O

Default Tag List of Data Elements returned by Contact Complete Payment Transaction

‘DF3E’

Var.

b

O

Default Tag List of Data Elements returned by Contactless Transactions (in addition to Kernel’s Data Record and Discretionary Data)

‘DF3F’

Var.

b

O

Default Tag List for Batch Data

‘DF40’

Var.

b

O

Default Tag List for Advice Data

‘DF41’

Var.

b

O

Default Tag List for Reversal Data

 An Exit Condition allows interrupting an ongoing Payment Transactions after reaching specific States.

Once interrupted, the L2 Stack may receive other Messages until a Resume L2 Payment Transaction Command is sent for resuming the execution of the interrupted Payment Transaction.

It is also possible to terminate an Interrupted Payment Transaction by sending a Close L2 Payment Transaction Command instead of a Resume L2 Payment Transaction Command.

L2 Stack Configuration Bitmap

Bitmap

Description

b8

b7

b6

b5

b4

b3

b2

b1

Byte 1 – Default Transaction Type

00h - FFh

Transaction Type when Tag ‘9C’ is missing in TRD (ex: 00h = Purchase)

Byte 2 – Legacy Selection Flags

x

 

 

 

 

 

 

 

Legacy ZIP Selection Rules

 

x

 

 

 

 

 

 

Legacy Paypass Selection Rules

 

 

x

 

 

 

 

 

Legacy ExpressPay Selection Rules

 

 

 

x

 

 

 

 

Legacy JCB Selection Rules

 

 

 

 

x

 

 

 

Legacy CUP Selection Rules

 

 

 

 

 

x

 

 

Legacy DPAS Selection Rules

 

 

 

 

 

 

x

 

Legacy Visa Selection Rules

 

 

 

 

 

 

 

x

VCAS Mode

Byte 3 – L2 Stack Parameter Bitmap (1/2)

x

 

 

 

 

 

 

 

Force Receipt

 

0

 

 

 

 

 

 

RFU

 

 

x

 

 

 

 

 

Transaction Looping

 

 

 

x

 

 

 

 

Key In Activation

 

 

 

 

x

 

 

 

Contactless Signals

 

 

 

 

 

x

 

 

Data Exchange Callback

 

 

 

 

 

 

0

0

RFU

Byte 4 – L2 Stack Parameter Bitmap (2/2)

0

0

0

0

0

0

0

0

RFU

Byte 5 – Card Detection Timeout

00h – FFh

Card Detection Timeout (in seconds)

Byte 6 – Trace Depth

00h – 07h

(see )

Byte 7 – Default Language

00h

RFU

Response Parameters

This Command has no Response Parameters

Error Codes 

Code

Description

0000h

Successful Execution

2203h

Invalid Parameters

22FFh

System Error

Â