soi. digital works
PAYMENT + CARD ON FILE / SANDBOX
初回決済・カード保存・月額契約テスト
Squareに顧客情報とカードを登録する仕組みを確認します。
今回のテスト金額（税込）
ホームページ制作費¥3,300
月額利用料（初月）¥1,078
合計¥4,378
前回の成功取引とは別の、新しいSandbox決済が1件作成されます。カード保存後も、自動請求は開始されません。
① テスト用のお客様情報
Square Sandbox内にテスト用顧客を作成します。毎回新しいテスト顧客が登録されます。
② Square テストカード
Visa番号：
有効期限：未来の年月（例 12/30）
CVV：
ZIP Codeを求められたら：
4111 1111 1111 1111有効期限：未来の年月（例 12/30）
CVV：
111ZIP Codeを求められたら：
12345Squareカード入力画面を準備しています…
③ 月額自動決済のテスト管理（Sandbox）
管理キーはブラウザ内で入力して使用するだけで、画面上に保存しません。SquareのAccess Tokenとは別の任意の秘密文字列です。
A. Square月額プランを作成
最初の1回だけ実行。繰り返すと同名のプランが増えるので注意してください。
B. 保存済みカードで契約を作成
前回のカード保存テスト画面で表示された顧客IDとカードIDを使用してください。管理用のテストであり、お客様向け申込画面ではありません。
既存のSandbox契約からIDを自動取得（確認専用）
以前の定期契約IDだけで、顧客・保存カード・月額プランのIDを取得して下の欄に入力します。確認ボタンでは決済や新規契約は発生しません。
Squareから読み取り専用で取得します。元の契約を再利用して請求することはありません。
契約開始日は「未来の月の1日」限定です（11月8日などは選択できません）。請求基準日5日はSquare側で未確認のため、Cの「契約確認」で既存契約を読み取り専用で再取得してください。確認操作では新しい契約や決済は発生しません。
C. 契約確認・解約予約（請求日確認は読み取り専用）
契約・解約予約の照合（読み取り専用）
上のSubscription IDと管理キーを入力して、Squareの契約・CANCEL予約とCloudflare KVの記録を比較します。SquareもKVも変更しません。
確認する契約IDを入力して照合してください。
開始前キャンセル（PENDING契約のみ・Sandbox）
先に上の「Subscription ID」を入力し、「対象か確認」を押してください。開始前キャンセルの実行は別操作です。
解約申請期限の自動判定（Sandbox・確認用）
土日・日本の祝日・12月30日〜1月4日を休業日として、日本時間の現在日時から解約月を試算します。SquareとKVは変更しません。
ボタンを押すと受付期限と解約月を表示します。
D. 解約予定月を指定（新機能・Sandbox）
新機能：申請日時から解約月を自動計算し、KVへ保存します。Square側の契約は変更しません。既存の予定がある場合は登録できません。
以下は従来の手動月指定テストです。
この機能にはCloudflare KVバインディング SOI_CANCEL_KV が必要です。Squareへの自動解約はまだ実装していません。
最初にCloudflare Secretsへ SOI_TEST_ADMIN_KEY（20文字以上の任意の値）を設定し、再デプロイしてください。