Safira Paydocs

查询账户余额

GET /api/balance

返回已认证账户的总余额、冻结余额和净余额。

认证

需要在 Authorization 头中提供 Bearer 令牌。

响应 (200)

字段类型描述
grossBalancenumber总余额(可用金额 + 冻结金额)
blockedBalancenumber冻结余额(为待处理操作预留)
netBalancenumber净余额(可用金额)
consultedAtstring查询日期和时间(ISO 8601)
{
  "grossBalance": 48734.90,
  "blockedBalance": 0,
  "netBalance": 48734.90,
  "consultedAt": "2025-11-19T20:18:29.384Z"
}

错误

状态码描述
401令牌无效、已过期或缺失

本页目录