卡號查詢

IdQuery - 卡號查詢

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

Request

欄位

必填

型別

範例

說明

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"
}
}