Balance 余额

请求

API URL: /merchant/v2/{GUID}/balance

Note

{GUID} 由商户后台取得（API 对接 -> GUID）

✅ 必填 ⭕ 可選 ❌ 不適用

标头	内容	说明
Content-Type	text/plain
X-Transaction-Signature	{transaction_signature}	请参阅 交易签名

参数	类型	必填	签名	描述
user_id	字符串	✅	✅	商户标识码
balance_mode	整数	⭕	❌	0 = 返回总余额（默认） 1 = 返回可提取的余额 2 = 返回总余额及可提取的余额
timestamp	整数	✅	✅	请求时间戳（10位数字），允许时间差为5秒，超过则失败
sign	字符串	✅	❌	签名字符串。请参阅 数据签名与验证

响应

参数	类型	必填	签名	描述
user_id	字符串	✅	✅	商户标识码
PHP	物件	⭕	❌	显示通道与通道的余额 (请参阅下方 响应示例)
sign	字符串	✅	❌	签名字符串。请参阅 数据签名与验证

响应示例

balance_mode = 0

{
  "code": "1000",
  "message": "Accepted",
  "data": {
    "user_id": "1",
    "PHP": {
      "BANK_API": 1990,
      "QRPH": 0
    },
    "sign": "QHnRqweqweeqw23aQmUGTfPCVNKLzels+..."
  }
}

balance_mode = 1

{
  "code": "1000",
  "message": "Accepted",
  "data": {
    "user_id": "1",
    "PHP": {
      "BANK_API": 1970,
      "QRPH": 0
    },
    "sign": "QHnRBlfzyIa72eaQmUGTfPCVNKLzels+..."
  }
}

balance_mode = 2

{
  "code": "1000",
  "message": "Accepted",
  "data": {
    "user_id": "1",
    "PHP": {
      "BANK_API": {
        "total": 1990,
        "available": 1970
      },
      "QRPH": {
        "total": 0,
        "available": 0
      }
    },
    "sign": "KB5wsnyv64IL24GkSWUHIbdEG5QhdwFZqQa4Fn3..."
  }
}