<!-- https://unlockos.io/ja/manual/go-history -->

# ご利用・お支払い履歴

## 概要

Goポータル（`go.unlockos.io/{slug}/history`）の「履歴」タブでは、この施設での**ご利用とお支払いの記録**を一元的に確認できます。ページタイトルは**「ご利用・お支払い履歴」**、サブタイトルは**「ご利用とお支払いの記録です。メンバーシップの無料ご利用も表示されます。」**と表示されます。

お支払いだけでなく、**メンバーシップの利用枠でカバーされた無料チェックイン**も表示されます。料金が発生しなかったチェックインも「無料」として記録されます。

## 主な機能

- お支払いと無料のご利用を1つの新しい順のタイムラインでまとめて確認
- 期間で絞り込み：**3ヶ月**・**6ヶ月**・**1年**（デフォルト）・**全期間**
- 各記録のステータスバッジ：支払済・無料・処理中・失敗・返金済
- お支払い記録から Stripe の領収書リンクを直接表示
- **もっと見る**ボタンで過去の記録を追加読み込み

---

## 履歴に表示される記録 — 完全なリスト

履歴は2つのデータソースをまとめて、新しい順に表示します。

### データソース1：確定済みお支払い（`user_transactions` から）

Stripe で決済が確定した課金・返金です。このソースのすべての記録に金額が表示されます。

| 種類 | アイコン | ステータスバッジ | 金額表示 | 領収書リンク |
|-----------|------|--------------|------|------|
| メンバーシップ | 👤 | **支払済**（緑） | あり | あり |
| チェックイン課金 | 🔑 | **支払済**（緑） | あり | あり |
| 宿泊予約 | 🏨 | **支払済**（緑） | あり | あり |
| ロッカー予約 | 🔒 | **支払済**（緑） | あり | あり |
| 置き配ロッカー | 📦 | **支払済**（緑） | あり | あり |
| 上記いずれかの返金 | 同アイコン | **返金済**（オレンジ） | あり（−付き） | あり |
| 上記いずれかの処理中 | 同アイコン | **処理中**（黄） | あり | なし |
| 上記いずれかの失敗 | 同アイコン | **失敗**（赤） | あり | なし |

### データソース2：無料チェックイン（利用枠カバー済み）

`total_fee` がゼロまたは未設定（メンバーシップの利用枠で完全にカバーされた）チェックインは、チェックイン記録から直接取得されます。料金が発生しないため Stripe への課金・決済は行われず、支払い記録は生成されません。すべての活動を履歴に反映するためにここに表示されます。

| 種類 | アイコン | ステータスバッジ | 金額表示 | 領収書リンク |
|-----------|------|--------------|------|------|
| 無料チェックイン | 🔑 | **無料**（青） | **なし**（料金なしはバッジで表示） | なし |

無料チェックインの説明欄にはチェックイン設定名（スペース名やアクセスポイント名など）が表示されます。日付はチェックアウト（利用終了）日時です。

---

## 履歴に表示されないもの

**発生済みでも Stripe による請求・課金が確定していない従量課金・超過分は表示されません。**お支払いが Stripe で確定し `user_transactions` に記録されると表示されます。これは現在の仕様です。履歴は確定した活動の記録であり、未確定の課金メーターではありません。

---

## 期間フィルター

4つのフィルターボタンで表示期間を絞り込めます。デフォルトは**1年**です。

| ボタンラベル | 範囲 |
|-----|-------|
| 3ヶ月 | 過去3ヶ月 |
| 6ヶ月 | 過去6ヶ月 |
| 1年 | 過去12ヶ月（**デフォルト**） |
| 全期間 | すべての履歴 |

---

## 記録カードの詳細

各記録はカードとして表示され、以下の情報を含みます：

- **アイコン＋種類ラベル** — カテゴリ（メンバーシップ 👤、チェックイン 🔑、宿泊予約 🏨、ロッカー予約 🔒、置き配ロッカー 📦）
- **金額** — 施設の通貨で表示（例：¥1,000、返金は −¥500）。**無料チェックインは金額を表示しません**。「無料」バッジが料金なしを示します。
- **日付** — 無料チェックインはチェックアウト日時、お支払いは決済日時
- **ステータスバッジ**（上記テーブル参照）
- **説明** — 設定名や補足情報（ある場合）
- **領収書を表示** リンク — Stripe の領収書 PDF を新しいタブで開く。**支払済**の記録のみに表示され、無料・処理中・失敗の記録には表示されません。

---

## もっと見る（ページネーション）

履歴は1回につき20件を新しい順で読み込みます。過去の記録を見るには、リストの一番下までスクロールして**もっと見る**をタップしてください。

---

## ログインが必要です

履歴タブの表示にはログインが必要です。未ログインの場合はログイン画面が表示されます。メールアドレスを入力するとワンタイムパスコード（OTP）が届き、ログインできます。

---

## よくある質問

### Q: 最近のチェックインが「無料」と表示されます。正しいですか？
A: はい。メンバーシップの利用枠でカバーされたチェックインは料金が発生しないため、「無料」バッジが付き金額は表示されません。これにより、Key Hub の「過去の利用」と履歴の表示が一致します。

### Q: 従量課金のチェックインがまだ表示されません
A: お支払いが Stripe で確定した後に表示されます。発生済みでもまだ請求が確定していない従量課金・超過分は、確定するまで表示されません。これは現在の仕様です。履歴は確定した活動を記録するものです。

### Q: 「処理中」の課金があります。問題ですか？
A: 「処理中」はお支払いが決済事業者で処理中であることを示します。通常は数分〜数営業日で確定します。1週間以上処理中のままの場合は施設スタッフにご連絡ください。

### Q: 「領収書を表示」リンクが表示されません
A: 領収書リンクはお支払い確定後に Stripe が生成します。無料・処理中・失敗の記録では利用できません。

### Q: 課金に異議があります
A: 履歴に表示されている日付と金額を添えて、施設スタッフへ直接ご連絡ください。

---

## 関連ページ

- [Goポータル / Key Hub](go-portal.md) - Goポータルと Key Hub の概要
- [メンバーシッププラン](membership-plans.md) - メンバーシップのサブスクリプションと利用枠の仕組み

最終更新: 2026-06-22
