Amadis
Set Configuration Data Command
- Daniel Boucher (Unlicensed)
- Daniel Boucher
This Command allows managing Configurations of the L2 Stack.
Command Parameters
Tag | Size (bytes) | Type | M/O/C | Description |
‘C5’ | 1 | b | M | Configuration Identifier |
‘DF3A’ | Var. | b | O | Configuration Data BLOB |
‘DF3B’ | 20 | b | O | SHA-1 of Configuration Data BLOB |
‘C3’ | Var. | b | O | Configuration Version |
NOTE:Â Configuration Data BLOB may differ between Processors, Merchants and Terminal Manufacturers, it is important to identify if data conversion is required and where it should take place (i.e. TMS manages Configuration Data BLOBs per Terminal Manufacturers, the L3 Application makes Conversions, L2 interface makes Conversions...)
 Passing a ‘DF3A’ or ‘C3’ TLV Data Element with a Length set to 0 should erase the current Value stored in the L2 Stack.
For example, the following Command Parameters will erase the current Version set for the TERMINAL Configuration:
ID = TERMINAL, Version = <null> | ||||
C5 | 01 | 80 | C3 | 00 |
NOTE:Â The L2 Stack requires Configurations to be stored before performing EMV Payment Transactions, the L2 Stack may become unstable when L2 Configurations are either missing or erased during execution of EMV Payment Transactions.
Configuration Identifier
ID | Description | Dedicated Command |
00 | L2 | L2 Configuration Parameters |
01-7F | RFU | RFU: Kernel Specific Contactless Data (i.e. 02 for C-2 Specific Parameters) |
80 | TERMINAL | TERMINAL Configuration |
81 | CONTACT | CONTACT Configuration |
82 | CONTACTLESS | CONTACTLESS Configuration |
83 | CAKeys | CAKeys (Certificate Authority Keys) |
84 | CRL | CRL (Certificate Revocation List) |
85-92 | RFU | Â |
93 | DRL Visa | Visa Paywave DRL Set Parameters |
94 | DRL Amex | American Express Expresspay DRL Set Parameters |
95 | RuPay Keys | RuPay Key File |
96-9F | RFU | Â |
A0 | Exception | Exception File List |
A1 | PURE RTVL | PURE Retrieval Template |
A2 | PURE UPDT | PURE Update Template |
A3 | PURE TERM TRX | PURE Terminal Transaction Data |
A4 | Card Script | Card Script Scenario (‘Card.txt’) |
A5-FF | RFU | Â |
Response Parameters
This Command has no Response Parameters.
Error CodesÂ
Code | Description |
0000h | Successful Execution |
2101h | Unknown Tag |
2102h | Invalid Data Element Length |
2103h | Invalid Parameters |
2104h | Invalid State |
2105h | Unsupported Configuration ID |
210Ah | SHA-1 Verification of Configuration Data provided by Host Has Failed |
210Bh | SHA-1 Verification of Configuration Data stored in Memory Has Failed |
21FFh | System Error |
Â