查询当前 API Key 所属环境的商户钱包余额。
GET https://web.kukopay.com/api/v1/balance?currency=USD
curl "https://web.kukopay.com/api/v1/balance?currency=USD" \
-H "X-Api-Key: $KUKOPAY_API_KEY"currency 为 USD、HKD 或 CNY，默认 USD。每个币种是独立的钱包，余额、手续费和提现都在各自币种内计算，不会自动换汇。
{
"code": 200,
"message": "success",
"data": {
"merchant_id": "mch_xxxxxxxxxx",
"currency": "USD",
"mode": "live",
"available_balance": 1284500,
"frozen_balance": 0,
"total_revenue": 1350000,
"total_fee": 47250,
"total_payout": 0,
"total_refund": 18250,
"updated_at": "2026-09-21T12:00:00.000Z"
}
}| 字段 | 含义 |
|---|---|
available_balance | 当前可用于提现或退款的金额 |
frozen_balance | 提现审核或异步退款处理中冻结的金额 |
total_revenue | 累计收单总额 |
total_fee | 累计手续费 |
total_payout | 累计已提现金额 |
total_refund | 累计已退款金额 |
所有金额单位都是最小货币单位。沙箱与正式钱包完全隔离，返回哪个钱包由 API Key 决定。