AUD 残高 API リファレンス

curl --request GET \
  --url https://api-merchant.helloclever.co/api/v1/balances/detail \
  --header 'app-id: YOUR_APP_ID' \
  --header 'secret-key: YOUR_SECRET_KEY'

{
  "currency": "AUD",
  "available_balance": 12450.75,
  "incoming_balance": 3200.00,
  "outgoing_balance": 500.00,
  "rolling_reserve_balance": 1000.00,
  "withdrawable_balance": 11450.75,
  "retrieved_at": "2026-04-17T10:00:00Z"
}

{
  "error": "Unauthorized",
  "message": "Invalid app-id or secret-key."
}

curl --request GET \
  --url 'https://api-merchant.helloclever.co/api/v1/balances/history?from_date=2026-04-01&to_date=2026-04-17&page=1' \
  --header 'app-id: YOUR_APP_ID' \
  --header 'secret-key: YOUR_SECRET_KEY'

{
  "data": [
    {
      "id": "bh_entry_001",
      "type": "payment_received",
      "amount": 99.95,
      "balance_after": 12450.75,
      "reference_id": "pr_abc123",
      "description": "Payment received for Order #1042",
      "created_at": "2026-04-17T10:15:00Z"
    },
    {
      "id": "bh_entry_002",
      "type": "refund_issued",
      "amount": -250.00,
      "balance_after": 12200.75,
      "reference_id": "ref_jkl012",
      "description": "Refund issued for Invoice #5021",
      "created_at": "2026-04-17T11:00:00Z"
    }
  ],
  "total": 2,
  "page": 1
}

{
  "error": "UnprocessableEntity",
  "message": "from_date and to_date are required."
}