残高を照会
GET /v1/balance?currency=USD は API キーが指定する環境のウォレット残高を返します。
重要なポイント
- available_balance は返金に使える台帳上の残高、withdrawable_balance は出金可能額です。
- frozen_balance は確保中の資金です。累計項目には total_revenue、total_fee、total_refund、total_payout があります。
- 本番の出金可能額は表示上の残高だけでなく、上流での精算と照合に依存します。
例
bash
curl "https://api.kukopay.com/v1/balance?currency=USD" \
-H "X-Api-Key: $KUKOPAY_API_KEY"