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

{
  "code": 0,
  "msg": "成功",
  "total": 136,
  "rows": [
    {
      "id": "UO123456789",
      "transactionId": "789-asdas-jalksjdlak",
      "cardNum": "5572710152044****",
      "clientId": "4546464644",
      "type": "Consumption",
      "status": "Finish",
      "amount": "-25.50",
      "merchantName": "Amazon",
      "remark": "在线购物",
      "recordTime": "2024-08-28T05:13:37.000+00:00"
    },
    {
      "id": "UO123456790",
      "transactionId": "790-bsdbs-kblkteklbl",
      "cardNum": "5572710152044****",
      "clientId": "4546464644",
      "type": "Recharge",
      "status": "Finish",
      "amount": "+100.00",
      "merchantName": "",
      "remark": "充值",
      "recordTime": "2024-08-27T10:30:15.000+00:00"
    }
  ]
}

​
请求参数

​
appid
string
required
用户标识
​
number
string
信用卡卡号（可选，不传则查询所有卡的交易）
​
page
integer
required
页码，从 1 开始
​
pageSize
integer
required
每页显示数量
​
timestamp
string
required
当前时间戳（毫秒）
​
sign
string
required
签名值

​
响应

​
code
integer
响应代码
​
msg
string
响应消息
​
total
integer
总记录数
​
rows
array
交易记录列表
curl --location 'https://kf.pikabao.cc/agent/v1/cards/transactions?appid=user123&page=1&pageSize=20&timestamp=1640995200000&sign=ABC123...'

{
  "code": 0,
  "msg": "成功",
  "total": 136,
  "rows": [
    {
      "id": "UO123456789",
      "transactionId": "789-asdas-jalksjdlak",
      "cardNum": "5572710152044****",
      "clientId": "4546464644",
      "type": "Consumption",
      "status": "Finish",
      "amount": "-25.50",
      "merchantName": "Amazon",
      "remark": "在线购物",
      "recordTime": "2024-08-28T05:13:37.000+00:00"
    },
    {
      "id": "UO123456790",
      "transactionId": "790-bsdbs-kblkteklbl",
      "cardNum": "5572710152044****",
      "clientId": "4546464644",
      "type": "Recharge",
      "status": "Finish",
      "amount": "+100.00",
      "merchantName": "",
      "remark": "充值",
      "recordTime": "2024-08-27T10:30:15.000+00:00"
    }
  ]
}

​
交易类型 (type)

类型说明金额符号
Consumption消费支出-
Recharge卡充值+
CashOut卡提现-
Credit退款+
Reversal交易撤销+
Frozen冻结-
UnFrozen解冻+
Refuse拒绝交易0

​
交易状态 (status)

状态说明描述
Pending清算中交易正在处理中
Finish已结算交易已完成
Failed失败交易失败
建议设置合理的 pageSize（如 20-50），避免单次查询数据量过大

​
使用场景

  • 对账：定期查询交易记录进行对账
  • 监控：实时监控卡片消费情况
  • 分析：分析消费模式和趋势
  • 审计：提供交易审计追踪