卡號查詢

IdQuery - 卡號查詢

此API所查詢到的卡號，為卡片的隱碼(4 byte長度的識別碼轉換為十進制卡號，長度最長為10位數)

Request

Header

欄位	必填	型別	範例	說明
Method	YES	String(5)	31800	支付方式, 悠遊卡使用31800
ServiceType	YES	String	IdQuery	服務代碼
MchId	YES	String	Account0001	特店帳號
TradeKey	YES	String	sha256...hash	交易密碼(sha256編碼)
CreateTime	YES	String	20180101120000	建立日期, yyyyMMddHHmmss

Data

欄位	必填	型別	範例	說明
DeviceId	YES	String	01301234	終端機(讀卡機)編號
Retry	YES	String	0	重試次數, 請帶入0

Response

Header

欄位	型別	範例	說明
StatusCode	String(4)	0000	交易結果代碼
StatusDesc	String	交易成功	交易結果代碼說明
Method	String(5)	31800	支付方式, 悠遊卡使用31800
ServiceType	String	IdQuery	服務代碼
MchId	String	Acount0001	特店帳號
ResponseTime	String	20180101120000	交易回應時間, yyyyMMddHHmmss

Data

欄位	型別	範例	說明
EZCardID	String	934521234	卡號(隱碼)
TXNResult	String	Success	交易結果
Retry	String	0
ErrorCode	String	000000	交易結果代碼
NewAESKey	String	fab7954d...5a95dcc

API Example

Request

{
  "Header": {
    "Method": "31800",
    "ServiceType": "IdQuery",
    "MchId": "myMchId",
    "TradeKey": "9af15b336e6a9619928537df30b2e6a2376569fcf9d7e773eccede65606529a0",
    "CreateTime": "20180715104204"
  },
  "Data": "{\"DeviceId\":\"01304187\",\"Retry\":\"0\"}"
}

Response

{
  "Header": {
    "StatusCode": "0000",
    "StatusDesc": "STATUS_SUCCESS",
    "Method": "31800",
    "ServiceType": "IdQuery",
    "MchId": "myMchId",
    "ResponseTime": "20180715104207"
  },
  "Data": {
    "EZCardID": "1917740208",
    "TXNResult": "Success",
    "Retry": "0",
    "ErrorCode": "000000",
    "NewAESKey": "f87199d23627957cf17f4ccb7e2e1ae7"
  }
}