商户信息

查询商户基础信息

返回当前商户的基础资料。此接口不返回余额。

• 请求方法：GET
• 接口路径：/api/v1/mch/info

请求参数

参数名	类型	必填	说明
mch_id	integer	是	商户号
nonce	string	是	随机串
timestamp	integer	是	时间戳
sign	string	是	参见签名算法

返回字段

字段	类型	说明
id	string	商户号
name	string	商户名称
created_at	string	开通时间

返回示例

{
  "code": 200,
  "payload": {
    "id": "10001",
    "name": "Demo Merchant",
    "created_at": "2026-05-04 10:00:00"
  }
}

查询商户余额

返回指定币种的钱包余额。

• 请求方法：GET
• 接口路径：/api/v1/mch/balance

请求参数

参数名	类型	必填	说明
mch_id	integer	是	商户号
currency	string	是	币种代码，建议使用大写，参见系统货币代码
nonce	string	是	随机串
timestamp	integer	是	时间戳
sign	string	是	参见签名算法

返回字段

字段	类型	说明
balance	number	商户余额

返回示例

{
  "code": 200,
  "payload": {
    "balance": 23456
  }
}

注意

若未传 currency，接口会直接返回错误：Missing currency param。若商户没有对应币种账户，也会直接报错。