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: |
‘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 |