COMMAND PROTOCOL READER PARKIR

COMMAND PROTOCOL READER PARKIR
Version 1.5
Release No. Date Revision Description
V1.1 10/11/2017 First Release

V1.2 29/11/2017 Penambahan MID & TID di respon Reader Init
V1.3 08/12/2017 Perubahan format respon log transaksi
V1.4 30/01/2018 Add Mifare command (Read, Write, GetUID)
Add BNI TapCash
V1.5 14/05/2018 Add Command Read & Write Data Prepaid Card
PT SoftOrb Technolog y Indonesia

Komplek Mutiara Taman Palem Blok A11 No. 8 Cengkareng Timur – Jakarta Barat 11730
Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
w w w . s o f t o r b . c o .id
This is confidential document, not to be duplicated or distributed withour prior written consent from SoftOrb Technology Indonesia
2
Contents
I. Setting Protocol Serial ........................................................................................................................... 4
II. Frame Format Protocol ......................................................................................................................... 4
III. List Command Reader Parkir............................................................................................................. 4
A. Reader INIT........................................................................................................................................ 4
B. Check Balance ................................................................................................................................... 5
C. Deduct ............................................................................................................................................... 6
D. Cancel Deduct Correction ................................................................................................................. 8
E. Get Last Transaction ......................................................................................................................... 8
F. Mifare Command .............................................................................................................................. 9
F.1. Get Card UID................................................................................................................................... 9
F.2. Read Block Mifare ........................................................................................................................ 10
F.3. Write Block Data Mifare ............................................................................................................... 10
G. Read & Write Data .......................................................................................................................... 11
G.1. Read Data .................................................................................................................................... 11
G.2. Write Data ................................................................................................................................... 11
IV. Flow Transaction ............................................................................................................................. 12
V. Response Code, Status Code, & Card Type ......................................................................................... 13

Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
3
I. Setting Protocol Serial
• Speed : 38400bps
• Data : 8 bit
• Parity : No
• Stop : 1 bit
II. Frame Format Protocol

Command Frame
Name STX LEN-H LEN-L CMD Data[n] LRC
Values 0x02 0xHH 0xHH 0xHH Data[n] 0xHH
Length. 1-Byte 1-Byte 1-Byte 3-Bytes n-Byte(s) 1-Byte
- STX : 0x02
- Data length = command (it must be 3) + Length of data.
LEN-H : Higher byte of data length
LEN-L : Lower byte of data length
- CMD : Command bytes
- Data[n] : Data bytes
- LRC : XORing from LEN-H to Data[n]
Response Frame
Name STX LEN-H LEN-L Resp Data[n] LRC
Values 0x02 0xHH 0xHH 0xHH Data[n] 0xHH
Length. 1-Byte 1-Byte 1-Byte 1-Byte n-Byte(s) 1-Byte
- STX : 0x02
- Data length = response (it must be 1) + Length of data.
LEN-H : Higher byte of data length
LEN-L : Lower byte of data length
- Resp : Response code from reader
- Data[n] : Data Bytes
- LRC : XORing from LEN-H to Data[n]
III. List Command Reader Parkir

