本エンドポイントは Webhook 設定を管理しません。リクエストボディに
webhookSettings フィールドが含まれている場合、そのフィールドは黙って無視され、レスポンスのトップレベルに warnings 配列が付加されます。他のフィールドは通常どおり更新され、200 が返されます。Webhook の設定は add-webhook、update-webhook、remove-webhook を使用し、一覧取得は GraphQL Store.storeWebhooks を利用してください。リクエストボディ
通知設定
書き込み権限により 2 グループに分かれます: マーチャント書き込み可能(✅ このエンドポイントで受け付け):
プラットフォーム管理(🔒 マーチャント API では読み取り専用;PANCAKE プラットフォームが管理):
notificationSettings ペイロードにプラットフォーム管理フィールド(上表の読み取り専用の email*、またはレガシーの notifyPayoutCompleted / notifyPayoutFailed — 出金結果メールは常に配信され、トグルはありません)が含まれる場合、サーバーは静かに破棄し、200 レスポンスの warnings[] に破棄されたキーを返します。emailUpcomingCharge と emailTrialEnding はこれに含まれず、いずれもそのまま受け付けて反映され、レスポンスに warnings は付きません。その他の customer メールの toggle 変更は PANCAKE プラットフォームサポートまでご連絡ください。チェックアウト設定
チェックアウトテーマ設定(
light と dark の両方に適用):
部分更新セマンティクス
2 つの settings オブジェクトはどちらも部分更新をサポートしています。各サブフィールドには 3 つの値セマンティクスがあります:
オブジェクト全体を
null に設定すると(例:"notificationSettings": null)、その設定グループのすべてのフィールドがクリアされます。
"notificationSettings": null がクリアする範囲は、本エンドポイントの書き込み権限と一致します:すべての notify* と emailUpcomingCharge、emailTrialEnding です(いずれもクリア後は既定値の true として読み出されます)。プラットフォーム管理の残りの email* は影響を受けません —— マーチャントはそれらを書き込むことも、クリアによってリセットすることもできません。ストアの通知受信者リストも同様に影響を受けず、受信者は store-notification-recipient の 3 つのエンドポイントでのみ管理されます。
リクエスト例
成功レスポンス (200)
レスポンスフィールド
ストアの作成レスポンスフィールドと同じです。 認証フロー管理(🔒 このエンドポイントでは読み取り専用;レスポンスで返されるのみ):supportEmail と website はこのエンドポイントでは設定できません。マーチャントがサポートメール認証または製品ドメイン認証を完了した時点で、本番が有効なストア(prodEnabled: true)に対して各認証フローが自動的に書き込みます。これらのフィールドを含めてリクエストしても 200 が返り、ストアは変更されず、warnings エントリも付きません —— フィールドは静かに破棄されます。webhookSettings 互換性警告
リクエストボディにwebhookSettings フィールドが含まれている場合、そのフィールドは黙って無視され、レスポンスのトップレベルに warnings 配列が含まれます。data.store オブジェクトには影響しません。
エラー
リトライポリシー:4xx は一切リトライしない — リクエストを修正してから再送信。5xx は指数バックオフでリトライ(5s 開始、最大 3 回)。