商户钱包 API

修订与版本

• 版本：1.0
• 最后更新：2025-03-14

接口

• URL：/api/v2/merchant/wallet
• 请求方式：GET
• 认证方式：必需（参见全局认证指南）

请求参数

参数	类型	是否必填	描述
-	-	-	此接口不需要额外的请求参数

响应参数

APIMerchantWalletResponse 字段说明

参数	类型	描述
totalBalance	BigDecimal	商户账户总余额
availableBalance	BigDecimal	可用余额
frozenBalance	BigDecimal	冻结余额
withdrawal	WithdrawInfo	提现相关信息

WithdrawInfo 字段说明

参数	类型	描述
withdrawableBalance	BigDecimal	可提现余额
withdrawalRestriction	WithdrawRestriction	提现限制信息

WithdrawRestriction 字段说明

参数	类型	描述
depositFreezeDuration	Int	存款冻结时间（单位：分钟）
depositTransactionCount	Int	存款交易笔数
depositTransactionAmount	BigDecimal	存款交易总金额

请求示例

curl -X GET https://{YOUR_ENDPOINT}/api/v2/merchant/wallet \
  -H "Content-Type: application/json;charset=UTF-8" \
  -H "access_key: {YOUR_ACCESS_KEY}" \
  -H "signature: {GENERATED_BY_Hmac256}" \
  -H "timestamp: {TIMESTAMP_IN_MILLISECONDS}"

响应示例

{
  "data": {
    "totalBalance": 1000.50,
    "availableBalance": 800.00,
    "frozenBalance": 200.50,
    "withdrawal": {
      "withdrawableBalance": 500.00,
      "withdrawalRestriction": {
        "depositFreezeDuration": 86400,
        "depositTransactionCount": 5,
        "depositTransactionAmount": 1000.00
      }
    }
  },
  "isSuccess": true,
  "statusCode": "SUCCESS",
  "message": "Request successful",
  "version": "2.0"
}