Obtain the device list

DeviceQuery – Obtain the information of the reader bound with the merchant ID

Request

Header

Item	Mandatory	Data Type	Sample	Description
Method	YES	String(5)	31800	Fill in 31800 (EasyCard transaction)
ServiceType	YES	String	DeviceQuery	Selected Scan2Pay Service type
MchId	YES	String	Account0001	Merchant ID provided by intella
TradeKey	YES	String	sha256...hash	Marchant password provided by intella, this password must be encoded by SHA256
CreateTime	YES	String	20180101120000	Request time, the format is "yyyyMMddHHmmss"

Data

Item	Mandatory	Data Type	Sample	Description
DeviceId	YES	String	00000000	Fixed at "00000000"
Retry	YES	String	0	Retry times, Fill in 0

Response

Header

Item	Data Type	Sample	Description
StatusCode	String(4)	0000	Transaction Status Code
StatusDesc	String	Success	Description of transaction status
Method	String(5)	31800	Payment method code (EasyCard payment is 31800)
ServiceType	String	DeviceQuery	Selected Scan2Pay Service type
MchId	String	Account0001	Merchant ID
ResponseTime	String	20180101120000	Transaction response time, the format is “yyyyMMddHHmmss”

Data

Item	Data Type	Sample	Description
DeviceList	JSON Array	Please see the follows	Device (Reader) List

DeviceList array contents

Item	Data Type	Sample	Description
type	String	ezc
ownerDeviceId	String	01301234	Reader number
batchNumber	String	1
ezcDongleId	String	08100DE0A57E
aesKey	String	f3c013cb...27934

The reader device ID binds with the merchant ID and is managed by intella. Please contact intella to obtain the reader and active setting.

The API allows to retrieve response data when the reader is offline.

API Example

Request

{
  "Header": {
    "Method": "31800",
    "ServiceType": "DeviceQuery",
    "MchId": "ACCOUNT001",
    "TradeKey": "9af15b33........606529a0",
    "CreateTime": "20170830192428"
  },
  "Data": "{\"DeviceId\":\"00000000\",\"Retry\":\"0\"}"
}

Response

{
  "Header": {
    "StatusCode": "0000",
    "StatusDesc": "STATUS_SUCCESS",
    "Method": "31800",
    "ServiceType": "DeviceQuery",
    "MchId": "ACCOUNT001",
    "ResponseTime": "20170830192427"
  },
  "Data": {
    "DeviceList": [
      {
        "type": "ezc",
        "ownerDeviceId": "12341234",
        "batchNumber": 9,
        "ezcDongleId": "0C100DE0A57E",
        "aesKey": "2fb7....4786"
      }
    ]
  }
}