Amadis

Start L2 Transaction Command

Owned by Daniel Boucher (Unlicensed)
Last updated: Aug 19, 2021
2 min read

This Command starts an EMV Payment Transaction.

Command Parameters 

Tag

Size (bytes)

Type

M/O/C

Description

‘9C’

1

n2

O

Transaction Type (ISO 8583:1987)

‘9F02’

6

n12

O

Amount, Authorized

‘9F03’

6

n12

O

Amount, Other

‘9A’

3

n6

O

Transaction Date (in ‘YYMMDD’ Format)

‘9F21’

3

n6

O

Transaction Time (in ‘HHMMSS’ 24 Hour Format)

‘5F2A’

2

n3

O

Transaction Currency Code (ISO 4217)

‘5F36’

1

n1

O

Transaction Currency Exponent (ISO 4217)

‘9F41’

2-4

n4-8

O

Transaction Sequence Counter

‘9F15’

2

n4

O

Merchant Category Code (ISO 8583:1993)

‘9F16’

15

ans

O

Merchant Identifier

‘5F57’

1

n2

O

Account Type (see Annex G of EMVCo Book A)

‘9F7C’

0-20

b

O

Merchant Custom Data (MasterCard PayPass Specific)

‘9F53’

1

b

O

Transaction Category Code (MasterCard PayPass Specific)

‘DF04’

0-6

n0-12

O

Balance Before Gen AC (MasterCard PayPass Specific)

‘DF05’

0-6

n0-12

O

Balance After Gen AC (MasterCard PayPass Specific)

‘DF7F’

1

b

O

Force to go Online (Contact Specific, 0: Disabled, 1: Enabled)

‘E4’

Var.

Constr.

C

L2 Payment Parameters Template

    ‘xxxx’

Var.

TLV

C

L2 Payment Parameters (see )

Response Parameters

 The Response Parameters vary depending on Card Technology involved in the EMV Payment Transaction (i.e. Magstripe, Contact or Contactless).

The EMV Payment Transaction may be interrupted by an Exit Condition set in the L2 Payment Parameters (see bitmap tables of and ).

Response Parameters from Exit Conditions

Once an Exit Condition has been reached, the L2 Interface provides Response Parameters corresponding of this Exit Condition to the L3 Application.

The L3 Application may continue the ongoing Transaction by sending back a Resume L2 Payment Transaction Command.

Response Parameters from the Start L2 Payment Transaction and Command Parameters for the Resume L2 Payment Transaction are described for each Exit Conditions.

Tag

Size (bytes)

Type

M/O/C

Description

‘C7’

1

b

M

Card Technology triggering Exit Condition

‘D2’

1

b

M

Exit Condition ID

‘D3’

1

b

C

Error Indicators

‘xxxx’

Var

TLV

C

Other TLVs are specific to each Exit Condition

Response Parameters of Magstripe Card Swipe

Tag

Size (bytes)

Type

M/O/C

Description

‘9F39’

1

n2

M

POS Entry Mode = 80h, 90h (Magstripe Card)

‘D0’

1

b

O

Outcome Status

‘D3’

1

b

C

Error Indicators

‘5F21’

0-79

ans

C

Track 1 Data (ISO/IEC 7813)

‘5F22’

0-40

ans

C

Track 2 Data (ISO/IEC 7813)

‘5F23’

Var.

ans

C

Track 3 Data (Region Specific)

‘5F30’

2

n3

C

Track 1/Track 2 Service Code (ISO/IEC 7813)

 NOTE:  Track Data may be masked for PCI Security reasons, refer to PCI Interface for specific Interface for retrieving PCI SRED Information.

NOTE:  Service Code may be masked for PCI Security reasons, however the L3 Application needs the Service Code for presence of Contact ICC and consequently request for Contact ICC insertion. The L3 Application may get this information from either the L2 Stack or from the PCI Interface.

Response Parameters of Contact Card

Tag

Size (bytes)

Type

M/O/C

Description

‘D0’

1

b

M

Outcome Status

‘9F39’

1

b

M

POS Entry Mode = 05h (Contact ICC)

‘9F06’

1-6

b

C

Terminal AID (of Selected Configuration)

‘84’

1-16

b

O

Card AID

‘50’

1-16

ans

O

Card Application Label

‘9F12’

1-16

ans

O

Card Application Preferred Name

‘9F5B’

1-40

b

C

Issuer Script Results

‘D3’

6

b

C

Error Indicators

‘D5’

15-21

b

C

UI Request on Outcome

‘DF07’

1

b

C

Referral Managed Terminal Indicator (0: Unsupported, 1: Supported)

‘E1’

Var.

Constr.

C

Kernel Data Record Template

    ‘xxxx’

Var.

TLV

C

Data Elements from Tag List set by Tag ‘DF3C’

‘E9’

Var.

Constr.

C

Reversal Data Template

    ‘xxxx’

Var.

TLV

C

Data Elements from Tag List set by Tag ‘DF41’

‘EA’

Var.

Constr.

C

Advice Data Template

    ‘xxxx’

Var.

TLV

C

Data Elements from Tag List set by Tag ‘DF40’

‘EB’

Var.

Constr.

C

Batch Data Template

    ‘xxxx’

Var.

TLV

C

Data Elements from Tag List set by Tag ‘DF3F’

Response Parameters of Contactless Card

Tag

Size (bytes)

Type

M/O/C

Description

‘D0’

1

b

M

Outcome Status

‘9F39’

1

b

M

POS Entry Mode = 07h, 91h, 98h (Contactless ICC)

‘D7’

1

b

C

Terminal Kernel ID (of Selected Combination)

‘9F06’

1-16

b

C

Terminal AID (of Selected Combination)

‘84’

1-16

b

O

Card AID (DF Name)

‘D3’

6

b

C

Error Indicators

‘D4’

10

b

C

Outcome Parameters

‘D5’

15-21

b

C

UI Request on Outcome

‘D6’

15-21

b

O

UI Request on Restart

‘DF16’

15-21

b

O

UI Request Data

‘E0’

Var.

Constr.

C

Data Template

    ‘xxxx’

Var.

TLV

C

Data Elements from Tag List set by Tag ‘DF3E’

‘E1’

Var.

Constr.

C

Kernel Data Record Template

    ‘xxxx’

Var.

TLV

C

Kernel Data Record Elements (Specific to each Kernel)

 ‘E2’

Var.

Constr.

C

Kernel Discretionary Data Template

    ‘xxxx’

Var.

TLV

C

Kernel Discretionary Data Elements (Specific to each Kernel)

Error Codes 

Code

Description

0000h

Successful Execution

22FFh

System Error

Â