A. Reader INIT
Berfungsi sebagai aktivasi reader. Fungsi ini hanya perlu dieksekusi setiap kali reader
dinyalakan.

Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
4
COMMAND FORMAT
CMD PARAMETER
EF 01 01 16Bytes Init Key
RESPONSE FORMAT
RESPONSE CODE RESPONSE DATA
See response code table 3Bytes Status Code (See status code table) + 8B MID Reader + TID 4B
Reader
Contoh
Sukses Init:
CMD : EF 01 01 [758F40D46D95D1641448AA19B9282C05]
RSP : 00 00 00 00 02 03 45 67 89 0A BC DE 87 65 43 21
Note: MID = 02 03 45 67 89 0A BC DE, TID = 87 65 43 21
Gagal Init:
CMD : EF 01 01 [11223344556677889900AABBCCDDEEFF]
RSP : 00 01 10 03 (command success but init key is incorrect)
B. Check Balance
Berfungsi untuk melakukan pengecekan saldo terakhir dari kartu prepaid
COMMAND FORMAT
CMD PARAMETER
EF 01 02 [4Bytes Date in BCD ddmmyyyy] + [3Bytes Time in BCD hhnnss 24Hours
Format] + [2Bytes Reader Waiting Timeout BCD]
RESPONSE FORMAT
RESPONSE RESPONSE DATA
See response 3Bytes Status Code (See status code table) + 1Byte Card Type + 8Byte Card
code table Number + 4 Bytes Card Balance in Hex Integer
- Date 6 Bytes BCD, eg:
0x10 0x12 0x20 0x17 = 10 Desember 2017
- Time 3 Bytes BCD, eg:
0x12 0x15 0x40 = 12:15:40 PM
- Reader Waiting Timeout, eg:
0x00 0x10 = 10 seconds

Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
5
Contoh
CMD : EF 01 02 [10 12 20 17] [12 15 40] [00 10]
(Date = 10 Des 2017, time=12:15:40PM, Timeout = 10 seconds)
RSP : 00 00 00 00 [01] [1A 2B 3C 4D 5E 6F 77 88] [00 01 86 A0]
(Card Type = 01 (Luminos), Card Number= 1A2B3C4D5E6F7788, Saldo= 0x0186A0 = Rp.
100.000)
C. Deduct
Berfungsi untuk melakukan pemotongan saldo kartu prepaid.
COMMAND FORMAT
CMD PARAMETER
EF 01 03 [4Bytes Date in BCD ddmmyyyy] + [3Bytes Time in BCD hhnnss 24Hours
Format] + [4Bytes Deduct Amount in Hex Integer] + [2Bytes Reader Waiting
Timeout BCD]
- Date 6 Bytes BCD, eg:
0x10 0x12 0x20 0x17 = 10 Desember 2017
- Time 3 Bytes BCD, eg:
0x12 0x15 0x40 = 12:15:40 PM
- Deduct Amount, eg:
0x00 0x00 0x03 0xE8 = 0x3E8 = Rp. 1000
- Reader Waiting Timeout, eg:
0x00 0x10 = 10 seconds
RESPONSE FORMAT
RESPONSE DATA
See response 3Bytes Status Code (See status code table) +
code table [1Bytes Card Type] +
[8Bytes MID Reader] +
[4Bytes TID Reader] +
[7Bytes DateTime in BCD ddmmyyyyhhnnss 24Hours Format] +
[8Bytes No kartu] +
[4Bytes Deduct Amount in Hex Integer] +
[4Bytes Card Remain Balance in Hex Integer] +
[4Bytes Trans Counter per day] +
nBytes Card Log transaction
- 4 Bytes Card balance after deduct transaction succeed

Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
6
Contoh tersedia di lampiran log.
Note :
- Berikut beberapa kemungkinan kondisi yang dapat terjadi saat proses deduct gagal
dilakukan :
a. Gagal Proses ke Kartu
Kemungkinan dapat disebabkan karena saldo tidak cukup, kartu rusak, kartu tidak
terdeteksi dll.
b. Lost contact
Kondisi yang terjadi bila saat proses deduct, kartu terangkat sehingga reader tidak
dapat melanjutkan proses ke kartu.
Pada kondisi seperti ini, reader akan mengeluarkan errorcode khusus yang
menandakan aplikasi harus melakukan proses deduct kembali menggunakan kartu
yang sama dengan sebelumnya (kartu yang terjadi lost contact) dan reader tidak
akan dapat melakukan transaksi selanjutnya dengan kartu yang berbeda.
Kondisi normal yang harus dilakukan

