> For the complete documentation index, see [llms.txt](https://sandbox-docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sandbox-docs.verifone.com/adk-5.0-programmers-guide/readme/modules/group__vss.md).

# Vss

[Macros](#define-members)

|         |                                                                                                                                                 |
| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Macros  |                                                                                                                                                 |
| #define | [LOAD\_DUKPT\_KEY](#ga2f8314814320e4351da7667a05351b91)   (0x10)                                                                                |
| #define | [LOAD\_TMK\_KEY](#ga84c44483f34c0d84f9417f64565115ed)   (0x11)                                                                                  |
| #define | [LOAD\_KEY\_ENC\_DATA\_MSK](#gac44d638245acd1064fa841bf75d68cfe)   (0x15)                                                                       |
| #define | [LOAD\_KEY\_PIN\_MSK](#ga9da65fd69ba099e1d6a5e9c63c0fd3fa)   (0x16)                                                                             |
| #define | [LOAD\_KEY\_GEN\_MAC\_MSK](#gadbaeedb2248878267eef9b883e441514)   (0x17)                                                                        |
| #define | [LOAD\_KEY\_DEC\_DATA\_MSK](#gae278ff558bc8dff84e612dc0d3e1ae4f)   (0x18)                                                                       |
| #define | [LOAD\_KEY\_VER\_MAC\_MSK](#gaaf79eb5edf10c8202dcfe8876baedf26)   (0x19)                                                                        |
| #define | [LOAD\_KEY\_KEK\_MSK](#ga2abc8361ea15929c0ec2ff73e27bfb36)   (0x1A)                                                                             |
| #define | [GET\_NEW\_DUKPT](#ga7af69135d805e5206cf42c8783c9c8f9)   (0x28)                                                                                 |
| #define | [START\_TRANSACTION](#gaf1654585c80282f2dc54a9d16b915e6c)   (0x28)                                                                              |
| #define | [SET\_DUKPT\_MASK](#ga3a5d8d8353446c85f08767651812963b)   (0x29)                                                                                |
| #define | [SCRIPT\_INIT](#gae1bdf3a721db08a56686cdc1fbd1a396)   (0x30)                                                                                    |
| #define | [SCRIPT\_GET\_KEY\_SET\_INIT](#ga4c974ae980ab4b8813673b5b555836b8)   (0x32)                                                                     |
| #define | [SCRIPT\_CHECK\_INIT](#ga6f0b4e52bf562c5a7496865d4dffadb6)   (0x33)                                                                             |
| #define | [TEST\_TMK\_ENGINE](#ga95182c9326b061c4c55a66f50a2a0c56)   (0x35)                                                                               |
| #define | [TEST\_DUKPT\_ENGINE](#ga790e4a13adc7aec51a64ef5b360dfb3e)   (0x39)                                                                             |
| #define | [TEST\_KEY\_FOR\_DATA](#gac7cddf4fea9c3a9797bcbcdd5d5dd91c)   (0x36)                                                                            |
| #define | [TEST\_KEY\_FOR\_PIN](#ga44579064b0c0e6fff38ff82012880edc)   (0x37)                                                                             |
| #define | [TEST\_KEY\_FOR\_MAC](#ga04aa97a435b4d74bf669e639ae6b15fb)   (0x38)                                                                             |
| #define | [ENCRYPT\_INIT](#ga8b6f0172ea31c17b9d7aa5784c2b651a)   (0x40)                                                                                   |
| #define | [ENCRYPT\_ITERATION](#gadef6432b1d8f7ad14a2ba8f13f9f7a32)   (0x41)                                                                              |
| #define | [ENCRYPT\_FINISH](#ga2ab5d4276702a3de7d567eb055f911f4)   (0x42)                                                                                 |
| #define | [ENCRYPT\_CBC\_ITERATION](#ga03e6109541a1e1f33087fcc8cacefbfb)   (0x43)                                                                         |
| #define | [DECRYPT\_INIT](#ga9dda1955fda005d373617cea91fa60fb)   (0x50)                                                                                   |
| #define | [DECRYPT\_ITERATION](#ga0f890003acddc5ab054f9be9bb9c4638)   (0x51)                                                                              |
| #define | [DECRYPT\_FINISH](#ga23484114a161add6102ec674917c0666)   (0x52)                                                                                 |
| #define | [DECRYPT\_CBC\_ITERATION](#ga286799b6e4775a2000f8f23a3deae819)   (0x53)                                                                         |
| #define | [MAC\_GENERATE\_INIT](#ga85df78895c20a18314d6850ce625e374)   (0x60)                                                                             |
| #define | [MAC\_GENERATE\_ITERATION](#ga24f89abac32c71a7d6f7f2e07a3c69a9)   (0x61)                                                                        |
| #define | [MAC\_GENERATE\_FINISH](#ga5cb7f35bc0bdfe24ac0f5047fac450d4)   (0x62)                                                                           |
| #define | [MAC\_VERIFY\_INIT](#ga86701406c0b8568a4e3c56342e3a4a5e)   (0x63)                                                                               |
| #define | [MAC\_VERIFY\_ITERATION](#gaa40c8ef7083d0257720ff3dcbf8aabb9)   (0x64)                                                                          |
| #define | [MAC\_VERIFY\_FINISH](#ga0ef87de359bc3cc2ca1e28e6ace768ae)   (0x65)                                                                             |
| #define | [PIN\_INIT](#ga66a8f8bb1534842a3e7cab64637fef1f)   (0x70)                                                                                       |
| #define | [ISO\_0\_PREPARE](#gab0401f08b432090d24c08d693c24623f)   (0x71)                                                                                 |
| #define | [ISO\_1\_PREPARE](#ga00b2e946cd1be6cf52c2c7a4053dfbe1)   (0x72)                                                                                 |
| #define | [ISO\_2\_PREPARE](#gacea965f7ae6b742e08f5b58bb3d5662f)   (0x73)                                                                                 |
| #define | [ISO\_3\_PREPARE](#ga8f23d658f785f47190fec967d9783060)   (0x74)                                                                                 |
| #define | [ISO\_0\_PREPARE\_PIN\_0](#gaf2d8b3378e65c59be442b014f2b8d778)   (0x80)                                                                         |
| #define | [ISO\_1\_PREPARE\_PIN\_0](#ga39c55220e84204f89781f2d6de3f6816)   (0x81)                                                                         |
| #define | [ISO\_2\_PREPARE\_PIN\_0](#ga9d809956812d078bd317d5ea51d3a3b7)   (0x82)                                                                         |
| #define | [ISO\_3\_PREPARE\_PIN\_0](#gaf265eb037a8e3c00a57d1e62a5ee1d95)   (0x83)                                                                         |
| #define | [PIN\_ITERATION](#ga78fe99462d905bd0aa6f43e50052c1ed)   (0x75)                                                                                  |
| #define | [PIN\_FINISH](#gab26fba5550fe958a8d95fa51a700cc38)   (0x76)                                                                                     |
| #define | [PIN\_CANCEL](#ga5cf897892e478bad3ca024677db9651d)   (0x77)                                                                                     |
| #define | [MACRO\_RETRIEVE\_STATUS](#ga9555597847d1ff329ee5de359d2b0814)   0xB0                                                                           |
| #define | [MACRO\_CLEAR\_IV](#ga34216860584b51097a07abe8a8bfd3e8)   0xB1                                                                                  |
| #define | [MACRO\_ENCRYPT\_KSK](#gadf2cebcad2bc2e1912538539fc13780b)   0xB2                                                                               |
| #define | [MACRO\_DECRYPT\_KSK](#gab598cbc3e161e5527d6f1a690488661c)   0xB3                                                                               |
| #define | [MACRO\_RETRIEVE\_PPID](#ga4be5ce903079bf3d5be7ae1440fa5b65)   0xB4                                                                             |
| #define | [MACRO\_STORE\_RN](#gaa1b177bb54992520d6d2f7a6e965d2bc)   0xB5                                                                                  |
| #define | [MACRO\_RETRIEVE\_RN](#ga209f18fd4109457287f2fd79c557f171)   0xB6                                                                               |
| #define | [MACRO\_STORE\_DATETIME](#gadca81798d3b3ceee1a49c232e70e0bdf)   0xB7                                                                            |
| #define | [MACRO\_RETRIEVE\_DATETIME](#ga78e4cd082f6cb81b324a23a7d61ecc3c)   0xB8                                                                         |
| #define | [MACRO\_GENERATE\_KI](#ga86fed5f3892bf79d171611fd107bdea3)   0xB9                                                                               |
| #define | [MACRO\_LOAD\_RSA\_SLOT\_4](#gacffc4b58b7e3fdc12cce07393cb9637f)   0xBA                                                                         |
| #define | [MACRO\_LOAD\_RSA\_SLOT\_5](#ga0b97763de72b193f006ec1afd8d9991b)   0xBB                                                                         |
| #define | [MACRO\_RSA\_CALC\_SLOT\_4](#ga2d6440e0dca64696339b0f6df7878b5b)   0xBC                                                                         |
| #define | [MACRO\_RSA\_CALC\_SLOT\_5](#gaa54f0b04fd8994c65d196e00b3e39144)   0xBD                                                                         |
| #define | [MACRO\_STORE\_KCA](#gaaf4a0220291a3daecae73fbed2d39c2a)   0xBE                                                                                 |
| #define | [MACRO\_STORE\_KCA\_V44](#gac946bb139c7f8a7ba259f509aecb5323)   0xBF                                                                            |
| #define | [MACRO\_STORE\_KMACH](#gae9bd22333a3f4056b37defb29cd22903)   0xC0                                                                               |
| #define | [MACRO\_STORE\_AIIC](#ga8618ca26da69f4fae99115db11ea3335)   0xC1                                                                                |
| #define | [MACRO\_COMPUTE\_KIA](#ga3879e6c5999e10831396eb49c5eef807)   0xC2                                                                               |
| #define | [MACRO\_RETRIEVE\_ENC\_PPID](#ga0f52f7ec9339fa97e562293a9fb05aaa)   0xC3                                                                        |
| #define | [MACRO\_RETRIEVE\_KVC\_KIA](#ga407312cbba92b1160a4c767f941cdf5c)   0xC4                                                                         |
| #define | [MACRO\_COMPUTE\_KMACI](#gab0a816007427bc3ea0d6f6c55e8d9f4d)   0xC5                                                                             |
| #define | [MACRO\_COMPUTE\_MAC\_ACQ\_MKEYS](#ga3b986cd0e3d383795e565d2454ab2398)   0xC6                                                                   |
| #define | [MACRO\_SELECT\_KEY\_SET\_ID\_1](#ga720cc8ec469e36af59973ec62fc95702)   0xC7                                                                    |
|         | <p>select KeySet Macro for ksid=1 and version=1. No input parameters. <a href="#ga720cc8ec469e36af59973ec62fc95702">More...</a><br></p>         |
| #define | [MACRO\_SELECT\_KEY\_SET\_ID\_2](#ga026455d05e3db8eee131e81f1b73a171)   0xC8                                                                    |
|         | <p>select KeySet Macro for ksid=2 and version=1. No input parameters. <a href="#ga026455d05e3db8eee131e81f1b73a171">More...</a><br></p>         |
| #define | [MACRO\_SELECT\_KEY\_SET\_ID\_3](#gacd684d770244e27ad3ffd89c40cf4c5f)   0xC9                                                                    |
|         | <p>select KeySet Macro for ksid=3 and version=1. No input parameters. <a href="#gacd684d770244e27ad3ffd89c40cf4c5f">More...</a><br></p>         |
| #define | [MACRO\_SELECT\_KEY\_SET\_ID\_4](#ga4939047f2ecc51a26d01049eac766202)   0xCA                                                                    |
|         | <p>select KeySet Macro for ksid=4 and version=1. No input parameters. <a href="#ga4939047f2ecc51a26d01049eac766202">More...</a><br></p>         |
| #define | [MACRO\_SELECT\_KEY\_SET\_ID\_5](#ga0c1873c097c088a490799c0a85e99435)   0xCB                                                                    |
|         | <p>select KeySet Macro for ksid=5 and version=1. No input parameters. <a href="#ga0c1873c097c088a490799c0a85e99435">More...</a><br></p>         |
| #define | [MACRO\_SELECT\_KEY\_SET\_ID\_6](#ga848afe390caa06816c951a5b03becb68)   0xCC                                                                    |
|         | <p>select KeySet Macro for ksid=6 and version=1. No input parameters. <a href="#ga848afe390caa06816c951a5b03becb68">More...</a><br></p>         |
| #define | [MACRO\_SELECT\_KEY\_SET\_ID\_7](#gab79e7d05864c8a2016482542ba776775)   0xCD                                                                    |
|         | <p>select KeySet Macro for ksid=7 and version=1. No input parameters. <a href="#gab79e7d05864c8a2016482542ba776775">More...</a><br></p>         |
| #define | [MACRO\_SELECT\_KEY\_SET\_ID\_8](#ga392ad9e8494ee717ef2b8a63220ed19f)   0xCE                                                                    |
|         | <p>select KeySet Macro for ksid=8 and version=1. No input parameters. <a href="#ga392ad9e8494ee717ef2b8a63220ed19f">More...</a><br></p>         |
| #define | [MACRO\_SELECT\_KEY\_SET\_ID\_MAX](#ga0357d5563c50c72b7b57da0e002c6895)   [MACRO\_SELECT\_KEY\_SET\_ID\_8](#ga392ad9e8494ee717ef2b8a63220ed19f) |
|         | <p>used to check limitation of select KeySet Macros <a href="#ga0357d5563c50c72b7b57da0e002c6895">More...</a><br></p>                           |
| #define | [MACRO\_SELECT\_KEY\_SET\_ID\_X](#ga9aa98a84182f89bbb537c5290eaecc69)   [MACRO\_SELECT\_KEY\_SET\_ID\_1](#ga720cc8ec469e36af59973ec62fc95702)   |
|         | <p>select KeySet Macro for all ksid and version=2. input parameter: ksid. <a href="#ga9aa98a84182f89bbb537c5290eaecc69">More...</a><br></p>     |
| #define | [MACRO\_STORE\_KEK1](#gabc8dda11a9c7e5a3bebd90821f7d88c1)   0xCF                                                                                |
| #define | [MACRO\_STORE\_KEK2](#gace90185513e8afec78481117fdcb5422)   0xD0                                                                                |
| #define | [MACRO\_STORE\_PPASN](#ga4600092e676f01de5b49179662536616)   0xD1                                                                               |
| #define | [MACRO\_RETRIEVE\_KVC\_KEK1](#ga33e6d63a0483541e1a6856be4a3c1925)   0xD2                                                                        |
| #define | [MACRO\_RETRIEVE\_eKEK1\_PPASN](#gae05304ea913d5efdabbb48e7e68a7b12)   0xD3                                                                     |
| #define | [MACRO\_RETRIEVE\_eKEK2\_PPASN](#ga59050825a5df2553e0db52690effe87f)   0xD4                                                                     |
| #define | [MACRO\_ROLL\_KEK1](#ga64845bce0261fda7a642832e3fd243af)   0xD5                                                                                 |
| #define | [MACRO\_ROLL\_KEK2](#ga8096ea6536b1f3413e29699f2a8b26bf)   0xD6                                                                                 |
| #define | [MACRO\_STORE\_eKEK1\_KMACr](#ga1ba8fbbb557d5468e3bfa29f678de92b)   0xD7                                                                        |
| #define | [MACRO\_STORE\_eKEK2\_KMACr](#ga778fe1dddee857344c6e72bc8fc67092)   0xD8                                                                        |
| #define | [MACRO\_STORE\_eKEK1\_KMACs](#ga459e37334b9fc250f27aec4842e29ab8)   0xD9                                                                        |
| #define | [MACRO\_STORE\_eKEK2\_KMACs](#gaaa7b26e0f63be6065aa68b3a3cb7cb7e)   0xDA                                                                        |
| #define | [MACRO\_STORE\_eKEK1\_KDr](#ga2f8351b863eed3195f6566528b7f4d5b)   0xDB                                                                          |
| #define | [MACRO\_STORE\_eKEK2\_KDr](#ga2d2cb27c26d363a3791cbca7bb354a73)   0xDC                                                                          |
| #define | [MACRO\_STORE\_eKEK1\_KDs](#ga3815b76ae48c95905ccfa0d51a75dd71)   0xDD                                                                          |
| #define | [MACRO\_STORE\_eKEK2\_KDs](#gaf3e56a39969d1a6944c33ff1e827dd24)   0xDE                                                                          |
| #define | [MACRO\_STORE\_eKEK1\_KPP\_V42](#gaa78c758b046f92a8e04e35328b33c869)   0xDF                                                                     |
| #define | [MACRO\_STORE\_eKEK1\_KPP\_V28](#ga42b31435e83343186a3a322764171977)   0xE0                                                                     |
| #define | [MACRO\_STORE\_eKEK2\_KPP\_V42](#gaccbbb626e498abd3b78c3fd9655de6ea)   0xE1                                                                     |
| #define | [MACRO\_STORE\_eKEK2\_KPP\_V28](#ga3a970b4b0fa2fc405cbdb8646a27a580)   0xE2                                                                     |
| #define | [MAX\_SCRIPT\_NAME](#gabdc146eea2ff373e4a6fb2ae534c8ca8)   9                                                                                    |
| #define | [D\_MAX](#ga80559d0c68c2da7e9f75937fd154a93c)   521                                                                                             |
| #define | [D\_MAX](#ga80559d0c68c2da7e9f75937fd154a93c)   521                                                                                             |

### DetailedDescription <a href="#detailed-description" id="detailed-description"></a>

### MacroDefinition Documentation <a href="#macro-definition-documentation" id="macro-definition-documentation"></a>

### D\_MAX\[1/2] <a href="#ga80559d0c68c2da7e9f75937fd154a93c" id="ga80559d0c68c2da7e9f75937fd154a93c"></a>

\#define D\_MAX   521

### D\_MAX\[2/2] <a href="#ga80559d0c68c2da7e9f75937fd154a93c" id="ga80559d0c68c2da7e9f75937fd154a93c"></a>

\#define D\_MAX   521

### DECRYPT\_CBC\_ITERATION <a href="#ga286799b6e4775a2000f8f23a3deae819" id="ga286799b6e4775a2000f8f23a3deae819"></a>

\#define DECRYPT\_CBC\_ITERATION   (0x53)

### DECRYPT\_FINISH <a href="#ga23484114a161add6102ec674917c0666" id="ga23484114a161add6102ec674917c0666"></a>

\#define DECRYPT\_FINISH   (0x52)

### DECRYPT\_INIT <a href="#ga9dda1955fda005d373617cea91fa60fb" id="ga9dda1955fda005d373617cea91fa60fb"></a>

\#define DECRYPT\_INIT   (0x50)

### DECRYPT\_ITERATION <a href="#ga0f890003acddc5ab054f9be9bb9c4638" id="ga0f890003acddc5ab054f9be9bb9c4638"></a>

\#define DECRYPT\_ITERATION   (0x51)

### ENCRYPT\_CBC\_ITERATION <a href="#ga03e6109541a1e1f33087fcc8cacefbfb" id="ga03e6109541a1e1f33087fcc8cacefbfb"></a>

\#define ENCRYPT\_CBC\_ITERATION   (0x43)

### ENCRYPT\_FINISH <a href="#ga2ab5d4276702a3de7d567eb055f911f4" id="ga2ab5d4276702a3de7d567eb055f911f4"></a>

\#define ENCRYPT\_FINISH   (0x42)

### ENCRYPT\_INIT <a href="#ga8b6f0172ea31c17b9d7aa5784c2b651a" id="ga8b6f0172ea31c17b9d7aa5784c2b651a"></a>

\#define ENCRYPT\_INIT   (0x40)

### ENCRYPT\_ITERATION <a href="#gadef6432b1d8f7ad14a2ba8f13f9f7a32" id="gadef6432b1d8f7ad14a2ba8f13f9f7a32"></a>

\#define ENCRYPT\_ITERATION   (0x41)

### GET\_NEW\_DUKPT <a href="#ga7af69135d805e5206cf42c8783c9c8f9" id="ga7af69135d805e5206cf42c8783c9c8f9"></a>

\#define GET\_NEW\_DUKPT   (0x28)

### ISO\_0\_PREPARE <a href="#gab0401f08b432090d24c08d693c24623f" id="gab0401f08b432090d24c08d693c24623f"></a>

\#define ISO\_0\_PREPARE   (0x71)

### ISO\_0\_PREPARE\_PIN\_0 <a href="#gaf2d8b3378e65c59be442b014f2b8d778" id="gaf2d8b3378e65c59be442b014f2b8d778"></a>

\#define ISO\_0\_PREPARE\_PIN\_0   (0x80)

### ISO\_1\_PREPARE <a href="#ga00b2e946cd1be6cf52c2c7a4053dfbe1" id="ga00b2e946cd1be6cf52c2c7a4053dfbe1"></a>

\#define ISO\_1\_PREPARE   (0x72)

### ISO\_1\_PREPARE\_PIN\_0 <a href="#ga39c55220e84204f89781f2d6de3f6816" id="ga39c55220e84204f89781f2d6de3f6816"></a>

\#define ISO\_1\_PREPARE\_PIN\_0   (0x81)

### ISO\_2\_PREPARE <a href="#gacea965f7ae6b742e08f5b58bb3d5662f" id="gacea965f7ae6b742e08f5b58bb3d5662f"></a>

\#define ISO\_2\_PREPARE   (0x73)

### ISO\_2\_PREPARE\_PIN\_0 <a href="#ga9d809956812d078bd317d5ea51d3a3b7" id="ga9d809956812d078bd317d5ea51d3a3b7"></a>

\#define ISO\_2\_PREPARE\_PIN\_0   (0x82)

### ISO\_3\_PREPARE <a href="#ga8f23d658f785f47190fec967d9783060" id="ga8f23d658f785f47190fec967d9783060"></a>

\#define ISO\_3\_PREPARE   (0x74)

### ISO\_3\_PREPARE\_PIN\_0 <a href="#gaf265eb037a8e3c00a57d1e62a5ee1d95" id="gaf265eb037a8e3c00a57d1e62a5ee1d95"></a>

\#define ISO\_3\_PREPARE\_PIN\_0   (0x83)

### LOAD\_DUKPT\_KEY <a href="#ga2f8314814320e4351da7667a05351b91" id="ga2f8314814320e4351da7667a05351b91"></a>

\#define LOAD\_DUKPT\_KEY   (0x10)

### LOAD\_KEY\_DEC\_DATA\_MSK <a href="#gae278ff558bc8dff84e612dc0d3e1ae4f" id="gae278ff558bc8dff84e612dc0d3e1ae4f"></a>

\#define LOAD\_KEY\_DEC\_DATA\_MSK   (0x18)

### LOAD\_KEY\_ENC\_DATA\_MSK <a href="#gac44d638245acd1064fa841bf75d68cfe" id="gac44d638245acd1064fa841bf75d68cfe"></a>

\#define LOAD\_KEY\_ENC\_DATA\_MSK   (0x15)

### LOAD\_KEY\_GEN\_MAC\_MSK <a href="#gadbaeedb2248878267eef9b883e441514" id="gadbaeedb2248878267eef9b883e441514"></a>

\#define LOAD\_KEY\_GEN\_MAC\_MSK   (0x17)

### LOAD\_KEY\_KEK\_MSK <a href="#ga2abc8361ea15929c0ec2ff73e27bfb36" id="ga2abc8361ea15929c0ec2ff73e27bfb36"></a>

\#define LOAD\_KEY\_KEK\_MSK   (0x1A)

### LOAD\_KEY\_PIN\_MSK <a href="#ga9da65fd69ba099e1d6a5e9c63c0fd3fa" id="ga9da65fd69ba099e1d6a5e9c63c0fd3fa"></a>

\#define LOAD\_KEY\_PIN\_MSK   (0x16)

### LOAD\_KEY\_VER\_MAC\_MSK <a href="#gaaf79eb5edf10c8202dcfe8876baedf26" id="gaaf79eb5edf10c8202dcfe8876baedf26"></a>

\#define LOAD\_KEY\_VER\_MAC\_MSK   (0x19)

### LOAD\_TMK\_KEY <a href="#ga84c44483f34c0d84f9417f64565115ed" id="ga84c44483f34c0d84f9417f64565115ed"></a>

\#define LOAD\_TMK\_KEY   (0x11)

### MAC\_GENERATE\_FINISH <a href="#ga5cb7f35bc0bdfe24ac0f5047fac450d4" id="ga5cb7f35bc0bdfe24ac0f5047fac450d4"></a>

\#define MAC\_GENERATE\_FINISH   (0x62)

### MAC\_GENERATE\_INIT <a href="#ga85df78895c20a18314d6850ce625e374" id="ga85df78895c20a18314d6850ce625e374"></a>

\#define MAC\_GENERATE\_INIT   (0x60)

### MAC\_GENERATE\_ITERATION <a href="#ga24f89abac32c71a7d6f7f2e07a3c69a9" id="ga24f89abac32c71a7d6f7f2e07a3c69a9"></a>

\#define MAC\_GENERATE\_ITERATION   (0x61)

### MAC\_VERIFY\_FINISH <a href="#ga0ef87de359bc3cc2ca1e28e6ace768ae" id="ga0ef87de359bc3cc2ca1e28e6ace768ae"></a>

\#define MAC\_VERIFY\_FINISH   (0x65)

### MAC\_VERIFY\_INIT <a href="#ga86701406c0b8568a4e3c56342e3a4a5e" id="ga86701406c0b8568a4e3c56342e3a4a5e"></a>

\#define MAC\_VERIFY\_INIT   (0x63)

### MAC\_VERIFY\_ITERATION <a href="#gaa40c8ef7083d0257720ff3dcbf8aabb9" id="gaa40c8ef7083d0257720ff3dcbf8aabb9"></a>

\#define MAC\_VERIFY\_ITERATION   (0x64)

### MACRO\_CLEAR\_IV <a href="#ga34216860584b51097a07abe8a8bfd3e8" id="ga34216860584b51097a07abe8a8bfd3e8"></a>

\#define MACRO\_CLEAR\_IV   0xB1

### MACRO\_COMPUTE\_KIA <a href="#ga3879e6c5999e10831396eb49c5eef807" id="ga3879e6c5999e10831396eb49c5eef807"></a>

\#define MACRO\_COMPUTE\_KIA   0xC2

### MACRO\_COMPUTE\_KMACI <a href="#gab0a816007427bc3ea0d6f6c55e8d9f4d" id="gab0a816007427bc3ea0d6f6c55e8d9f4d"></a>

\#define MACRO\_COMPUTE\_KMACI   0xC5

### MACRO\_COMPUTE\_MAC\_ACQ\_MKEYS <a href="#ga3b986cd0e3d383795e565d2454ab2398" id="ga3b986cd0e3d383795e565d2454ab2398"></a>

\#define MACRO\_COMPUTE\_MAC\_ACQ\_MKEYS   0xC6

### MACRO\_DECRYPT\_KSK <a href="#gab598cbc3e161e5527d6f1a690488661c" id="gab598cbc3e161e5527d6f1a690488661c"></a>

\#define MACRO\_DECRYPT\_KSK   0xB3

### MACRO\_ENCRYPT\_KSK <a href="#gadf2cebcad2bc2e1912538539fc13780b" id="gadf2cebcad2bc2e1912538539fc13780b"></a>

\#define MACRO\_ENCRYPT\_KSK   0xB2

### MACRO\_GENERATE\_KI <a href="#ga86fed5f3892bf79d171611fd107bdea3" id="ga86fed5f3892bf79d171611fd107bdea3"></a>

\#define MACRO\_GENERATE\_KI   0xB9

### MACRO\_LOAD\_RSA\_SLOT\_4 <a href="#gacffc4b58b7e3fdc12cce07393cb9637f" id="gacffc4b58b7e3fdc12cce07393cb9637f"></a>

\#define MACRO\_LOAD\_RSA\_SLOT\_4   0xBA

### MACRO\_LOAD\_RSA\_SLOT\_5 <a href="#ga0b97763de72b193f006ec1afd8d9991b" id="ga0b97763de72b193f006ec1afd8d9991b"></a>

\#define MACRO\_LOAD\_RSA\_SLOT\_5   0xBB

### MACRO\_RETRIEVE\_DATETIME <a href="#ga78e4cd082f6cb81b324a23a7d61ecc3c" id="ga78e4cd082f6cb81b324a23a7d61ecc3c"></a>

\#define MACRO\_RETRIEVE\_DATETIME   0xB8

### MACRO\_RETRIEVE\_eKEK1\_PPASN <a href="#gae05304ea913d5efdabbb48e7e68a7b12" id="gae05304ea913d5efdabbb48e7e68a7b12"></a>

\#define MACRO\_RETRIEVE\_eKEK1\_PPASN   0xD3

### MACRO\_RETRIEVE\_eKEK2\_PPASN <a href="#ga59050825a5df2553e0db52690effe87f" id="ga59050825a5df2553e0db52690effe87f"></a>

\#define MACRO\_RETRIEVE\_eKEK2\_PPASN   0xD4

### MACRO\_RETRIEVE\_ENC\_PPID <a href="#ga0f52f7ec9339fa97e562293a9fb05aaa" id="ga0f52f7ec9339fa97e562293a9fb05aaa"></a>

\#define MACRO\_RETRIEVE\_ENC\_PPID   0xC3

### MACRO\_RETRIEVE\_KVC\_KEK1 <a href="#ga33e6d63a0483541e1a6856be4a3c1925" id="ga33e6d63a0483541e1a6856be4a3c1925"></a>

\#define MACRO\_RETRIEVE\_KVC\_KEK1   0xD2

### MACRO\_RETRIEVE\_KVC\_KIA <a href="#ga407312cbba92b1160a4c767f941cdf5c" id="ga407312cbba92b1160a4c767f941cdf5c"></a>

\#define MACRO\_RETRIEVE\_KVC\_KIA   0xC4

### MACRO\_RETRIEVE\_PPID <a href="#ga4be5ce903079bf3d5be7ae1440fa5b65" id="ga4be5ce903079bf3d5be7ae1440fa5b65"></a>

\#define MACRO\_RETRIEVE\_PPID   0xB4

### MACRO\_RETRIEVE\_RN <a href="#ga209f18fd4109457287f2fd79c557f171" id="ga209f18fd4109457287f2fd79c557f171"></a>

\#define MACRO\_RETRIEVE\_RN   0xB6

### MACRO\_RETRIEVE\_STATUS <a href="#ga9555597847d1ff329ee5de359d2b0814" id="ga9555597847d1ff329ee5de359d2b0814"></a>

\#define MACRO\_RETRIEVE\_STATUS   0xB0

### MACRO\_ROLL\_KEK1 <a href="#ga64845bce0261fda7a642832e3fd243af" id="ga64845bce0261fda7a642832e3fd243af"></a>

\#define MACRO\_ROLL\_KEK1   0xD5

### MACRO\_ROLL\_KEK2 <a href="#ga8096ea6536b1f3413e29699f2a8b26bf" id="ga8096ea6536b1f3413e29699f2a8b26bf"></a>

\#define MACRO\_ROLL\_KEK2   0xD6

### MACRO\_RSA\_CALC\_SLOT\_4 <a href="#ga2d6440e0dca64696339b0f6df7878b5b" id="ga2d6440e0dca64696339b0f6df7878b5b"></a>

\#define MACRO\_RSA\_CALC\_SLOT\_4   0xBC

### MACRO\_RSA\_CALC\_SLOT\_5 <a href="#gaa54f0b04fd8994c65d196e00b3e39144" id="gaa54f0b04fd8994c65d196e00b3e39144"></a>

\#define MACRO\_RSA\_CALC\_SLOT\_5   0xBD

### MACRO\_SELECT\_KEY\_SET\_ID\_1 <a href="#ga720cc8ec469e36af59973ec62fc95702" id="ga720cc8ec469e36af59973ec62fc95702"></a>

\#define MACRO\_SELECT\_KEY\_SET\_ID\_1   0xC7

select KeySet Macro for ksid=1 and version=1. No input parameters.

### MACRO\_SELECT\_KEY\_SET\_ID\_2 <a href="#ga026455d05e3db8eee131e81f1b73a171" id="ga026455d05e3db8eee131e81f1b73a171"></a>

\#define MACRO\_SELECT\_KEY\_SET\_ID\_2   0xC8

select KeySet Macro for ksid=2 and version=1. No input parameters.

### MACRO\_SELECT\_KEY\_SET\_ID\_3 <a href="#gacd684d770244e27ad3ffd89c40cf4c5f" id="gacd684d770244e27ad3ffd89c40cf4c5f"></a>

\#define MACRO\_SELECT\_KEY\_SET\_ID\_3   0xC9

select KeySet Macro for ksid=3 and version=1. No input parameters.

### MACRO\_SELECT\_KEY\_SET\_ID\_4 <a href="#ga4939047f2ecc51a26d01049eac766202" id="ga4939047f2ecc51a26d01049eac766202"></a>

\#define MACRO\_SELECT\_KEY\_SET\_ID\_4   0xCA

select KeySet Macro for ksid=4 and version=1. No input parameters.

### MACRO\_SELECT\_KEY\_SET\_ID\_5 <a href="#ga0c1873c097c088a490799c0a85e99435" id="ga0c1873c097c088a490799c0a85e99435"></a>

\#define MACRO\_SELECT\_KEY\_SET\_ID\_5   0xCB

select KeySet Macro for ksid=5 and version=1. No input parameters.

### MACRO\_SELECT\_KEY\_SET\_ID\_6 <a href="#ga848afe390caa06816c951a5b03becb68" id="ga848afe390caa06816c951a5b03becb68"></a>

\#define MACRO\_SELECT\_KEY\_SET\_ID\_6   0xCC

select KeySet Macro for ksid=6 and version=1. No input parameters.

### MACRO\_SELECT\_KEY\_SET\_ID\_7 <a href="#gab79e7d05864c8a2016482542ba776775" id="gab79e7d05864c8a2016482542ba776775"></a>

\#define MACRO\_SELECT\_KEY\_SET\_ID\_7   0xCD

select KeySet Macro for ksid=7 and version=1. No input parameters.

### MACRO\_SELECT\_KEY\_SET\_ID\_8 <a href="#ga392ad9e8494ee717ef2b8a63220ed19f" id="ga392ad9e8494ee717ef2b8a63220ed19f"></a>

\#define MACRO\_SELECT\_KEY\_SET\_ID\_8   0xCE

select KeySet Macro for ksid=8 and version=1. No input parameters.

### MACRO\_SELECT\_KEY\_SET\_ID\_MAX <a href="#ga0357d5563c50c72b7b57da0e002c6895" id="ga0357d5563c50c72b7b57da0e002c6895"></a>

\#define MACRO\_SELECT\_KEY\_SET\_ID\_MAX   \[MACRO\_SELECT\_KEY\_SET\_ID\_8]\(#ga392ad9e8494ee717ef2b8a63220ed19f)

used to check limitation of select KeySet Macros

### MACRO\_SELECT\_KEY\_SET\_ID\_X <a href="#ga9aa98a84182f89bbb537c5290eaecc69" id="ga9aa98a84182f89bbb537c5290eaecc69"></a>

\#define MACRO\_SELECT\_KEY\_SET\_ID\_X   \[MACRO\_SELECT\_KEY\_SET\_ID\_1]\(#ga720cc8ec469e36af59973ec62fc95702)

select KeySet Macro for all ksid and version=2. input parameter: ksid.

### MACRO\_STORE\_AIIC <a href="#ga8618ca26da69f4fae99115db11ea3335" id="ga8618ca26da69f4fae99115db11ea3335"></a>

\#define MACRO\_STORE\_AIIC   0xC1

### MACRO\_STORE\_DATETIME <a href="#gadca81798d3b3ceee1a49c232e70e0bdf" id="gadca81798d3b3ceee1a49c232e70e0bdf"></a>

\#define MACRO\_STORE\_DATETIME   0xB7

### MACRO\_STORE\_eKEK1\_KDr <a href="#ga2f8351b863eed3195f6566528b7f4d5b" id="ga2f8351b863eed3195f6566528b7f4d5b"></a>

\#define MACRO\_STORE\_eKEK1\_KDr   0xDB

### MACRO\_STORE\_eKEK1\_KDs <a href="#ga3815b76ae48c95905ccfa0d51a75dd71" id="ga3815b76ae48c95905ccfa0d51a75dd71"></a>

\#define MACRO\_STORE\_eKEK1\_KDs   0xDD

### MACRO\_STORE\_eKEK1\_KMACr <a href="#ga1ba8fbbb557d5468e3bfa29f678de92b" id="ga1ba8fbbb557d5468e3bfa29f678de92b"></a>

\#define MACRO\_STORE\_eKEK1\_KMACr   0xD7

### MACRO\_STORE\_eKEK1\_KMACs <a href="#ga459e37334b9fc250f27aec4842e29ab8" id="ga459e37334b9fc250f27aec4842e29ab8"></a>

\#define MACRO\_STORE\_eKEK1\_KMACs   0xD9

### MACRO\_STORE\_eKEK1\_KPP\_V28 <a href="#ga42b31435e83343186a3a322764171977" id="ga42b31435e83343186a3a322764171977"></a>

\#define MACRO\_STORE\_eKEK1\_KPP\_V28   0xE0

### MACRO\_STORE\_eKEK1\_KPP\_V42 <a href="#gaa78c758b046f92a8e04e35328b33c869" id="gaa78c758b046f92a8e04e35328b33c869"></a>

\#define MACRO\_STORE\_eKEK1\_KPP\_V42   0xDF

### MACRO\_STORE\_eKEK2\_KDr <a href="#ga2d2cb27c26d363a3791cbca7bb354a73" id="ga2d2cb27c26d363a3791cbca7bb354a73"></a>

\#define MACRO\_STORE\_eKEK2\_KDr   0xDC

### MACRO\_STORE\_eKEK2\_KDs <a href="#gaf3e56a39969d1a6944c33ff1e827dd24" id="gaf3e56a39969d1a6944c33ff1e827dd24"></a>

\#define MACRO\_STORE\_eKEK2\_KDs   0xDE

### MACRO\_STORE\_eKEK2\_KMACr <a href="#ga778fe1dddee857344c6e72bc8fc67092" id="ga778fe1dddee857344c6e72bc8fc67092"></a>

\#define MACRO\_STORE\_eKEK2\_KMACr   0xD8

### MACRO\_STORE\_eKEK2\_KMACs <a href="#gaaa7b26e0f63be6065aa68b3a3cb7cb7e" id="gaaa7b26e0f63be6065aa68b3a3cb7cb7e"></a>

\#define MACRO\_STORE\_eKEK2\_KMACs   0xDA

### MACRO\_STORE\_eKEK2\_KPP\_V28 <a href="#ga3a970b4b0fa2fc405cbdb8646a27a580" id="ga3a970b4b0fa2fc405cbdb8646a27a580"></a>

\#define MACRO\_STORE\_eKEK2\_KPP\_V28   0xE2

### MACRO\_STORE\_eKEK2\_KPP\_V42 <a href="#gaccbbb626e498abd3b78c3fd9655de6ea" id="gaccbbb626e498abd3b78c3fd9655de6ea"></a>

\#define MACRO\_STORE\_eKEK2\_KPP\_V42   0xE1

### MACRO\_STORE\_KCA <a href="#gaaf4a0220291a3daecae73fbed2d39c2a" id="gaaf4a0220291a3daecae73fbed2d39c2a"></a>

\#define MACRO\_STORE\_KCA   0xBE

### MACRO\_STORE\_KCA\_V44 <a href="#gac946bb139c7f8a7ba259f509aecb5323" id="gac946bb139c7f8a7ba259f509aecb5323"></a>

\#define MACRO\_STORE\_KCA\_V44   0xBF

### MACRO\_STORE\_KEK1 <a href="#gabc8dda11a9c7e5a3bebd90821f7d88c1" id="gabc8dda11a9c7e5a3bebd90821f7d88c1"></a>

\#define MACRO\_STORE\_KEK1   0xCF

### MACRO\_STORE\_KEK2 <a href="#gace90185513e8afec78481117fdcb5422" id="gace90185513e8afec78481117fdcb5422"></a>

\#define MACRO\_STORE\_KEK2   0xD0

### MACRO\_STORE\_KMACH <a href="#gae9bd22333a3f4056b37defb29cd22903" id="gae9bd22333a3f4056b37defb29cd22903"></a>

\#define MACRO\_STORE\_KMACH   0xC0

### MACRO\_STORE\_PPASN <a href="#ga4600092e676f01de5b49179662536616" id="ga4600092e676f01de5b49179662536616"></a>

\#define MACRO\_STORE\_PPASN   0xD1

### MACRO\_STORE\_RN <a href="#gaa1b177bb54992520d6d2f7a6e965d2bc" id="gaa1b177bb54992520d6d2f7a6e965d2bc"></a>

\#define MACRO\_STORE\_RN   0xB5

### MAX\_SCRIPT\_NAME <a href="#gabdc146eea2ff373e4a6fb2ae534c8ca8" id="gabdc146eea2ff373e4a6fb2ae534c8ca8"></a>

\#define MAX\_SCRIPT\_NAME   9

### PIN\_CANCEL <a href="#ga5cf897892e478bad3ca024677db9651d" id="ga5cf897892e478bad3ca024677db9651d"></a>

\#define PIN\_CANCEL   (0x77)

### PIN\_FINISH <a href="#gab26fba5550fe958a8d95fa51a700cc38" id="gab26fba5550fe958a8d95fa51a700cc38"></a>

\#define PIN\_FINISH   (0x76)

### PIN\_INIT <a href="#ga66a8f8bb1534842a3e7cab64637fef1f" id="ga66a8f8bb1534842a3e7cab64637fef1f"></a>

\#define PIN\_INIT   (0x70)

### PIN\_ITERATION <a href="#ga78fe99462d905bd0aa6f43e50052c1ed" id="ga78fe99462d905bd0aa6f43e50052c1ed"></a>

\#define PIN\_ITERATION   (0x75)

### SCRIPT\_CHECK\_INIT <a href="#ga6f0b4e52bf562c5a7496865d4dffadb6" id="ga6f0b4e52bf562c5a7496865d4dffadb6"></a>

\#define SCRIPT\_CHECK\_INIT   (0x33)

### SCRIPT\_GET\_KEY\_SET\_INIT <a href="#ga4c974ae980ab4b8813673b5b555836b8" id="ga4c974ae980ab4b8813673b5b555836b8"></a>

\#define SCRIPT\_GET\_KEY\_SET\_INIT   (0x32)

### SCRIPT\_INIT <a href="#gae1bdf3a721db08a56686cdc1fbd1a396" id="gae1bdf3a721db08a56686cdc1fbd1a396"></a>

\#define SCRIPT\_INIT   (0x30)

### SET\_DUKPT\_MASK <a href="#ga3a5d8d8353446c85f08767651812963b" id="ga3a5d8d8353446c85f08767651812963b"></a>

\#define SET\_DUKPT\_MASK   (0x29)

### START\_TRANSACTION <a href="#gaf1654585c80282f2dc54a9d16b915e6c" id="gaf1654585c80282f2dc54a9d16b915e6c"></a>

\#define START\_TRANSACTION   (0x28)

### TEST\_DUKPT\_ENGINE <a href="#ga790e4a13adc7aec51a64ef5b360dfb3e" id="ga790e4a13adc7aec51a64ef5b360dfb3e"></a>

\#define TEST\_DUKPT\_ENGINE   (0x39)

### TEST\_KEY\_FOR\_DATA <a href="#gac7cddf4fea9c3a9797bcbcdd5d5dd91c" id="gac7cddf4fea9c3a9797bcbcdd5d5dd91c"></a>

\#define TEST\_KEY\_FOR\_DATA   (0x36)

### TEST\_KEY\_FOR\_MAC <a href="#ga04aa97a435b4d74bf669e639ae6b15fb" id="ga04aa97a435b4d74bf669e639ae6b15fb"></a>

\#define TEST\_KEY\_FOR\_MAC   (0x38)

### TEST\_KEY\_FOR\_PIN <a href="#ga44579064b0c0e6fff38ff82012880edc" id="ga44579064b0c0e6fff38ff82012880edc"></a>

\#define TEST\_KEY\_FOR\_PIN   (0x37)

### TEST\_TMK\_ENGINE <a href="#ga95182c9326b061c4c55a66f50a2a0c56" id="ga95182c9326b061c4c55a66f50a2a0c56"></a>

\#define TEST\_TMK\_ENGINE   (0x35)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://sandbox-docs.verifone.com/adk-5.0-programmers-guide/readme/modules/group__vss.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.