跳到主要内容

查询余额

查询平台钱包余额接口。

请求资讯

  • 请求 URL: /gateway/api/v2/platforms/balance
  • 请求方式: GET

请求头 (Headers)

参数名类型说明
AuthorizationString{authorization} 系统分配给平台之授权识别

请求参数

返回示例

成功返回

{
"error_code": "0000",
"data": {
"platform_id": "PF0001",
"total_balance": 200300,
"total_frozen_balance": 0
}
}

错误返回示例

{
"error_code": "0006",
"error_msg": "无效的Authorization!"
}

返回参数说明

参数名类型说明
error_codeString错误码,详见全局错误码
error_msgString错误讯息(error_code 不为 "0000" 时返回)
platform_idString平台商户 ID
total_balanceInt总余额(分)
total_frozen_balanceInt总冻结余额(分)
备注

本接口返回的是商户在平台的账户记账余额(单位:分),USDT 渠道收款到账后计入该账户。此余额非链上 USDT 余额,渠道侧的链上结算余额由平台内部管理,不通过本接口对外开放。

备注

  • authorization 为系统分配给平台之授权识别,如尚未取得请联系系统人员
  • 余额单位为分