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),避免单次查询数据量过大

使用场景

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