設定

メニュー：予約管理＞ 設定

画面の概要

プラグイン全体の設定を行う画面で、主にオンライン決済（Stripe）を構成します。決済機能のON/OFF、決済サービスの選択、仮押さえ時間、Stripeの各種キーをここで設定します。

項目	意味・役割
決済機能を利用する	オンライン決済を有効にします。OFFの場合、予約フォームに決済の選択肢は表示されず、すべて現地払いになります。
決済サービス	利用する決済サービス。現在は Stripe に対応（他サービスは今後追加可）。
決済待ちの保持時間（分）	カード払いを選んだお客様が決済を完了するまで枠を仮押さえする時間（10〜120分）。Stripe側の有効期限と連動します。

項目	意味・役割
シークレットキー必須	Stripeダッシュボード「開発者＞APIキー」の `sk_` で始まるキー。テスト時は `sk_test_` を使用します。サーバーからStripeを操作するために使います。
公開可能キー	`pk_` で始まるキー。リダイレクト方式では未使用ですが、今後の拡張に備えて保存できます。
Webhook署名シークレット	Stripeダッシュボード「開発者＞Webhook」で受信用URLを登録すると発行される `whsec_` で始まる署名シークレット。StripeからのWebhook通知が本物かを検証するために使います（下記参照）。

Webhook署名シークレットは、シークレットキー・公開可能キーとは別物です。次の手順で取得します。

Stripeダッシュボードで「開発者＞ Webhook」を開く
「エンドポイントを追加」をクリック
エンドポイントURLに、このサイトのWebhook受信URLを入力：
https://<あなたのサイトのドメイン>/reserve/payment/webhook
リッスンするイベントを選択：
checkout.session.completed / checkout.session.expired / customer.subscription.deleted / invoice.payment_failed
作成後に表示される「署名シークレット」（whsec_〜）をコピー
この設定画面の「Webhook署名シークレット」欄に貼り付けて保存

テスト環境では、キー（sk_test 等）もWebフックもテストモードで登録します（テスト／本番でキーが変わります）。
Webhookを設定しなくても、決済成功時のリダイレクトで予約は確定します。ただし戻りの取りこぼし救済・期限切れ・サブスク終了の反映のため、登録を推奨します。
仮押さえのクリーンアップ（cron推奨）：カード払いで決済が完了しなかった枠（決済待ち仮押さえ）は、期限切れWebhookでも解放されますが、Webhook未設定の環境でも滞留しないよう、定期実行(cron)で仮押さえ掃除コマンドを回すことを推奨します。5分ごとの実行例：
*/5 * * * * cd /var/www/html && bin/cake hat_reserve_payment_cleanup
（/var/www/html はサイトのルートに読み替えてください。）これにより、決済されずに放置された枠が自動で解放され、他のお客様が予約できるようになります。
予約対象ごとにカード決済を使うかは、各予約対象の「オンライン決済を利用する」で切り替えます（この画面で決済機能が有効な場合のみ働きます）。
決済の詳しい仕様は開発ドキュメント（docs/payment.md）を参照してください。