Saat aplikasi melakukan proses deduct berikutnya (dengan kartu yang sebelumnya)
maka reader akan secara otomatis melakukan deduct correction (dimana proses ini
tidak akan memotong kembali saldo kartu tersebut tetapi akan melanjutkan proses
deduct sampai proses tersebut selesai).
Kondisi khusus (apabila kartu tidak dapat digunakan)

Apabila terjadi lost contact dan ingin agar reader tetap dapat melakukan proses
transaksi normal selanjutnya maka dapat melakukan cancel dengan menggunakan
command reader “Cancel Deduct Correction” dikarenakan kartu sebelumnya tidak
dapat digunakan untuk melakukan proses deduct correction.

Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
7
D. Cancel Deduct Correction
Jika terjadi lost contact / kartu prepaid diangkat sebelum proses deduct selesai, maka reader
secara otomatis menyimpan penanda / flagging yang mengharuskan user untuk tetap
mentapping dengan kartu yang sama, sampai proses deduct selesai dan sukses dikartu
tersebut.
Apabila aplikasi ingin membatalkan flagging tersebut, maka dapat menggunakan command
ini.
COMMAND FORMAT
CMD PARAMETER
EF 01 04 -
RESPONSE FORMAT
See response code table 3Bytes Status Code (See status code table) + 1Byte Card Type + 8Byte
Card Number
Contoh
Apabila sebelumnya terjadi lost contact saat transaksi:
CMD : EF 01 04
RSP : 00 00 00 00 [01] [1A 2B 3C 4D 5E 6F 77 88]
(Card Type = 01 (Luminos), Card Number= 1A2B3C4D5E6F7788, Card Type dan Nomor
kartu ini adalah kartu yang sebelumnya diindikasikan terjadi lost contact oleh reader)
Apabila sebelumnya tidak terjadi lost contact saat transaksi:

CMD : EF 01 04
RSP : 00 00 00 00
E. Get Last Transaction

Berfungsi untuk melakukan pengecekan status transaksi sebelumnya
Note :
• Berfungsi sebagai proteksi tambahan untuk mencegah terjadinya double deduct apabila
terjadi putus komunikasi / tidak ada respon antara Reader dan Host.
• Dieksekusi hanya bila saat dilakukan proses deduct, reader tidak mengembalikan
response / Host tidak mendapat response sampai command timeout
• Bila transaksi sebelumnya sukses maka fungsi ini akan mengembalikan response data
seperti response dari command deduct
• Bila transaksi sebelumnya gagal maka fungsi ini hanya merespon dengan status code
sukses tanpa ada data tambahan lainnya

Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
8
COMMAND FORMAT
CMD PARAMETER
EF 01 05
RESPONSE FORMAT
RESPONSE DATA
See response 3Bytes Status Code (See status code table) +
code table [1Bytes Card Type] +
[8Bytes MID Reader] +
[4Bytes TID Reader] +
[7Bytes DateTime in BCD ddmmyyyyhhnnss 24Hours Format] +
[8Bytes No kartu] +
[4Bytes Deduct Amount in Hex Integer] +
[4Bytes Card Remain Balance in Hex Integer] +
[4Bytes Trans Counter per day] +
nBytes Card Log transaction
Contoh tersedia di lampiran log.
F. Mifare Command
Fungsi – fungsi yang berkaitan dengan kartu Mifare
F.1. Get Card UID

