kobitoDevelopment/.md

Last active June 24, 2026 09:41

Star (0) You must be signed in to star a gist
Fork (0) You must be signed in to fork a gist

Select an option

Learn more about clone URLs
Clone this repository at <script src="https://gist.github.com/kobitoDevelopment/3cfaab9edab0e0bf8a8b464e5572432d.js"></script>
Save kobitoDevelopment/3cfaab9edab0e0bf8a8b464e5572432d to your computer and use it in GitHub Desktop.

Download ZIP

Raw

.md

サブスク決済設計チェックリスト

契約開始後に請求を繰り返す機能の設計・実装・レビューで使用する。各項目に実装内容、保存先、判定条件またはテスト結果を記入する。対象外の項目には、対象外と判断した理由を記入する。

0. 使い方

各項目へ次の優先度を付ける。

必須: 初回リリースまでに決定・実装・テストする
条件付き: 採用するプラン、決済手段、運用に該当する場合だけ対応する
将来対応: 初回リリースの対象外とし、未対応時の制約と代替運用を記録する

この文書は抜け漏れ防止用のチェックリストとして使用し、実装開始前に少なくとも次の成果物を別表または「19. 実装記録」へ確定する。

外部契約状態、アプリ内状態、利用可否、画面操作の状態変換表
契約状態と請求状態を保存するDBスキーマ
処理する非同期通知イベントと処理内容の一覧
契約開始、変更、解約ごとの冪等性方式
初回リリースで対応しない項目と代替運用

1. 契約条件

販売主体:
決済明細・請求書・領収書の発行主体:
契約主体を識別する ID:
顧客を識別する外部 ID:
契約を識別する外部 ID:
商品またはプラン:
金額:
通貨:
対応する販売国・地域:
対応する通貨:
使用する決済手段:
税額の計算主体:
金額の最小単位:
端数処理:
請求周期:
請求基準日時のタイムゾーン:
無料期間:
無料期間開始時の支払方法登録要否:
日割り計算の有無と計算主体:
割引の種類と有効期間:
請求を自動回収するか利用者へ請求書を送付するか:
支払い失敗時の再試行回数と期間:
支払い失敗後の利用猶予期間:
カード利用明細へ表示する名称:
1 契約主体に許可する同時契約数:
契約状態を確定するシステム:
アプリ DB に保存する契約状態:
契約条件と解約条件を表示する画面:
契約条件への同意記録:

2. 状態定義

採用する状態ごとに、利用可否と画面上の操作を記入する。

3. 契約開始

4. 定期請求

5. 支払方法

支払方法を登録、変更、削除できるユーザー条件をサーバー側で検証する
定期請求に使用する既定の支払方法を識別できる値を保存する
契約中に最後の有効な支払方法を削除できるか記録する
支払方法変更と請求再試行の実行順序を記録する
支払方法の表示にカード番号全桁またはセキュリティコードを使用しない
支払方法変更用URLをログイン中の契約主体に対してサーバー側で発行する

6. プラン変更

7. 解約

8. 再契約

再契約時に既存の外部顧客 ID を再利用する
再契約で新しい外部契約 ID が発行された時点を保存する
DBに保存された現在の契約 ID と通知対象の契約 ID を照合する
終了済み契約の通知で現在の有効契約を上書きしない
DBに保存された現在の顧客 ID と通知対象の顧客 ID を照合する
過去の顧客削除通知で現在の顧客 ID を削除しない
未払い契約が残る場合に表示する操作を状態定義へ記録する
未払い契約が残る場合に新規契約を許可するか記録する
複数の契約が存在する場合、利用権判定で参照する契約の選択条件を記録する

9. 非同期通知

10. エラー分類と再試行

11. 利用者へのエラー表示

初回決済失敗時に決済再開または支払い方法変更の操作を表示する
支払い再試行中に支払い方法変更の操作を表示する
自動回収終了後に新規契約ボタンと既存契約管理ボタンを同時表示しない
契約操作の結果が未確定の場合に「未契約」と表示しない
通信失敗時に契約開始、変更、解約の成功を断定する文言を表示しない
利用者向け表示に内部例外、APIキー、外部顧客 ID、DB識別子を含めない
問い合わせに使用する契約主体 ID または受付 ID をエラー画面へ表示する

12. 保存データと権限

13. 売上・入金・会計

売上計上日時を記録する
請求額、返金額、手数料、入金額を区別して保存または取得できる
決済事業者の請求明細とアプリの契約・請求データを照合する処理を用意する
決済事業者の入金明細と銀行入金額を照合する処理を用意する
不一致件数と不一致金額を監視する
請求書、領収書、適格請求書の発行主体と保存先を記録する
返金、異議申立て、手数料を会計データへ反映する処理を記録する

14. 不正利用と本人認証

初回決済で本人認証を要求する条件を記録する
定期請求で追加認証が必要になった場合の通知先と有効期限を記録する
不正利用判定で拒否された請求を支払い成功として保存しない
異議申立て発生時の利用可否を状態定義へ記録する
異議申立ての受付日時、回答期限、対象金額を保存する

15. DB同期

16. セキュリティ

17. テスト

単体テスト

結合テスト

18. 監視と運用手順

19. 実装記録

販売主体:
対応する国・地域、通貨、決済手段:
PCI DSSの対象範囲:
契約状態と請求状態の保存先:
採用した外部状態:
採用したアプリ内状態:
有料機能を提供する状態:
有料機能を停止する状態:
1 契約主体あたりの同時契約数:
契約開始操作の識別キー:
冪等性キーの保存先、一意制約、保持期間:
処理済みイベントの保存先:
非同期通知の処理方式と応答時間上限:
後続処理の再試行と処理不能通知の保存先:
処理するイベントと成功・失敗の確定条件:
使用するAPIバージョン:
非同期通知のテストデータ保存先:
現在契約の選択条件:
再契約時の顧客 ID:
DB再同期手順:
監視先:
再試行対象:
再試行回数と待機時間:
利用者向けエラーコード:
金額の最小単位と端数処理:
売上・入金照合の実行頻度:
データ保持期間:
未実装要件と理由:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment