获取钱包余额

GET/api/v1/wallets/{walletBizId}/balanceHMAC

返回指定钱包的当前余额信息。

请求头

Name	Type	Required	Description
X-Api-Key	string	required	API 密钥标识符
X-Signature	string	required	HMAC-SHA256 签名
X-Timestamp	string	required	Unix 时间戳（秒）
X-Nonce	string	required	唯一请求标识符（UUID）

路径参数

Name	Type	Required	Description
walletBizId	string	required	钱包业务 ID

请求示例

curl -X GET https://api.lampay.app/api/v1/wallets/<walletBizId>/balance \
  -H "X-Api-Key: sk_live_xxx" \
  -H "X-Signature: <computed_signature>" \
  -H "X-Timestamp: 1709337600" \
  -H "X-Nonce: 550e8400-e29b-41d4-a716-446655440000"

响应

200成功

{
  "version": "1.3.0",
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "walletBizId": "wlt_abc123",
    "currency": "USD",
    "availableBalance": 1300.25,
    "frozenBalance": 200,
    "totalBalance": 1500.25,
    "updatedAt": "2026-03-02T10:20:30Z"
  }
}