查詢餘額

查詢平台錢包餘額接口。

請求資訊

• 請求 URL： /gateway/api/v1/platforms/balance
• 請求方式： GET
• Content-Type： application/x-www-form-urlencoded; charset=utf-8

請求頭 (Headers)

參數名	類型	說明
Authorization	String	{authorization} 系統分配給平台之授權識別

請求參數

無

返回示例

成功返回

{
  "error_code": "0000",
  "data": {
    "platform_id": "PF0060",
    "platform_channels": [
      {
        "platform_channel_id": "PFC00000141",
        "channel_name": "钻石代收下发",
        "balance": 100200,
        "frozen_balance": 0,
        "sign": "82df5556b8900e2427343381581fe73e"
      },
      {
        "platform_channel_id": "PFC00000142",
        "channel_name": "钻石充值代付",
        "balance": 100100,
        "frozen_balance": 0,
        "sign": "f4912e12897d612d677c36c19d9e05e7"
      }
    ],
    "total": 4,
    "total_balance": 394300,
    "total_frozen_balance": 0,
    "request_time": 1596530514,
    "sign": "1d8f90a6b3d1ef212fb15ace3d294e9b"
  }
}

錯誤返回示例

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

返回參數說明

參數名	類型	說明
error_code	String	錯誤碼
error_msg	String	錯誤訊息（error_code 不為 "0000" 時返回）
platform_id	String	平台商戶 ID
total_balance	Int	總餘額（分）
balance	Int	通道餘額（分）

備註

• authorization 為系統分配給平台之授權識別，如尚未取得請聯繫系統人員
• 外層簽名由 platform_id, total, total_balance, request_time 構成
• 內層簽名由 platform_channel_id, channel_name, balance 構成
• 請參考 簽名規則
• 餘額單位為人民幣（分）