billing-behaviors

課金動作のルール

API の正確な形状と課金動作は分けて扱います。

• メソッド、フィールド、エラー、イベント、バージョンを明示する前に、インストール済み SDK の docs/manifest.json、エントリーポイント、生成されたリファレンス、関連する Platform ドキュメントを確認します。
• 生成された型では表現できない動作ポリシーについては、このスキル内のリファレンスを使用します。
• 現行のプロダクトコードを参照できる場合は、そのサービスパスと対象を絞ったテストを、このスキルよりも強い根拠として扱います。

Node プロジェクトでは、連携の変更前に commet doctor --output agent を実行し、ドキュメント、互換性、API バージョン、プロジェクトコンテキストのチェックで失敗した項目を解決します。

関連する動作リファレンスを選ぶ

• subscriptions-and-plan-changes.md — ライフサイクル、アクセス、初回利用資格、変更、キャンセル、再開。
• billing-and-dunning.md — 課金期間、請求書の構成、割引、再試行のスケジュール。
• usage-balances-and-seats.md — 消費モデル、リセット、パック、チャージ、クォータ、シートの追加課金。
• catalog-pricing-and-offers.md — プラン、通貨別価格、Markets、選択可能なバリアント、Offers、プロモーションコード、アドオン、アーカイブ動作。

一般的な公平性のスローガンから動作を推測してはいけません。スケジュール設定、課金、割引、再試行、リセットは、各操作で明示されています。更新のタイミングについては、現在の検出条件を確認してください。日付のみのダッシュボード表示、旧式の課金日カラム、cron スケジュールから、サブスクリプションの更新時期を推測してはいけません。

副作用を抑制する

推論、コード編集、ローカルテストにリモートコンテキストは不要です。課金リソース、請求書、サブスクリプション、残高、使用量、クレジット、再試行を作成または変更する前に、対象の組織と sandbox または live モードを明示します。Node プロジェクトでは、PROJECT_CONTEXT_VALID の doctor チェックに合格していることを確認してください。そうでない場合は、プロジェクトまたはユーザーのコンテキストを明示的に指定する必要があります。ユーザーの依頼で明示的に許可されていない限り、live 環境で課金に影響する操作を実行してはいけません。