跳转到主要内容
POST
/
open-api
/
v1
/
card
/
consume
/
list
curl --request POST \
  --url https://sandbox-openplatform.keysecure.io/open-api/v1/card/consume/list \
  --header 'Content-Type: application/json' \
  --header 'Api-Key: your_api_key' \
  --header 'Timestamp: 1716307200000' \
  --header 'Access-Token: your_access_token' \
  --header 'Timezone: UTC+8' \
  --data '{
    "cardholder_no": "",
    "consume_no": "",
    "card_no": "",
    "start_time": "2026-01-01",
    "end_time": "2026-03-31",
    "page": 0,
    "size": 10
  }'

{
  "code": 0,
  "msg": "Success",
  "data": {
    "list": [{
      "consume_no": "",
      "card_no": "",
      "type": "Consumption",
      "amount": "100.00",
      "status": "Success",
      "time": 1716307200000
    }]
  }
}
查询卡消费记录列表。

​
请求头

​
Api-Key
string
必填
apiKey（商户凭证，与 IP 白名单绑定）
​
Timestamp
string
必填
Unix 时间戳（毫秒），与服务端偏差须在 60 秒内，且不接受未来时间戳
​
Access-Token
string
必填
登录标识（除获取 Token 外必填）
​
Content-Type
string
默认值:"application/json"
固定为 application/json
​
Timezone
string
默认值:"UTC+8"
时区，影响 start_time / end_time 的日界计算，默认 UTC+8

​
请求体

​
cardholder_no
string
持卡人单号
​
consume_no
string
卡消费单号
​
card_no
string
卡单号
​
start_time
string
必填
开始时间（yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss）
​
end_time
string
必填
结束时间（同上；间隔 ≤90 天）
​
page
number
默认值:"0"
查询页码，默认 0
​
size
number
默认值:"10"
查询条数，默认 10（最多 100 条）

​
返回参数

​
code
number
响应状态码，0 表示成功
​
msg
string
响应消息
​
data
object
返回数据
curl --request POST \
  --url https://sandbox-openplatform.keysecure.io/open-api/v1/card/consume/list \
  --header 'Content-Type: application/json' \
  --header 'Api-Key: your_api_key' \
  --header 'Timestamp: 1716307200000' \
  --header 'Access-Token: your_access_token' \
  --header 'Timezone: UTC+8' \
  --data '{
    "cardholder_no": "",
    "consume_no": "",
    "card_no": "",
    "start_time": "2026-01-01",
    "end_time": "2026-03-31",
    "page": 0,
    "size": 10
  }'

{
  "code": 0,
  "msg": "Success",
  "data": {
    "list": [{
      "consume_no": "",
      "card_no": "",
      "type": "Consumption",
      "amount": "100.00",
      "status": "Success",
      "time": 1716307200000
    }]
  }
}