注册商户

GET · /api/v1/wallet/recharge/get

查询单条充值

按充值记录 id 查询完整快照。收到 RECHARGE 回调后，建议用 payload 中的 id 调本接口反查最新状态做对账。

对账最佳实践

收到 RECHARGE 系列回调时，不要直接信任 payload 里的 confirmStatus。 建议用 payload 中的 id 调本接口拿当前状态—— payload 是事件快照，网络重试或乱序可能让你拿到旧值。
GET/api/v1/wallet/recharge/get 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 参数

id
integer required
充值记录主键 id（充值列表或回调 payload 中的 id 字段）。
例： 9001

请求示例

# 签名算法（stringToSign / 4 个 header）见 /docs/api/auth
API_KEY=pk_test_xxx
SECRET=sk_test_xxx
METHOD=GET
REQ_PATH="/api/v1/wallet/recharge/get?id=9001"
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/get" \
  --data-urlencode "id=9001" \
  -H "X-Api-Key:    $API_KEY" \
  -H "X-Timestamp:  $TS" \
  -H "X-Nonce:      $NONCE" \
  -H "X-Signature:  $SIG"

响应

Response
200OK
{
  "code": 0,
  "data": {
    "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"
  },
  "msg": ""
}

data 字段说明

id
integer required
充值记录主键。
chainCode
string required
公链 code。
tokenSymbol
string required
代币 symbol，如 USDT。
address
string required
收币地址（派付分配给用户的充值地址）。
fromAddress
string required
链上转出方地址。
txHash
string required
链上交易 hash。
amount
string required
到账金额（字符串 BigDecimal，必须当字符串处理）。
blockHeight
integer? optional
所在区块高度；入块前为 null。
blockTime
string? optional
区块时间，格式 yyyy-MM-ddTHH:mm:ss；入块前为 null。
confirmStatus
string required
链上确认状态：WAITING 待确认；CONFIRMED 已达确认数阈值；REORG 链重组；FAILED 交易失败。
取值：WAITINGCONFIRMEDREORGFAILED
collectionStatus
string required
归集状态：NONE 未触发；WAITING 待归集；COLLECTING 归集中；COLLECTED 已归集；SKIPPED 跳过；DISABLED 已禁用；FAILED 归集失败。
取值：NONEWAITINGCOLLECTINGCOLLECTEDSKIPPEDDISABLEDFAILED
createTime
string required
记录创建时间，格式 yyyy-MM-ddTHH:mm:ss。

下一步