> For the complete documentation index, see [llms.txt](https://developer.magtek.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.magtek.com/sdks-and-tools/universal-sdk-documentation/ios/enumerations.md). # Enumerations ### BarCodeFormat This enum refers to the type of barcodes to display.


Enum	Description
MTU_BARCODE_FORMAT_BLOB	Data is binary format
MTU_BARCODE_FORMAT_COMMAND	Data is a command in binary format
MTU_BARCODE_FORMAT_BLOB_BASE64	Data is Base64 encoded format
MTU_BARCODE_FORMAT_COMMAND_BASE64	Data is a command in Base64 format

### BarCodeType This enum refers to the type of barcodes to display.


Enum	Description
MTU_QRCODE	QR code

### CaptureType This enum refers to the type of customer information to capture.


Enum	Description
MTU_CaptureType_None	Capture unavailable
MTU_CaptureType_PhoneNumber	Capture phone number
MTU_CaptureType_SocialSecurityNumber	Capture social security number
MTU_CaptureType_ZipCode	Capture zip code
MTU_CaptureType_EmployeeID	Capture Employee ID number
MTU_CaptureType_Birthday	Capture birth date in USA format
MTU_CaptureType_Cancel	Capture canceled

### ConnectionState This enum refers to the readiness of the SDK to communicate with the device. This is not the physical attachment to a host system.


Enum	Description
MTU_ConnectionState_Unknown	Device is in an unknown connection state.
MTU_ConnectionState_Disconnected	Device is disconnected.
MTU_ConnectionState_Connecting	Device is in the process of connecting. The next state is to be Connected.
MTU_ConnectionState_Error	There was an error either connecting or disconnecting the device.
MTU_ConnectionState_Connected	Device is connected and ready for transacting.
MTU_ConnectionState_Disconnecting	Device is in the process of disconnecting. The next state will is to be Disconnected.

### ConnectionType This enum refers to the communication interface type of MagTek reader which the SDK will control.


Enum	Description
MTU_ConnectionType_USB (Reserved)	USB devices
MTU_ConnectionType_BLUETOOTH_LE (Reserved)	Bluetooth Low Energy devices: DynaMax
MTU_ConnectionType_BLUETOOTH_LE_EMV (Reserved)	Bluetooth Low Energy with EMV supported devices: · eDynamo
MTU_ConnectionType_BLUETOOTH_LE_EMVT (Reserved)	Bluetooth Low Energy with EMV supported devices: · tDynamo
MTU_ConnectionType_TCP (Reserved)	Transmission Control Protocol supported devices: · DynaPro
MTU_ConnectionType_TCP_TLS (Reserved)	Transmission Control Protocol with Transport Layer Security supported devices: · DynaPro Go
MTU_ConnectionType_TCP_TLS_TRUST (Reserved)	Transmission Control Protocol with Transport Layer Security supported devices: · DynaPro Go


Enum	Description
MTU_ConnectionType_WEBSOCKET	WebSocket supported devices: · DynaFlex II PED
MTU_ConnectionType_WEBSOCKET_TRUST	WebSocket supported devices. This will establish a TLS connection to device without requirement for name match. · DynaFlex II PED
MTU_ConnectionType_SERIAL (Reserved)	UART supported devices
MTU_ConnectionType_AUDIO (Reserved)	Audio devices: · iDynamo 6
MTU_ConnectionType_EXTERNAL_ACCESSORY	iAP2 supported devices: DynaFlex II Go
MTU_ConnectionType_VIRTUAL (Reserved)	Virtual devices
MTU_ConnectionType_MQTT	MQTT devices: · DynaFlex II PED

### DataEntryType This enum is reserved for future use.


Enum	Description
MTU_DataEntry_PIN	Request Personal Identification Number
MTU_DataEntry_Signature	Request Signature
MTU_DataEntry_SSN	Request Social security number
MTU_DataEntry_ZIPCODE	Request Zip code
MTU_DataEntry_BirthDate	Request Birth date
MTU_DataEntry_ActivationCode	Request Activation code

### DeviceEvent This enum refers to a change in the device status.


Enum	Description
MTU_DeviceEvent_None	No event to report.
MTU_DeviceEvent_DeviceResetOccured	A device reset had occurred.
MTU_DeviceEvent_DeviceResetWillOccur	A device reset will occur soon. Host application may use this as a warning to take appropriate actions.
MTU_DeviceEvent_DeviceNotPaired	Device is not paired therefore cannot be connected.

### DeviceFeature This enum refers to a featured supported by the device.


Enum	Description
MTU_DeviceFeature_None	No feature
MTU_DeviceFeature_SignatureCapture	Supports signature capture
MTU_DeviceFeature_PINEntry	Supports PIN entry
MTU_DeviceFeature_PANEntry	Supports PAN entry
MTU_DeviceFeature_ShowBarCode	Supports display of a barcode
MTU_DeviceFeature_ScanBarCode	Supports scanning a barcode
MTU_DeviceFeature_Buzzer	Has a buzzer
MTU_DeviceFeature_NFCCardEmulation	Supports NFC card emulation
MTU_DeviceFeature_PersonalInfoEntry	Supports Personal Info Entry

### DeviceType This enum refers to the type of MagTek reader which the SDK will control.

Enum

Description

MTU_DeviceType_SCRA

Secure Reader Authenticator devices. List includes but not limited to:

· eDynamo

· mDynamo

· Dynamag

· DynaMax

· tDynamo

· kDynamo

· cDynamo

· iDynamo 6

MTU_DeviceType_PPSCRA

PIN Pad Secure Reader Authenticator devices. List includes but not limited to:

· DynaPro

· DynaPro Go

· DynaPro Mini

Enum

Description

MTU_DeviceType_CMF

Common Message Structure devices. List includes but not limited to:

· oDynamo

MTU_DeviceType_MMS

MMS class devices. (MagTek Message Scheme) List includes but not limited to:

· DynaFlex

· DynaFlex Pro

· DynaProx

· DynaFlex II PED

· DynaFlex II Go

### EventType This enum refers to the type of event triggered by the device.


Enum	Description
MTU_EventType_ConnectionState	There was a change in the connection state of the device.
MTU_EventType_DeviceResponse	Device has responded to a command.
MTU_EventType_DeviceExtendedResponse	Device has responded to an extended command.
MTU_EventType_DeviceNotification	Device has sent a notification.
MTU_EventType_DeviceTransferCancelled	Device has cancelled data transfer.
MTU_EventType_CardData	Device has sent magnetic stripe data from a card swipe.
MTU_EventType_TransactionStatus	There was a change in transaction status.
MTU_EventType_DisplayMessage	Device has a message to display for the user.
MTU_EventType_InputRequest	Device is requesting input from the user.
MTU_EventType_AuthorizationRequest	Device has sent the Authorization Request Cryptogram and associated block of EMV tags for a transaction. This block is meant to be sent to the transaction processor.
MTU_EventType_TransactionResult	Device has sent the result of the transaction.
MTU_EventType_PINBlock	Device has sent the PINBlock after the user has entered a PIN on the device.
MTU_EventType_Signature	Device has sent data which represents a signature from a user.
MTU_EventType_DeviceDataFile	Device has sent a data file.


Enum	Description
MTU_EventType_OperationStatus	Device has sent an operation status of a command.
MTU_EventType_DeviceEvent	Device has sent change of device state.
MTU_EventType_UserEvent	Device has sent a notification related to user interaction with the device.
MTU_EventType_FeatureStatus	Device has sent a change in a feature.
MTU_EventType_PINData	Device has sent data related to a PIN.
MTU_EventType_PANData	Device has sent data related to a PAN.
MTU_EventType_BarCodeData	Device has sent barcode data.
MTU_EventType_NFCEvent	Device has sent NFC event.
MTU_EventType_NFCData	Device has sent NFC data.
MTU_EventType_NFCResponse	Device has sent response to an NFC command.
MTU_EventType_NFCRAPDUResponse	Device has sent response to an NFC APDU command for Mifare DESFire Tag.
MTU_EventType_ClearDisplay	Device has sent a notification to clear the display of messages for the user.
MTU_EventType_EnhancedInputRequest	Device is requesting enhanced input from the user.
MTU_EventType_ TouchScreenSignatureCapture	Device has sent response to signature capture.
MTU_EventType_ TouchScreenFunctionalButtonSelected	Device has sent a notification of a functional button selected.
MTU_EventType_ TouchScreenTextStringButtonSelected	Device has sent a notification of a test string button selected.
MTU_EventType_ TouchScreenAmountButtonSelected	Device has sent a notification of an amount button selected.
MTU_EventType_ TouchScreenPresentCardFunctionalButto nSelected	Device has sent a notification of a present card functional button selected.
MTU_EventType_ TouchScreenPersonalInfo	Device has sent a personal info entry.
MTU_EventType_NFCCardData	Device has sent NFC card data.
MTU_EventType_NFCPassThroughData	Device has sent NFC Pass-Through data.
MTU_EventType_NFCPassThroughResponse	Device has sent a response to NFC Pass-Through exchange.

### FeatureStatus This enum refers to the status of a specific feature reported from DeviceEvent.


Enum	Description
MTU_FeatureStatus_NoStatus	No change in status
MTU_FeatureStatus_Success	Success
MTU_FeatureStatus_Failed	Failed
MTU_FeatureStatus_TimedOut	Timed out
MTU_FeatureStatus_Cancelled	Cancelled
MTU_FeatureStatus_Error	Error
MTU_FeatureStatus_HardwareNA	Featured hardware not applicable for a status

### ImageType This enum refers to the type of image.


Enum	Description
MTU_IMAGE_TYPE_BITMAP	BMP file

### InfoType This enum refers to the type of specific information to retrieve from the device.


Enum	Description
MTU_InfoType_DeviceSerialNumber	Device serial number.
MTU_InfoType_FirmwareVersion	Firmware version of the device.
MTU_InfoType_DeviceCapabilities	Capabilities of the device delimited by a comma.
MTU_InfoType_Boot1Version	Boot 1 firmware version of the device.
MTU_InfoType_Boot0Version	Boot 0 firmware version of the device.
MTU_InfoType_FirmwareHash	Firmware hash comprised of part numbers, versions, and timestamps.
MTU_InfoType_TamperStatus	Tamper status of the device. 0x00 = Not Tampered 0x01 = Tampered
MTU_InfoType_OperationStatus	Operation status of the device. 0x01 = Offline 0x02 = Online


Enum	Description
MTU_InfoType_OfflineDetail	Details of why the device is offline. · Bit 0 = Tamper problem present · Bit 1 = Master Key problem present · Bit 2 = Keys and Certificates problem present · Bit 3 = Real Time Clock problem present · Bit 4 = Random Number Generator problem present · Bit 5 = Cryptography Engine problem present · Bit 6 = Magnetic Stripe Reader Hardware problem present · Bit 7 = Reserved
MTU_InfoType_DeviceModel	Device model.
MTU_InfoType_FirmwareVersionWLAN	Firmware version for WLAN module of the device.
MTU_InfoType_FirmwareVersionBLE	Firmware version for Bluetooth LE module of the device.
MTU_InfoType_BatteryLevel	Battery level of the device.

### NFCDataMode This enum refers to the type of NFC data mode.


Enum	Description
MTU_NFCDataMode_ASCII	ASCII
MTU_NFCDataMode_Binary	Binary

### NFCEvent This enum refers to the NFC event.


Enum	Description
MTU_NFCEvent_None	No event
MTU_NFCEvent_NFCMifareUltralight	Mifare Ultralight
MTU_NFCEvent_MifareClassic1K	Mifare Classic 1K
MTU_NFCEvent_MifareClassic4K	Mifare Classic 4K
MTU_NFCEvent_MifareDESFire	Mifare DESFire
MTU_NFCEvent_MifareDESFireLight	Mifare DESFire Light
MTU_NFCEvent_MifareMini	Mifare Mini
MTU_NFCEvent_MifarePlusEV1	Mifare Plus EV1
MTU_NFCEvent_MifarePlusEV2	Mifare Plus EV2
MTU_NFCEvent_MifarePlusSE	Mifare Plus SE


Enum	Description
MTU_NFCEvent_MifarePlusX	Mifare Plus X
MTU_NFCEvent_MifareDESFireEV1	Mifare DESFire EV1
MTU_NFCEvent_MifareDESFireEV2	Mifare DESFire EV2
MTU_NFCEvent_MifareDESFireEV3	Mifare DESFire EV3
MTU_NFCEvent_CAmDL	Mobile Driver license
MTU_NFCEvent_TagRemoved	Tag removed
MTU_NFCEvent_Failed	Command failed
MTU_NFCEvent_IOFailed	IO failed
MTU_NFCEvent_AuthenticationFailed	Authentication failed

### PaymentMethod This enum refers to which card type the device will perform a transaction.


Enum	Description
MTU_PaymentMethod_MSR	For magnetic stripe cards.
MTU_PaymentMethod_Contact	For EMV chip cards.
MTU_PaymentMethod_Contactless	For NFC contactless cards.
MTU_PaymentMethod_ManualEntry	For user to manually enter transaction data without any card access.
MTU_PaymentMethod_BarCode	Reserved for future use.
MTU_PaymentMethod_AppleVAS	For Apple VAS.
MTU_PaymentMethod_BarCodeEncrypted	Reserved for future use.
MTU_PaymentMethod_NFC	For NFC Mifare.
MTU_PaymentMethod_GoogleVAS	Reserved for future use.

### StatusCode This enum refers to the status of the transaction.


Enum	Description
MTU_StatusCode_Success	The operation completed successfully.
MTU_StatusCode_Timeout	The operation timed out.
MTU_StatusCode_Error	Error attempting the operation.
MTU_StatusCode_Unavailable	Status currently unavailable.

### SystemState This enum refers to the host system state of connectivity.


Enum	Description
SystemStateUnknown	Initial state
SystemStateBluetoothLEResetting	Bluetooth resetting
SystemStateBluetoothLEUnsupported	Bluetooth unsupported
SystemStateBluetoothLEUnauthorized	Bluetooth unauthorized
SystemStateBluetoothLEPoweredOff	Bluetooth powered off
SystemStateBluetoothLEPoweredOn	Bluetooth powered on
SystemStateNetworkOff	Network off
SystemStateNetworkOn	Network on
SystemStateServerNotReachable	Server not reachable
SystemStateRejectedByServer	Rejected by server
SystemStateTLSAuthenticationFailed	TLS authentication failed
SystemStateProtocolError	Protocol error
SystemStateServerConnected	Server connected

### NFCTransactionMode This enum refers to the mode of the transaction.


Enum	Description
MTU_NFCTransactionMode_None	None
MTU_NFCTransactionMode_MifareClassic	Mifare Classic
MTU_NFCTransactionMode_MifareDESFire	Mifare DESFire
MTU_NFCTransactionMode_ AppleWalletMobileDESFire	Apple Wallet mobile DESFire
MTU_NFCTransactionMode_ Mifare2GoMobileDESFire	Mifare 2 Go mobile DESFire

### TransactionStatus This enum refers to the status of the transaction.


Enum	Description
MTU_TransactionStatus_ NoStatus	Set before the start of a transaction and before a card is presented to the device.
MTU_TransactionStatus_ NoTransaction	No transaction in progress.
MTU_TransactionStatus_ CardSwiped	A card was swiped into the device.


Enum	Description
MTU_TransactionStatus_ CardInserted	A card was inserted into the device.
MTU_TransactionStatus_ CardRemoved	A card was removed from the device.
MTU_TransactionStatus_ CardDetected	A card was detected by the device.
MTU_TransactionStatus_ CardCollision	A card collision was detected by the device. Possibly more than 1 contactless detected.
MTU_TransactionStatus_ TimedOut	The transaction was not completed before a timeout period.
MTU_TransactionStatus_ HostCanceled	The host software sent a cancel.
MTU_TransactionStatus_ TransactionCanceled	The transaction was canceled by device.
MTU_TransactionStatus_ TransactionInProgress	The transactions is in progress.
MTU_TransactionStatus_ TransactionError	There is an error during the transaction.
MTU_TransactionStatus_ TransactionApproved	The transactions is approved.
MTU_TransactionStatus_ TransactionDeclined	The transactions is declined.
MTU_TransactionStatus_ TransactionCompleted	The transaction is completed.
MTU_TransactionStatus_ TransactionFailed	The transaction failed.
MTU_TransactionStatus_ TransactionNotAccepted	The transaction was not accepted by the device.
MTU_TransactionStatus_ SignatureCaptureReques ted	A signature capture is requested by the device.
MTU_TransactionStatus_ TechnicalFallback	Due to technical reasons, the chip transaction cannot be completed by the reader.
MTU_TransactionStatus_ QuickChipDeferred	Device has sent a “Z3” response code to the chip card.
MTU_TransactionStatus_ DataEntered	Data has been entered on the device for a manual card entry transaction.
MTU_TransactionStatus_ TryAnotherInterface	Due to removal of the chip card, error with contactless card, or magnetic swipe has a service code for chip card, the transaction cannot be completed by the reader.


Enum	Description
MTU_TransactionStatus_ BarcodeRead	A barcode is read.
MTU_TransactionStatus_ VASError	Apple VAS error occurred.
MTU_TransactionStatus_ MSRFallback	MSR fallback occurred.
MTU_TransactionStatus_ ReservedICCOnly

### OperationStatus This enum refers to the operation status of the device.


Enum	Description
MTU_OperationStatus_NoStatus	No update for the operation.
MTU_OperationStatus_Started	Device has started an operation.
MTU_OperationStatus_Warning	Device has sent a warning about the operation.
MTU_OperationStatus_Failed	Device has failed an operation.
MTU_OperationStatus_Done	Device has completed an operation.

### UserEvent This enum refers to the type of user event reported by the device. These events relate to user interaction.


Enum	Description
MTU_UserEvent_None	No events yet to occur.
MTU_UserEvent_ContactlessCardPresented	Contactless card has been presented.
MTU_UserEvent_ContactlessCardRemoved	Contactless card has been removed.
MTU_UserEvent_CardSeated	Card is seated into the chip station.
MTU_UserEvent_CardUnseated	Card was removed from the chip station.
MTU_UserEvent_CardSwiped	Magnetic stripe card was swiped.
MTU_UserEvent_TouchPresented	Touch screen sensor press detected.
MTU_UserEvent_TouchRemoved	Touch screen sensor release detected.
MTU_UserEvent_BarcodeRead	Barcode detected.
MTU_UserEvent_NFCMifareUltralightPresented	Mifare Ultralight presented.
MTU_UserEvent_MifareClassic1KPresented	Mifare Classic 1K presented.
MTU_UserEvent_MifareClassic4KPresented	Mifare Classic 4K presented.
MTU_UserEvent_MifareDESFirePresented	Mifare DESFire presented.


Enum	Description
MTU_UserEvent_MifareDESFireLightPresented	Mifare DESFire Light presented.
MTU_UserEvent_NFCMifareUltralightRemoved	Mifare Ultralight removed.
MTU_UserEvent_MifareClassic1KRemoved	Mifare Classic 1K removed.
MTU_UserEvent_MifareClassic4KRemoved	Mifare Classic 4K removed.
MTU_UserEvent_MifareDESFireRemoved	Mifare DESFire removed.
MTU_UserEvent_MifareDESFireLightRemoved	Mifare DESFire Light removed.
MTU_UserEvent_MifareMiniPresented	Mifare Mini presented.
MTU_UserEvent_MifareMiniRemoved	Mifire Mini removed.
MTU_UserEvent_MifarePlusEV1Presented	Mifare Plus EV1 presented.
MTU_UserEvent_MifarePlusEV2Presented	Mifare Plus EV2 presented.
MTU_UserEvent_MifarePlusSEPresented	Mifare Plus SE presented.
MTU_UserEvent_MifarePlusXPresented	Mifare Plus X presented.
MTU_UserEvent_MifareDESFireEV1Presented	Mifare DESFire EV1 presented.
MTU_UserEvent_MifareDESFireEV2Presented	Mifare DESFire EV2 presented.
MTU_UserEvent_MifareDESFireEV3Presented	Mifare DESFire EV3 presented.
MTU_UserEvent_MifarePlusEV1Removed	Mifare Plus EV1 removed.
MTU_UserEvent_MifarePlusEV2Removed	Mifare Plus EV2 removed.
MTU_UserEvent_MifarePlusSERemoved	Mifare Plus SE removed.
MTU_UserEvent_MifarePlusXRemoved	Mifare Plus X removed.
MTU_UserEvent_MifareDESFireEV1Removed	Mifare DESFire EV1 removed.
MTU_UserEvent_MifareDESFireEV2Removed	Mifare DESFire EV2 removed.
MTU_UserEvent_MifareDESFireEV3Removed	Mifare DESFire EV3 removed.
MTU_UserEvent_mDLPresented	Mobile Driver’s License presented.
MTU_UserEvent_mDLRemoved	Mobile Driver’s License removed.

### VASMode This enum refers to the Apple VAS mode. This controls how the Apple VAS data is returned in the transaction ARQC. For details on Apple VAS data structure returned in a transaction see **DynaFlex Family Programmer’s Manual.**


Enum	Description
MTU_VASMode_Single	The device reads only Apple VAS data from a tapped smartphone, or reads EMV payment data from a tapped card. When the device sends ARQC to conclude the transaction, it only includes either EMV payment data in container FC for cards, or includes VAS data in container FE for smartphones.
MTU_VASMode_Dual	The device reads both Apple VAS data and EMV payment data from a tapped smartphone, or reads EMV payment data from a tapped card. When device sends ARQC to the host to conclude the transaction, it includes EMV payment data in container FC and includes VAS data, if available, in container FE.
MTU_VASMode_VASOnly	The device reads only Apple VAS data from a tapped smartphone, and does not read data from a tapped card. If the tapped smartphone does not support VAS, the device does not detect or read from the smartphone. When the device send ARQC to conclude the transaction, it includes VAS data in container FE and does not include EMV payment data in container FC.
MTU_VASMode_ECP2	The host can configure the ECP2 frame. See Apple ECP2.0 specification.

--- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://developer.magtek.com/sdks-and-tools/universal-sdk-documentation/ios/enumerations.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.