Issue cards

Methods of issuing cards

1.Issue cards via Bluetooth

The "Add IC Card" method in the SDK is used to issue IC cards via Bluetooth. After the APP calls the "Add IC Card" method, the door lock will prompt you to place the card on the lock, and the card information will be recorded in the lock.

Note: This operation needs to be done next to the lock.

1.Issue cards via gateway

With this method you have to read the card number by a card reader, then write the card number into the lock. When you swipe the card to unlock the lock，the lock will check if the card number is already added in the lock, this determines whether the card can unlock the lock.

If you want to use this method, the lock must be a WiFi lock or it's connected to a gateway, refer to cloud API: Add IC card for details.

1.Issue cards via Card Encoder

With this method the card encoder will write the lock's MAC into the card, when you swipe the card to unlock the lock，the lock will check if the lock Mac in the card is the same as it's Mac, and this determines whether the card can unlock the lock.

The developer have to develop an application based on our card encoder DLL, Functions like Issue card、View Card、Cancel Card etc can be implemented.

Card encoder support issuing master card and floor card, and does not rely on gateway。

Note: When using the demo for testing, please use the program located at this path: cardencoderdemo-master\Release\CardEncoderDemo.exe

There are two options for you to integrate with card encoder:

Option 1: Develop only the computer-based card issuing software. Use the universal "TTHotel" APP to add and manage locks.

Option 2: Completely independent of TTHotel, developing both the APP for adding and managing locks and the computer-based card issuing software.

Please refer to the following chapters for details.

1、Option 1：Based on TTHotel to integrate with card encoder

It is an easier way, you only develop Windows desktop software and focus on APIs of card encoder. All lock related functions will be managed with the public app "TTHotel". Here are the steps:

1.1、Initialize the lock by "TTHotel" APP

Download "TTHotel" from appstore and google play. And apply for an admin account in the app. The account is used to login app and it is the admin of all locks. You can config locks with this app, like add lock, set building and floor information, set sector information, also you can calibrate time and collect operation records with it.

1.2、Get client_id and client_secret

Login TTHotel client, in setting option, integration button, you can gain client_id and client_secret after apply integration

1.3、Get Access Token

Get access token with clientId , clientSecret and the TTHotel account and password

Alert: The application can't access Sciener accounts after it is binded to an hotel admin account, please use the TTHotel account in step 3 to get access token.

1.4、Integrate the card encoder DLL into your software

Integrate the card encoder DLL into your Windows desktop software. You can do all card related functions with it, like issue card, cancel card, renew card, report loss, and etc

There are cloud APIs (Cloud API V3, request with accessToken get from 2.3). You can get lock info, send ekey or generate passcode with them. But you can not get the locks' building number and floor number via clouds API, you can export locks data in TTHotel client integration interface

2、Option 2: Develop your own app and then integrate with card encoder

You will develop your own app to manage locks in this option. The app is similar with "TTHotel" app, but you can have more functions in it. Here are the steps:

2.1、Register a developer account

2.2、Create an application

Each application has a client_id and client_secret after being approved.

A developer account can create several applications, one application for one hotel.

2.3、Develop APP based on the APP SDK, to manage locks.

In you APP you have to write the hotelInfo ,buliding number and floor number into the lock via bluetooth after lock is successfully initialized.

2.4、Get Access Token

Get access token with the TTLock or Sciener APP account or the account your register with API.

2.5、Integrate the card encoder DLL into your software

Integrate the card encoder DLL into your Windows desktop software. You can do all card related functions with it, like issue card, cancel card, renew card, report loss, and etc

There are cloud APIs (Cloud API V3, request with accessToken get from 2.4). You can get lock info, send ekey or generate passcode with them. But you can not get the locks' building number and floor number via clouds API, developer should store those data by themselves