> 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/s-adk-5.1-programmers-guide/readme/modules/group__sdiemvct.md). # EMV contact interface [Data Structures](#nested-classes) | [Functions](#func-members) | | | | --------------- | -------------------------------------------------------------------------------------- | | Data Structures | | | struct | [SDIClient::CTCandidateData](#structvfisdi_1_1_s_d_i_client_1_1_c_t_candidate_data) | | struct | [SDIClient::CTCandidate](#structvfisdi_1_1_s_d_i_client_1_1_c_t_candidate) | | struct | [SDIClient::AdditionalCardTag](#structvfisdi_1_1_s_d_i_client_1_1_additional_card_tag) | | | | | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Functions | | | int | [emvCtInit](#gad6711aee99833a043d48f3e8fee06bfe) (int aidCount=0, unsigned options=0) | | int | [emvCtExit](#gae22aec496c1680b13a01aa24479ef01a) (unsigned options=0) | | int | [emvCtSetTermData](#gaff02863da38410b9eee8353969430986) (const [EMVConf](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_conf.md) \&emv) | | int | [emvCtGetTermData](#gaf1c30d9a23a3e9efa1be3a980b9dbaf9) ([EMVConf](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_conf.md) \&emv) | | int | [emvCtSetAppData](#gad482a37b1082d447a9e161ade0227866) (const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&aid, const [EMVConf](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_conf.md) \&emv) | | int | [emvCtClearAppData](#gabeb9eb402b2eb472d9669cb539d70c21) (const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&aid) | | int | [emvCtClearAllAppData](#ga15d5acbf680a16bb9fa58146232bd53d) () | | int | [emvCtSetTempAppData](#ga008b2dddcc79d3243e8e78d508c51831) (const [EMVConf](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_conf.md) \&emv) | | int | [emvCtGetAppData](#ga3dfc457cefe50113a11c938966acc7ca) (const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&aid, [EMVConf](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_conf.md) \&emv) | | int | [emvCtGetAppData](#ga0cdd403f2839699d757edbd1079f2996) (bool first, [EMVConf](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_conf.md) \&emv) | | int | [emvCtSetCAPKey](#ga25113df529675bc6620bd099ed4a0316) (const [Array](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_array.md)< 5 > \&rid, unsigned char index, const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&key, unsigned char exp, const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&hash=[bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5)(), const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&revocationlist=[bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5)()) | | int | [emvCtClearCAPKey](#ga3237b8c051cba8a9de6bb7b1deb2d9b4) (const [Array](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_array.md)< 5 > \&rid, unsigned char index) | | int | [emvCtClearAllCAPKey](#ga6acbc3afd9b3684c2408f33dc7adb511) () | | int | [emvCtGetCAPKeys](#ga6893b0ae2ebb1d3acdfd73f34257dedb) (std::vector< [CAPKeyInfo](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#structvfisdi_1_1_s_d_i_client_1_1_c_a_p_key_info) > \&keys) | | int | [emvCtApplyConfig](#ga9fa6b39a32dac9e3dace2da24b13ef28) (unsigned options=0) | | int | [emvCtAddVirtualMapEntry](#gaed1f434e83f7bad87bd10297db1f46e1) (int transaction, int currency, unsigned char vterminal) | | int | [emvCtClearVirtualMap](#ga941c47f8f9d3650dadcc9da8eac4790f) () | | int | [emvCtSmartDetect](#ga76e3cfe87f8b9f377bb3f513fe8b85a8) (int timeout\_ms) | | int | [emvCtActivate](#ga1b64520292eb100379a66506410e1498) ([bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \*atr=0) | | int | [emvCtActivate](#gaac201fa1058ad58716d5d71459689f26) (unsigned options, [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \*atr=0) | | int | [emvCtDeactivate](#gad4b483aedd67eed8acba2de9401a4e5e) () | | int | [emvCtDeactivate](#gac72e99d5553cb089389f210f79a92148) (unsigned options) | | int | [emvCtStartTransaction](#ga7d82aeffa340e1da5b83f494b7814567) ([EMVTxn](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_txn.md) \&out, [EMVTransaction](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a36a1ebacbf82d10a5db76377f8e225fd) type, const [BCD](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_b_c_d.md)< 6 > amount, const [Array](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_array.md)< 3 > \&date, const [Array](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_array.md)< 3 > \&time, const [BCD](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_b_c_d.md)< 4 > \&counter, const [EMVTxn](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_txn.md) \&optional=[EMVTxn](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_txn.md)()) | | int | [emvCtContinueOffline](#ga86ab37913621b426168287bd056b65e0) ([EMVTxn](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_txn.md) \&out, const [EMVTxn](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_txn.md) \&optional=[EMVTxn](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_txn.md)()) | | int | [emvCtContinueOnline](#gaee89fc9dd333bb118002d81a31dd3dc0) ([EMVTxn](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_txn.md) \&out, bool onlineResult, const [Array](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_array.md)< 2 > \&authResp=[Array](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_array.md)< 2 >(), const [EMVTxn](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_txn.md) \&optional=[EMVTxn](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_txn.md)()) | | int | [emvCtUpdateTxnTags](#ga6c8b8d13261c96bd437fe3d0d2276730) (unsigned options, const [EMVTxn](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/structvfisdi_1_1_e_m_v_txn.md) \&config) | | int | [emvCtEndTransaction](#gab395504ca5ba10279b3d2558d8f2f445) (unsigned options=0) | | int | [emvCtGetCandidateData](#ga6c08e41791ce0350c0d60cc3bff270c3) (std::vector< [CTCandidateData](#structvfisdi_1_1_s_d_i_client_1_1_c_t_candidate_data) > \&out) | | int | [emvCtSendOfflinePIN](#ga747fff73942aeb4dd3044e21b92fe2f6) (unsigned short \&chipresult) | | int | [emvCtCheckSupportedAID](#gaefc0a540fb8dca7dc8963b38d12483dd) (const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&aid, unsigned char asi, const std::string \&defaultLabel, std::vector< [CTCandidate](#structvfisdi_1_1_s_d_i_client_1_1_c_t_candidate) > \&candlist, unsigned short \*sw12=0, const std::vector< [AdditionalCardTag](#structvfisdi_1_1_s_d_i_client_1_1_additional_card_tag) > \*adtCrdTags=0) | | int | [emvCtLED](#gaec12efc7ee796e4568cacad0563a8e4c) (bool ledState) | | int | [emvCtSendReceive](#gae7159a6fea1148a5b5cd55d5b92ada80) (unsigned options, const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&in, [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&out) | ### DetailedDescription *** ### DataStructure Documentation ### vfisdi::SDIClient::CTCandidateData struct vfisdi::SDIClient::CTCandidateData EMV CT candidate data | | | | | -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | --------------- | | Data Fields | | | | unsigned char | aidLen | (9F06) | | unsigned char | api |

