Amadis

Get Candidate List (13h)

The Get Candidate List Exit Condition force L2 to Exit after it finished Building the Candidate List and provides the following Information:

  • Tag ‘D9’ (Candidate List Type) informs whether Candidate List was built from Manual Terminal AID Selection (01h) or from PSE Directory File Records (02h)

  • Tag ‘5F2D’ (ICC Language Preference) allows User Language Selection and Initialization of Display Interface using appropriate Language

  • Tag ‘E7’ (Candidate Entry Template) provides Information about each applicable Candidate Entry for User Application Selection and/or Candidate Elimination and/or Candidate List Reordering

 

Each Candidate Entry (Tag ‘E7’) contains a Sequential Candidate ID (Tag ‘DA’ starting at index 01h) and is used as Reference for the Resume Command Parameters:

  • If User Application Selection is performed, then the Selected Candidate ID is in Tag ‘DB’

  • If Tag ‘E6’ is Absent, then the Candidate List remains Unchanged

  • If Tag ‘E6’ is Empty (i.e. Length = 0), then all Candidates were Eliminated

  • If Tag ‘E6’ contains one or multiple Candidate ID (Tag ‘DA’), then missing Candidate IDs were Eliminated

 

NOTE: Absence of Tag ‘DB’ indicates that no User Application Selection has been Performed

NOTE: Empty Tag ‘DB’ (with either Length = 00h or Value = 00h) indicates that User pressed ‘Cancel’ during Application Selection

 

Exit Condition Response Parameters

The Parameters Returned by this Exit Condition are:

Tag

Size (bytes)

Type

M/O/C

Description

‘D2’

1

b

M

Exit Condition ID = 13h

‘C7’

1

b

M

Contact Card Technology = 40h

‘D9’

1

b

C

Candidate List Type:
00h           N/A
01h           Candidate List from Terminal AID Selection
02h           Candidate List from PSE

‘5F2D’

2-8

an2

C

ICC Language Preference

‘9F11’

1

n2

C

Issuer Code Table Index

‘E7’

Var.

Constr.

O

Candidate Template

    ‘xxxx’

Var.

TLV

O

Data Elements for Candidate ID 01h

‘E7’

Var.

Constr.

O

Candidate Template

    ‘xxxx’

Var.

TLV

O

Data Elements for Candidate ID 02h

 

 

 

 

‘E7’

Var.

Constr.

O

Candidate Template

    ‘xxxx’

Var.

TLV

O

Data Elements for Candidate ID ‘n’

 

RESUME L2 PAYMENT TRANSACTION Command Parameters

Normal Execution continues using the Following Parameters in the RESUME L2 PAYMENT TRANSACTION command:

Tag

Size (bytes)

Type

M/O/C

Description

‘DB’

1

b

O

Selected Candidate ID

‘E6’

Var.

Constr.

O

Candidate List Template

    ‘DA’

1

b

O

Candidate ID of 1st Entry

    ‘DA’

1

b

O

Candidate ID of 2nd Entry

    …

 

 

 

 

    ‘DA’

1

b

O

Candidate ID of Last Entry

 

.1.1.1.1.2.1        Example

Considering a Contact ICC containing two Candidates:

ADF 1: A0000000011010 (App Label = ‘A1’), Priority 81 (Cardholder Confirmation Required)

ADF 2: A0000000012010 (App Label = ‘A2’), Priority 82 (Cardholder Confirmation Required)

Language Preference = English, French, Spanish (ISO639-1 ‘en’, ‘fr’, ‘es’)

 

Then the GET CANDIDATE LIST Exit Condition Response Parameters would be:

Tag

Len

Value

Description

D2

01

13

Exit Condition ID = Get Candidate List

C7

01

40

Techno = Contact ICC

D9

01

02

Candidate List from PSE

5F2D

06

65 6E 66 72 65 73

Language Preference = ‘en’, ‘fr’, ‘es’

E7

1E

Candidate Entry Template

 

DA

01

01

Candidate ID

 

9F06

06

A0 00 00 00 01 10

Matching Terminal AID (i.e. Partial Match)

 

61

10

ADF Template

 

 

4F

07

A0 00 00 00 01 10 10

ADF Name

 

 

50

02

41 31

Application Label = ‘A1’

 

 

87

01

81

Application Priority Indicator (Confirmation Required)

E7

1F

Candidate Entry Template

 

DA

01

02

Candidate ID

 

9F06

07

A0 00 00 00 01 20 10

Matching Terminal AID (i.e. Full Match)

 

61

10

ADF Template

 

 

4F

07

A0 00 00 00 01 20 10

ADF Name

 

 

50

02

41 32

Application Label = ‘A2’

 

 

87

01

82

Application Priority Indicator (Confirmation Required)

 

If:

  • L3 Application changes Candidate Order from [01, 02] to [02, 01]

  • Cardholder selects ‘Spanish’ during Language Selection

  • Cardholder selects ‘A2’ during Application Selection

 

Then the RESUME L2 PAYMENT TRANSACTION Command Parameters provided by Kizis would be:

Tag

Len

Value

Description

DC

02

65 73

Selected Language = ‘es’

DB

01

02

Selected Candidate ID = 02

E6

06

Candidate List Template

 

DA

01

02

Candidate ID

 

DA

01

01

Candidate ID