Berfungsi untuk mendapatkan Nomor UID dari Kartu (mendukung kartu tipe A dan kartu
Mifare)
COMMAND FORMAT
CMD PARAMETER
EF 01 07 00 + [2Bytes Reader Waiting Timeout BCD]
RESPONSE FORMAT
RESPONSE DATA
See response 3Bytes Status Code (See status code table) + [Card Type 1B] + [7Bytes card
code table UID]
Card Type = 0x41 (‘A’) for card Type A, or 0x4D (‘M’) for Mifare Card
7Bytes card UID = apabila UID kartu kurang dari 7Bytes maka otomatis dipadding 0 didepan.

Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
9
F.2. Read Block Mifare
Berfungsi untuk membaca block data Mifare di kartu (mendukung kartu Tipe A dengan dan
kartu Mifare)
COMMAND FORMAT
CMD PARAMETER
EF 01 07 01 + [1Byte Block Address] + [1Byte Key Type] + [6Bytes Login Key] + [2Bytes
Reader Waiting Timeout BCD]
Block Address (Hex Integer) = 0x00 to 0x03F (block 0 to block 63)
Key type (Hex Integer) = 0x0A (key A) or 0x0B (key B)
Login Key (Hex Integer) = eg: FFFFFFFFFFFF (Default Mifare key)
RESPONSE FORMAT
RESPONSE DATA
See response 3Bytes Status Code (See status code table) + [16Bytes card data]
code table
F.3. Write Block Data Mifare

Berfungsi untuk melakukan penulisan block data Mifare di kartu (mendukung kartu Tipe A
dan kartu Mifare)
Untuk menjalankan command ini:
1. Pastikan untuk melakukan command read dulu dengan return harus sukses, kemudian
bisa dilanjutkan dengan mengirim command write ini.
2. Pastikan block number di proses read dan write sama atau masih berada didalam sector
data yang sama.
3. Pastikan kartu tetap menempel direader selama peralihan dari command read ke write.
COMMAND FORMAT
CMD GET PARAMETER
EF 01 07 02 + [1Byte Block Address] + [16Bytes Data to Write] + [2Bytes Reader Waiting
Timeout BCD]
Block Address (Hex Integer) = 0x00 to 0x03F (block 0 to block 63)
RESPONSE FORMAT
RESPONSE DATA
See response 3Bytes Status Code (See status code table) + [16Bytes card data]
code table

Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
10
G. Read & Write Data
Fungsi - fungsi untuk melakukan proses baca & tulis data ke kartu prepaid
G.1. Read Data

Berfungsi untuk melakukan pembacaan data pada kartu prepaid.
COMMAND FORMAT
CMD PARAMETER
EF 01 08 00 + [1Byte Slot Data] + [1Byte Length of card data to read (Hex
Integer)] + [2Bytes Reader Waiting Timeout BCD]
RESPONSE FORMAT
See response code table 3Bytes Status Code (See status code table) + 1Byte Card Type +
8Bytes Card Number + [nBytes Card Data]
Slot Data = Nilai diset 0x01
G.2. Write Data

Berfungsi untuk melakukan proses penulisan data kartu pada kartu prepaid
COMMAND FORMAT
CMD PARAMETER
EF 01 08 01 + [1Byte Slot Data] + [1Byte Length of card data to write (Hex
Integer)] + [nBytes card data to write] + [2Bytes Reader Waiting
Timeout BCD]
RESPONSE FORMAT
See response code table 3Bytes Status Code (See status code table) + 1Byte Card Type + 8Byte
Card Number
Slot Data = Nilai diset 0x01

Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
11
IV. Flow Transaction
START
Get Last
Transaction
Save Compare Data

Data Response response
F
(Timeout)
Deduct Data Equal Data

Not Equal
Response Deduct
Save Data Trans
Deduct to PC Success
Failed
(011005 / 011006)
S
Check
response
Deduct Failed
END

Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
12
V. Response Code, Status Code, & Card Type
Response Code (1 Byte Hexa) Definition

00 Command success / command accepted
02 Command failed (invalid format, wrong parameter, wrong length, etc)
Status Code (3 Additional Data Definition

Bytes Hexa)
00 00 00 Depend on Function Command execution success
01 10 01 General error
01 10 02 - Reader waiting timeout
01 10 03 - Reader initialization failed (Incorrect
key)
01 10 04 Not enough card balance
01 10 05 1Byte Card Type + 8 Bytes Card Number Reader found lost contact on card
transaction / interrupted transaction
01 10 06 1Byte Expected Card Type + 8 Bytes Reader expected card from previous
Expected Card Number transaction (for auto correction
purpose)
01 10 07 - Deduct Interval less than n second
(default 2 sec)
02 [2 Bytes SAM Last 2 Bytes return error code from SAM
error code]
03 [2 Bytes CTL Last 2 Bytes return error code from
error code] Contactless Card
Card Type Code (1 Byte Hexa) Definition

