注册商户

GET · /api/v1/wallet/recharge/page

充值列表

分页查询当前应用下所有充值记录，按 id 倒序（最新在前）。

对账模式

主路径：配置 RECHARGE 回调，到账即时推送。
兜底路径：定期分页拉取本接口对账，补漏 webhook 服务停机期间未处理的记录。
GET/api/v1/wallet/recharge/page HMAC

Header 参数

X-Api-Key
string required
应用 apiKey。沙箱前缀 pk_test_，正式 pk_live_。
例： pk_test_4f9d8ab1c0e74...
X-Timestamp
integer (UNIX 毫秒) required
请求发起时刻的 UNIX 毫秒时间戳（13 位整数）。与服务端时差不能超过 ±300000ms（5 分钟）。
例： 1746450000000
X-Nonce
string required
本次请求的随机串，建议 UUID v4 或 16 字节 hex。同一 (apiKey, nonce) 在 10 分钟窗口内不可重复。
例： 8e3a1c2f7b6d4a90
X-Signature
string required
HMAC-SHA256 签名（小写 hex，64 字符）。算法：HMAC(secret, METHOD + "\n" + PATH + "\n" + ts + "\n" + nonce + "\n" + SHA256(body))。详见 鉴权章节。
例： 6e4a8c1f...（64 字符）

Query 参数

pageNo
integer optional
页码，从 1 开始，默认 1。
例： 1
pageSize
integer optional
每页条数，默认 20，最大 200。
例： 20

请求示例

# 签名算法（stringToSign / 4 个 header）见 /docs/api/auth
API_KEY=pk_test_xxx
SECRET=sk_test_xxx
METHOD=GET
REQ_PATH="/api/v1/wallet/recharge/page?pageNo=1&pageSize=20"
TS=$(( $(date +%s) * 1000 ))
NONCE=$(uuidgen | tr -d '-' | tr '[:upper:]' '[:lower:]')
# GET 请求 body 为空，body hash = SHA256("")
BODY_SHA=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
SIG=$(printf "%s\n%s\n%s\n%s\n%s" "$METHOD" "$REQ_PATH" "$TS" "$NONCE" "$BODY_SHA" \
  | openssl dgst -sha256 -hmac "$SECRET" -hex | awk '{print $2}')

curl -G "https://api.pqpa.com/api/v1/wallet/recharge/page" \
  --data-urlencode "pageNo=1" \
  --data-urlencode "pageSize=20" \
  -H "X-Api-Key:    $API_KEY" \
  -H "X-Timestamp:  $TS" \
  -H "X-Nonce:      $NONCE" \
  -H "X-Signature:  $SIG"

响应

Response
200OK
{
  "code": 0,
  "data": {
    "list": [
      {
        "id":                9001,
        "chainCode":         "ETH",
        "tokenSymbol":       "USDT",
        "address":           "0xab12cd34ef56789000000000000000000000001",
        "fromAddress":       "0xSender000000000000000000000000000000001",
        "txHash":            "0x9ab8c4f7e2d1000000000000000000000000000000000000000000000000abcd",
        "amount":            "150.5",
        "blockHeight":       21430500,
        "blockTime":         "2026-05-05T12:30:00",
        "confirmStatus":     "CONFIRMED",
        "collectionStatus":  "COLLECTED",
        "createTime":        "2026-05-05T12:34:56"
      },
      {
        "id":                9002,
        "chainCode":         "TRON",
        "tokenSymbol":       "USDT",
        "address":           "TLa2f6VPqDgRE67v1736cZbF1Kkkcd8...",
        "fromAddress":       "TPLnYzSender...",
        "txHash":            "7ab8d4e7c2f1000000000000000000000000000000000000000000000000bcde",
        "amount":            "200.0",
        "blockHeight":       58726120,
        "blockTime":         "2026-05-05T11:20:00",
        "confirmStatus":     "WAITING",
        "collectionStatus":  "NONE",
        "createTime":        "2026-05-05T11:24:00"
      }
    ],
    "total": 42
  },
  "msg": ""
}

data 字段说明

list
array required
充值记录列表，各字段见下方。
total
integer required
符合条件的总记录数。
list[].id
integer required
充值记录主键。
list[].chainCode
string required
公链 code。
list[].tokenSymbol
string required
代币 symbol，如 USDT。
list[].address
string required
收币地址（派付分配给用户的充值地址）。
list[].fromAddress
string required
链上转出方地址。
list[].txHash
string required
链上交易 hash。
list[].amount
string required
到账金额（字符串 BigDecimal，必须当字符串处理）。
list[].blockHeight
integer? optional
所在区块高度；入块前为 null。
list[].blockTime
string? optional
区块时间，格式 yyyy-MM-ddTHH:mm:ss；入块前为 null。
list[].confirmStatus
string required
链上确认状态。
取值：WAITINGCONFIRMEDREORGFAILED
list[].collectionStatus
string required
归集状态。
取值：NONEWAITINGCOLLECTINGCOLLECTEDSKIPPEDDISABLEDFAILED
list[].createTime
string required
记录创建时间，格式 yyyy-MM-ddTHH:mm:ss。

下一步