Skip to main content
GET
/
agent
/
v1
/
cards
/
list
curl --location 'https://kf.pikabao.cc/agent/v1/cards/list?appid=user123&timestamp=1640995200000&sign=ABC123...'

{
  "code": 0,
  "msg": "",
  "content": [
    {
      "id": "111222333",
      "organization": "VISA",
      "state": 1,
      "number": "5572710152044****",
      "expiryDate": "10/25",
      "cvv": "456",
      "remark": "我的第一张卡",
      "createTime": "2023-01-01 00:00:00",
      "modifyTime": "2023-01-01 00:00:00",
      "cardBalance": "100.00"
    },
    {
      "id": "444555666",
      "organization": "MASTERCARD",
      "state": 1,
      "number": "5572710152055****",
      "expiryDate": "10/25",
      "cvv": "789",
      "remark": "我的第二张卡",
      "createTime": "2023-01-01 00:00:00",
      "modifyTime": "2023-01-01 00:00:00",
      "cardBalance": "200.00"
    }
  ]
}

​
请求参数

​
appid
string
required
用户标识
​
userBankId
string
信用卡 ID，可选参数
​
userBankNum
string
信用卡卡号，可选参数
​
timestamp
string
required
当前时间戳（毫秒），与平台服务器时间不可相差超过 5 分钟
​
all
string
是否查询所有卡，不传则只查询激活的卡
​
sign
string
required
签名值

​
响应

​
code
integer
响应代码，0 表示成功
​
msg
string
响应消息
​
content
array
信用卡列表
curl --location 'https://kf.pikabao.cc/agent/v1/cards/list?appid=user123&timestamp=1640995200000&sign=ABC123...'

{
  "code": 0,
  "msg": "",
  "content": [
    {
      "id": "111222333",
      "organization": "VISA",
      "state": 1,
      "number": "5572710152044****",
      "expiryDate": "10/25",
      "cvv": "456",
      "remark": "我的第一张卡",
      "createTime": "2023-01-01 00:00:00",
      "modifyTime": "2023-01-01 00:00:00",
      "cardBalance": "100.00"
    },
    {
      "id": "444555666",
      "organization": "MASTERCARD",
      "state": 1,
      "number": "5572710152055****",
      "expiryDate": "10/25",
      "cvv": "789",
      "remark": "我的第二张卡",
      "createTime": "2023-01-01 00:00:00",
      "modifyTime": "2023-01-01 00:00:00",
      "cardBalance": "200.00"
    }
  ]
}

​
卡状态说明

状态值说明描述
1激活卡片可正常使用
2冻结卡片已冻结，无法交易
0销卡卡片已注销