Query the card number

The card number queried by this API is the internal serial number of the card.

Request

Item

Mandatory

Data Type

Sample

Description

Method

YES

String(5)

31800

Fill in 31800 (EasyCard transaction)

ServiceType

YES

String

IdQuery

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

01301234

Terminal (reader) number

Retry

YES

String

0

Retry times, fill in 0

Response

Header

Item

Data Type

Sample

Description

StatusCode

String(4)

0000

StatusDesc

String

Success

Description of transaction status

Method

String(5)

31800

Payment method code (EasyCard payment is 31800)

ServiceType

String

IdQuery

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

EZCardID

String

934521234

Internal card number

TXNResult

String

Success

Transaction result

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

Last updated