01 Luminos Prepaid Card
02 MANDIRI eMoney Card
03 BRI BRIZZI Card
04 BNI Tapcash Card
05 BCA FLAZZ Card
06 DKI JakCard
07 NOBU Card
08 MEGA MegaCash Card

Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
13
Lampiran Log
1. Reader Init
Sukses:
=>EF0101758F40D46D95D1641448AA19B9282C05
<=0000000002034567890ABCDE87654321 (MID = 02 03 45 67 89 0A BC DE, TID = 87 65 43 21)
Gagal (Salah Pin)
=>EF010111223344556677889900AABBCCDDEEFF
<=00011003
2. Check Balance
=>EF0102101220171215400001 (Date/Time = 10 Des 2017, 12:15:40PM, Reader Timeout 1 detik)

<=000000000157120171019000040007A0F6 (Card Type 01, No kartu 5712017101900004, Saldo
0007A0F6 = Rp. 499.958)
3. Deduct Rp. 1
=>EF010310122017121550000000010001
(Date/Time = 10 Des 2017, 12:15:50PM, Deduct Rp. 1, Reader Timeout 1 detik)
<=000000000102034567890ABCDE87654321101220171215505710120620170005000000010001D0CC0
0000001CDDDF8D374178432ECDC02FA9E616476DC7D3341B24FCDA12352546FF45B5ADA79F2387FB6
800990EBDAD1EDBCDD3CBA5998E7A746048523759750178AE62DA5355C9CB17AF5F34DFF35865FAF9
60AF4194C5F2B622CCABC9BB09538B076B7F56344ACC65BC7B9B4
Detail Response:
01 = Card Type
02034567890ABCDE = MID Reader
87654321 = TID Reader
10122017121550 = Date/Time (10 Des 2017, 12:15:50PM)
5710120620170005 = Nomor kartu
00000001 = Deduct Amounthex (Rp. 1)
0001D0CC = Sisa Saldo hex (Rp. 118.988)
00000001 = Transaction Number
Data selanjutnya adalah log transaksi untuk settlement:
CDDDF8D374178432ECDC02FA9E616476DC7D3341B24FCDA12352546FF45B5ADA79F2387FB68
00990EBDAD1EDBCDD3CBA5998E7A746048523759750178AE62DA5355C9CB17AF5F34DFF3586
5FAF960AF4194C5F2B622CCABC9BB09538B076B7F56344ACC65BC7B9B4

Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
14
4. Get Last Transaction Log
=>EF0105
<=000000000102034567890ABCDE87654321101220171215505710120620170005000000010001D0CC0
0000001CDDDF8D374178432ECDC02FA9E616476DC7D3341B24FCDA12352546FF45B5ADA79F2387FB6
800990EBDAD1EDBCDD3CBA5998E7A746048523759750178AE62DA5355C9CB17AF5F34DFF35865FAF9
60AF4194C5F2B622CCABC9BB09538B076B7F56344ACC65BC7B9B4
Return datanya sama persis formatnya seperti deduct
5. Deduct dengan error jeda interval (default 2 detik)
=>EF010310122017121540000000010001
<=00011007
Ini terjadi jika dua command deduct dikirim masih dalam rentang waktu jeda interval, yaitu 2 detik, ini
untuk proteksi tambahan terhadap double deduct
6. Deduct dengan error saldo tidak cukup
=>EF010310122017121501000927C00001 (coba deduct dengan amount lebih tinggi dari saldo kartu)
<=000110040157120171019000040007A0F5
Return error dengan tambahan data: Card type, no kartu dan sisa saldo yang tersedia dikartu
7. Deduct dengan error code terjadinya lost contact
=>EF010310122017121505000000010001
<=00011005015712017101900004
Return error dengan tambahan data: Card type dan no kartu
8. Deduct dengan error code terjadinya beda kartu untuk proses correction
=>EF010310122017121505000000010001
<=00011006015712017101900004
Masih lanjutan dari proses di no.7, jika reader ditransaksikan dengan kartu yang berbeda maka akan
muncul error seperti diatas, dengan tambahan data: Expected Card Type & Expected Card Number.
9. Command cancel correction

