Skip to main content

Application Development Kit (Version 4.8)


sdi_data.h File Reference

Last updated: 05-Mar-2025
#include "emv/EMV_CT_Interface.h"

#include "emv/EMV_CTLS_Interface.h"
Include dependency graph for sdi_data.h:

Go to the source code of this file.

Macros

#define  CLA_DATA   0x29
  Class for Data Handling. More...
#define  INS_FETCH_TAGS   0x02
  Fetch Tags. More...
#define  SENSITIVE_TAG_OMIT   0
  (b1 & b2): Default handling of sensitive tags by SDI_fetchTxnTags(): Sensitive tags are not returned in the response. More...
#define  SENSITIVE_TAG_TRUNCATE   0x01
  b1: Sensitive tags are returned with zero length. Note: b1 and b2 are mutually exclusive More...
#define  SENSITIVE_TAG_REPLACE   0x02
  b2: Sensitive tags are returned with data replaced by 0xFF bytes and original length More...
#define  FETCHTAGS_EXPIRY_DATE_IN_CLEAR   0x04
  b3: Get expiry date (tag 5F24) in clear text if VCL encryption is enabled More...
#define  FETCHTAGS_GET_DATA   0x08
  b4: Use EMV_ADK_FETCHTAGS_GET_DATA option (for CT only) More...

Functions

EMV_ADK_INFO  SDI_fetchTxnTags (unsigned char options, unsigned long *requestedTags, unsigned short noOfRequestedTags, unsigned char *tlvBuffer, unsigned short bufferLength, unsigned short *tlvDataLength)
  Fetch one or several tags at the end of the transaction, excluding sensitive cardholder data. More...

Macro Definition Documentation

◆ CLA_DATA

#define CLA_DATA   0x29

Class for Data Handling.

◆ INS_FETCH_TAGS

#define INS_FETCH_TAGS   0x02

Fetch Tags.

Function Documentation

◆ SDI_fetchTxnTags()

EMV_ADK_INFO SDI_fetchTxnTags ( unsigned char  options,
unsigned long *  requestedTags,
unsigned short  noOfRequestedTags,
unsigned char *  tlvBuffer,
unsigned short  bufferLength,
unsigned short *  tlvDataLength 
)

Fetch one or several tags at the end of the transaction, excluding sensitive cardholder data.

One common function for all technologies: CT, CTLS, MSR and manual entry. Sensitive tags are excluded from the returned data in the way defined by the parameter mode. The SDI Server has a predefined set of sensitive tags. Additionally, the user can configure additional sensitive tags using the Software and Configuration Upload command set 20-14, 20-15 and 20-16 as described in the SDI Server documentation. The user can also configure a white list using the same Software and Configuration Upload commands. If a card is in the configured white list, all data is returned in clear text, including also sensitive tags.

Author
GSS R&D Germany
Parameters
[in] options ... fetch tags options, see Options for fetching TLV data
[in] requestedTags ... requested tags
[in] noOfRequestedTags ... number of requested tags
[in,out] tlvBuffer ... buffer for TLV output, allocated by calling application
[in] bufferLength ... number of bytes allocated for tlvBuffer
[out] tlvDataLength ... number of bytes written to tlvBuffer
Returns
EMV_ADK_OK, EMV_ADK_PARAM, EMV_ADK_TLV_BUILD_ERR, EMV_ADK_INTERNAL

Need help?

Do you have a question? If you didn’t find the answer you are looking for in our documentation, you can contact our Support teams for more information. If you have a technical issue or question, please contact us. We are happy to help.

Not yet a Verifone customer?

We’ll help you choose the right payment solution for your business, wherever you want to sell, in-person or online. Our team of experts will happily discuss your needs.

Verifone logo