Manual for Linea or Infinea device

Product information

Limitations

• Detailed limits for the RFID cards are found here. We recommend to use NTAGs. Namely NFC Forum Type 2 Tags. (They fall into the category Mifare Ultralight but they are NDEF formatted)

Connecting the Linea or Infinea device

To successfully connect the Linea or Infinea device it is necessary to call function Gonector_Connect( "LineaInfinea" ) and press a hardware button. For Linea Pro 7 it is the button on the right hand side of the device.

Connection troubleshooting guide

• Open Settings of the iOS device
• Open the General tab on the iOS device
• Open About on the iOS device
• Scroll down and see if the device is mentioned in the list of options
• If the device is not visible in the list of options, try to press the hardware button mentioned in the specification of the device as a startup button
• If the device is still not visible in the list of options, try reconnecting the device by removing it completely
• If the device is still not visible in the list of options, try to restart the iOS device
• If the device is still not visible in the list of options, try upgrading the firmware of the iOS device
• If the device is still not visible in the list of options, contact the supplier at https://stimare.net/contact-us/
• If the device is visible in the list of options but it is not possible to use the function Gonector_Connect successfully, please contact our support at support@24usoftware.com

Solving issues with Linea or Infinea device

• Device is connected to iOS, but i cannot use the device and cannot get firmwareVersion neither
  Linea and Infinea devices use special protocol for communication, which has to be specified in your app. Into the .plist file of the project in Xcode, add new Row with the value "Supported external accessory protocol" and add the Strings:
  • "com.datecs.linea.pro.msr"
  • "com.datecs.linea.pro.bar"
• I cannot read some of the supported barcodes
  Barcodes Codabar, Code93 and ITF14 are disabled by default for Linea Pro 7. To initiate reading it is necessary to read following codes

Security

LineaInfinea stripe key guide

To manipulate the key for stripe reading you have two functions: Gonector_Set( "deviceStripeKey" ; ... ) and Gonector_Set( "connectionStripeKey" ; ... ).
Function Gonector_Set( "deviceStripeKey" ; ... ) stores the StripeKey directly in the device and so the plugin has no access to this key.
After every Gonector_Connect function you should set the same key with function Gonector_Set("connectionStripeKey" ; ... ) for stripe reading.
In fact the StripeKey is not used to decrypt the card. The StripeKey is used as a "Loading key" and at the same time a random session key is created and stored in the device and the plugin.
The StripeKey is never stored in the plugin.
Like this the plugin does not know the StripeKey and the user does not know the session key.
The device knows both keys and is able to provide handling for both keys.
As soon as the function Disconnect is called the session key disappears.
Those mechanics are provided by the device and they serve to protect the credit card data.
The plugin was designed to comply with those rules.

How to use the StripeKey:

• 1. Set a unique stripe key in the device with Gonector_Set( "deviceStripeKey" ; ... )
• 2. Use the stripe key to set a session key in the plugin with Gonector_Set("connectionStripeKey" ; ... )
• Repeat step 2. after every disconnect

Note: You don't need to set the deviceStripeKey anymore unless it becomes reasonable according to PCI compliance.