Scan2Pay
  • Scan2Pay API
  • API Introduction
    • API Environment
    • API Security
    • API Request Format
    • API Response Format
    • SDK
  • API Specification
    • Merchant-Presented QR Code
    • Customer-Presented QR Code
    • Credit Card Payment
    • EasyCard Manipulation
      • Obtain the device list
      • Sign on
      • Query the card number
      • Query the balance
      • Payment
      • Refund
      • Settlement
      • Payment Retry (EasyCard)
    • Refund
    • Single Transaction Query
    • Multiple Transactions Query
    • New Multiple Transactions Query
    • Invoice Query
  • Payment Notification
  • Appendix
    • Payment Method Code
    • Transaction Status Code
    • EasyCard Transaction Status Code
    • Printing Information for EasyCard Transaction
    • Card Reader Setup
Powered by GitBook
On this page
  • Request
  • Header
  • Data
  • Response
  • Header
  • Data
  • API Example
  • Request
  • Response

Was this helpful?

  1. API Specification
  2. EasyCard Manipulation

Query the card number

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

Request

Header

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"
  }
}
PreviousSign onNextQuery the balance

Last updated 6 years ago

Was this helpful?

Transaction Status Code
Transaction Status Code