=>EF0104
<=00000000015712017101900004
Dengan return tambahan data: Expected Card Type & Expected Card Number

Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
15
10. Command Mifare
Get UID
=>EF0107000001
<=00000000410000006F5A04A7 (card Type ‘A’, UID = 0000006F5A04A7)
Read Mifare
(Block 16, key type A, key FFFFFFFFFFFF, reader timeout 1sec)
=>EF010701100AFFFFFFFFFFFF0001
<=0000000000000000000000000000000000000000
Write Mifare
(Block 16, write data 11223344556677889900AABBCCDDEEFF, reader timeout 1sec)
=>EF0107021011223344556677889900AABBCCDDEEFF0001
<=0000000011223344556677889900AABBCCDDEEFF
Read Mifare
(Block 16, key type A, key FFFFFFFFFFFF, reader timeout 1sec)
=>EF010701100AFFFFFFFFFFFF0001
<=0000000011223344556677889900AABBCCDDEEFF

Ph. (+62-21) 2902 0549, 2902 0554, 5435 0146 Fax (+62 -21) 5435 0246
16

COMMAND PROTOCOL READER PARKIR

Hochgeladen von

Dokumentinformationen

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

COMMAND PROTOCOL READER PARKIR

Hochgeladen von

Copyright:

Verfügbare Formate

COMMAND PROTOCOL READER PARKIR

V1.1 10/11/2017 First Release

PT SoftOrb Technolog y Indonesia

PT SoftOrb Technolog y Indonesia

II. Frame Format Protocol

III. List Command Reader Parkir

PT SoftOrb Technolog y Indonesia

Note: MID = 02 03 45 67 89 0A BC DE, TID = 87 65 43 21

PT SoftOrb Technolog y Indonesia

PT SoftOrb Technolog y Indonesia

Kondisi normal yang harus dilakukan

Kondisi khusus (apabila kartu tidak dapat digunakan)

PT SoftOrb Technolog y Indonesia

Apabila sebelumnya tidak terjadi lost contact saat transaksi:

E. Get Last Transaction

PT SoftOrb Technolog y Indonesia

Contoh tersedia di lampiran log.

F.1. Get Card UID

PT SoftOrb Technolog y Indonesia

F.3. Write Block Data Mifare

PT SoftOrb Technolog y Indonesia

G.1. Read Data

G.2. Write Data

PT SoftOrb Technolog y Indonesia

Save Compare Data

Deduct Data Equal Data

PT SoftOrb Technolog y Indonesia

Response Code (1 Byte Hexa) Definition

Status Code (3 Additional Data Definition

Card Type Code (1 Byte Hexa) Definition

PT SoftOrb Technolog y Indonesia

=>EF0102101220171215400001 (Date/Time = 10 Des 2017, 12:15:40PM, Reader Timeout 1 detik)

PT SoftOrb Technolog y Indonesia

5. Deduct dengan error jeda interval (default 2 detik)

6. Deduct dengan error saldo tidak cukup

7. Deduct dengan error code terjadinya lost contact

9. Command cancel correction

PT SoftOrb Technolog y Indonesia

PT SoftOrb Technolog y Indonesia

Das könnte Ihnen auch gefallen