余额查询接口

基础信息

• 传输协议：HTTPS
• 数据格式：Content-Type: application/json
• 认证方式：请求体携带 mer_no 与 api_key
• 接口路径：/api/merchants/balance
• 接口 API URL：联系平台获取

查询余额

查询商户当前可用余额。

请求

POST <API_URL>/api/merchants/balance（联系平台获取）

请求头

参数名	必填	示例值	说明
Content-Type	是	application/json	请求体类型

请求体（JSON）

参数名	类型	必填	说明
mer_no	string	是	商户号
api_key	string	是	商户密钥

示例请求（JSON）

{
  "mer_no": "mer_123456789",
  "api_key": "******"
}

响应

成功响应示例

{
  "code": 200,
  "status": "success",
  "message": "查询成功",
  "data": {
    "merchant_no": "mer_123456789",
    "balance": 100.0
  }
}

balance 为数字类型；当商户余额为空时，返回 0.00。

错误响应示例

商户号不存在：

{
  "code": 401,
  "status": "error",
  "message": "商户号不存在"
}

商户已被禁用：

{
  "code": 403,
  "status": "error",
  "message": "商户已被禁用"
}

API Key 不匹配：

{
  "code": 403,
  "status": "error",
  "message": "API Key 不匹配"
}