GET https://api.kukopay.com/v1/balance?currency=USD
curl "https://api.kukopay.com/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,
"withdrawable_balance": 1000000,
"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 | 當前賬面可用餘額，可用於退款；未必已在上游清算 |
withdrawable_balance | 當前可申請提現金額。正式環境只計入上游已可用且經對賬確認的資金，並扣除退款、爭議、負向調賬與已申請提現 |
frozen_balance | 提現審核或異步退款處理中凍結的金額 |
total_revenue | 累計收單總額 |
total_fee | 累計手續費 |
total_payout | 累計已提現金額 |
total_refund | 累計已退款金額 |
所有金額單位都是最小貨幣單位。沙箱與正式錢包完全隔離，返回哪個錢包由 API Key 決定。