(87)

| | [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) | asf | (DF62) | | string | bic | (5F54) | | unsigned char | codeTableIndex | (9F11) | | unsigned char | country2\[2] | (5F55) | | unsigned char | country3\[3] | (5F56) | | string | iban | (5F33) | | unsigned char | iin\[4] |

(42)

| | [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) | selData | (9F0A) | ### vfisdi::SDIClient::CTCandidate struct vfisdi::SDIClient::CTCandidate | | | | | -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Data Fields | | | | [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.1_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) | aid | AID returned by the card (4F) | | unsigned char | api | Application priority indicator (87) | | unsigned char | codeTableIndex |

character code table index (Value '1' - 'A') or 0 = not specified (ISO 8859) (9F11)
indicator which label went to text: EMVL2\_DFLTXT=0x80 for default label EMVL2\_APPLBL=0x40 for application preferred name ('9F12') EMVL2\_APPLBL=0x20 for application label ('50')

| | unsigned char | languagePref | language preference, converted to small letters (5F2D) | | string | text | text supplied by app (50) | | string | text2 | secondary text field (DF3B) | ### vfisdi::SDIClient::AdditionalCardTag struct vfisdi::SDIClient::AdditionalCardTag additional card tag entry for additional tag store configuration | | | | | -------------------------------------------------------------------------------------------------------------- | ------ | ------------------- | | Data Fields | | | | unsigned char | maxLen | maximun data length | | unsigned char | minLen | minimum data length | | unsigned | tag | tag number | | [EMVType](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a20ad31c9a6f36fcc40996394873fa695) | type | type of data | ### FunctionDocumentation ### emvCtActivate()\[1/2] int emvCtActivate Activate smart card (41-02) **Parameters** \[out] **atr** if not NULL, the ATR is returned here #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) ### emvCtActivate()\[2/2] int emvCtActivate Activate smart card (41-02) **Parameters** \[in] **options** bit mask with options from EMVCtReaderOptions (DF06) \[out] **atr** if not NULL, the ATR is returned here #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) ### emvCtAddVirtualMapEntry() int emvCtAddVirtualMapEntry Add an entry to the CT virtual map. If an entry in the virtual map matches the transaction and currency, switch to the virtual terminal *vterminal*. Use -1 as wildcard for *transaction* or *currency* to match all. (39-06) **Parameters** \[in] **transaction** transaction type (EMVTransaction) or -1 \[in] **currency** currency (Currency) or -1 \[in] **vterminal** virtual terminal number to switch to in case of a match #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) {% hint style="info" %} The wildcard -1 cannot be used for both *transaction* and *currency* at the same time. {% endhint %} ### emvCtApplyConfig() int emvCtApplyConfig Store configuration (39-04) **Parameters** \[in] **options** options #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtCheckSupportedAID() int emvCtCheckSupportedAID Do List Of Application processing for a single terminal AID. (39-17) **Parameters** \[in] **aid** terminal AID \[in] **asi** application selection indicator 0=exact, 1=partial \[in] **defaultLabel** optional default application label \[out] **candlist** candidates found \[out] **sw12** if not NULL status word returned by card '0000' for communication problem \[in] **adtCrdTags** optional list of additional tags to be stored in tag store #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtClearAllAppData() int emvCtClearAllAppData clear all EMV CT application data (39-02) #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtClearAllCAPKey() int emvCtClearAllCAPKey clear all EMV CT CAP keys (39-03) #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtClearAppData() int emvCtClearAppData clear EMV CT application data (39-02) **Parameters** \[in] **aid** AID that is to be cleared #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtClearCAPKey() int emvCtClearCAPKey clear EMV CT CAP key (39-03) **Parameters** \[in] **rid** key register identifier \[in] **index** key index #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtClearVirtualMap() int emvCtClearVirtualMap remove all entries from virtual map (39-06) #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtContinueOffline() int emvCtContinueOffline continue offline EMV CT transaction (39-11) **Parameters** \[out] **out** transaction result data \[in] **optional** optional transaction parameters, these may be used to change #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtContinueOnline() int emvCtContinueOnline continue online EMV CT transaction (39-12) **Parameters** \[out] **out** transaction result data \[in] **onlineResult** online result, true if transaction was successful, false if not (DF50) \[in] **authResp** authorization response code from the host, ignored if onlineResult==false (8A) \[in] **optional** optional transaction parameters #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtDeactivate()\[1/2] int emvCtDeactivate Deactivate smart card (41-04) #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) ### emvCtDeactivate()\[2/2] int emvCtDeactivate Deactivate smart card (41-04) **Parameters** \[in] **options** bit mask with options from EMVCtReaderOptions (DF06) #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) ### emvCtEndTransaction() int emvCtEndTransaction End transaction (39-15) **Parameters** \[in] **options** reserved for future use #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtExit() int emvCtExit exit EMV CTLS framework (39-00) **Parameters** \[in] **options** EMV options #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtGetAppData()\[1/2] int emvCtGetAppData get EMV CT application data of first / next AID (39-02) **Parameters** \[in] **first** if true get data of first AID, if false get data of next AID \[out] **emv** EMV application data #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtGetAppData()\[2/2] int emvCtGetAppData get EMV CT application data (39-02) **Parameters** \[in] **aid** AID \[out] **emv** EMV application data #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtGetCandidateData() int emvCtGetCandidateData get additional candidate information for reducing, resorting or displaying the mutual candidate list. (39-16) **Parameters** \[out] **out** transaction result data #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtGetCAPKeys() int emvCtGetCAPKeys read EMV CT CAP key information (39-03) **Parameters** \[out] **keys** key information #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtGetTermData() int emvCtGetTermData get EMV CT terminal data (39-01) **Parameters** \[out] **emv** EMV settings #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtInit() int emvCtInit initialize EMV CT framework (39-00) **Parameters** \[in] **aidCount** number of AIDs \[in] **options** EMV options (see EMVOptions) #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) {% hint style="info" %} The EMV callback function must have been set before invoking this function {% endhint %} ### emvCtLED() int emvCtLED Control the Smart Card Reader LEDs. (41-09) **Parameters** \[in] **ledState** led state, on if true, off if false. #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtSendOfflinePIN() int emvCtSendOfflinePIN send entered (ofline) PIN to chip card for verification. (41-05) **Parameters** \[out] **chipresult** result code from the chip card #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtSendReceive() int emvCtSendReceive send EMV command and receive result **Parameters** \[in] **options** bit mask with options from EMVCtReaderOptions (DF06) \[in] **in** EMV command (DF01) \[out] **out** EMV result (DF01) #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtSetAppData() int emvCtSetAppData set EMV CT application data (39-02) **Parameters** \[in] **aid** AID that is to be configured \[in] **emv** EMV application data #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtSetCAPKey() int emvCtSetCAPKey set EMV CT CAP key (39-03) **Parameters** \[in] **rid** key register identifier \[in] **index** key index \[in] **key** key data \[in] **exp** key exponent, use 1 for 65537 \[in] **hash** if not empty 20 bytes hash \[in] **revocationlist** if not empty key revocation list, each entry has 3 bytes serial number #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtSetTempAppData() int emvCtSetTempAppData set EMV CT application data for current transaction (39-02) {% hint style="info" %} Transaction data (such as time stamp or transaction type) can be updated with [emvCtUpdateTxnTags()](#ga6c8b8d13261c96bd437fe3d0d2276730) {% endhint %} \*\*Parameters\*\* \[in] **emv** EMV application data #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtSetTermData() int emvCtSetTermData set EMV CT terminal data (39-01) **Parameters** \[in] **emv** EMV settings #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtSmartDetect() int emvCtSmartDetect Handle the Smart Card Detection. It can be used for both a card request and a card removal. (41-01) For detecting card removal it has to be invoked with *timeout\_ms==0* in a loop and the return code has to be checked. **Parameters** \[in] **timeout\_ms** timeout in milliseconds, range 0..1275000ms, granularity varies from 500ms to 5s. #### Returns 0 if card inserted, 1 if card removed, else SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) ### emvCtStartTransaction() int emvCtStartTransaction start EMV CT transaction (39-10) **Parameters** \[in] **type** transaction type, (see EMVTransaction) (9C) \[in] **amount** transaction amount (9F02) \[in] **date** transaction date (9A) \[in] **time** transaction time (9F21) \[in] **counter** transaction sequence counter (9F41) \[in] **optional** optional transaction parameters \[out] **out** transaction result data #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) ### emvCtUpdateTxnTags() int emvCtUpdateTxnTags Update one or several kernel tags during transaction. This update is restricted to certain (not protected) EMV L2 kernel tags, if there is a need to change these tags during the transaction temporarily and for this transaction only but not for the general configuration. Use carefully. (39-13) {% hint style="info" %} Application configuration data has to be updated with [emvCtSetTempAppData()](#ga008b2dddcc79d3243e8e78d508c51831). {% endhint %} \*\*Parameters\*\* \[in] **options** update options (see EMVUpdateOptions) \[in] **config** configuration containing the settings to be updated #### Returns SDI error code ([Result](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066)) (<=0) or SDI EMV status code ([EMVStatus](/s-adk-5.1-programmers-guide/readme/namespaces/namespacevfisdi.md#a904e5abfa09e53cda6dd4c6ba5fa5b02)) (>0) --- # 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/s-adk-5.1-programmers-guide/readme/modules/group__sdiemvct.md?ask=&goal= ``` `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.