Skip to main content
既存ストアの名前、ステータス、または設定を更新します。リクエストボディに含まれたフィールドのみが更新され、省略されたフィールドは変更されません。
認証: API Key(owner または admin ロールが必要)
本エンドポイントは Webhook 設定を管理しません。リクエストボディに webhookSettings フィールドが含まれている場合、そのフィールドは黙って無視され、レスポンスのトップレベルに warnings 配列が付加されます。他のフィールドは通常どおり更新され、200 が返されます。Webhook の設定は add-webhookupdate-webhookremove-webhook を使用し、一覧取得は GraphQL Store.storeWebhooks を利用してください。

リクエストボディ

通知設定

書き込み権限により 2 グループに分かれます: マーチャント書き込み可能(✅ このエンドポイントで受け付け): プラットフォーム管理(🔒 マーチャント API では読み取り専用;PANCAKE プラットフォームが管理):
notificationSettings ペイロードにプラットフォーム管理フィールド(上表の読み取り専用の email*、またはレガシーの notifyPayoutCompleted / notifyPayoutFailed — 出金結果メールは常に配信され、トグルはありません)が含まれる場合、サーバーは静かに破棄し、200 レスポンスの warnings[] に破棄されたキーを返します。emailUpcomingChargeemailTrialEnding はこれに含まれず、いずれもそのまま受け付けて反映され、レスポンスに warnings は付きません。その他の customer メールの toggle 変更は PANCAKE プラットフォームサポートまでご連絡ください。

チェックアウト設定

チェックアウトテーマ設定lightdark の両方に適用):

部分更新セマンティクス

2 つの settings オブジェクトはどちらも部分更新をサポートしています。各サブフィールドには 3 つの値セマンティクスがあります: オブジェクト全体を null に設定すると(例:"notificationSettings": null)、その設定グループのすべてのフィールドがクリアされます。 "notificationSettings": null がクリアする範囲は、本エンドポイントの書き込み権限と一致します:すべての notify*emailUpcomingChargeemailTrialEnding です(いずれもクリア後は既定値の true として読み出されます)。プラットフォーム管理の残りの email*影響を受けません —— マーチャントはそれらを書き込むことも、クリアによってリセットすることもできません。ストアの通知受信者リストも同様に影響を受けず、受信者は store-notification-recipient の 3 つのエンドポイントでのみ管理されます。
クリアすると、オフにしていた購入者向けリマインダーが再び有効になります。emailUpcomingChargeemailTrialEndingfalse にしていたストアでも、"notificationSettings": null を 1 回送ると true として読み出され、そのストアの購入者にリマインダーが再び届きます。部分更新を使ってください —— 実際に変更したいキーだけを送ります:

リクエスト例

成功レスポンス (200)

レスポンスフィールド

ストアの作成レスポンスフィールドと同じです。 認証フロー管理(🔒 このエンドポイントでは読み取り専用;レスポンスで返されるのみ):
supportEmailwebsite はこのエンドポイントでは設定できません。マーチャントがサポートメール認証または製品ドメイン認証を完了した時点で、本番が有効なストア(prodEnabled: true)に対して各認証フローが自動的に書き込みます。これらのフィールドを含めてリクエストしても 200 が返り、ストアは変更されず、warnings エントリも付きません —— フィールドは静かに破棄されます。

webhookSettings 互換性警告

リクエストボディに webhookSettings フィールドが含まれている場合、そのフィールドは黙って無視され、レスポンスのトップレベルに warnings 配列が含まれます。data.store オブジェクトには影響しません。

エラー

リトライポリシー:4xx は一切リトライしない — リクエストを修正してから再送信。5xx は指数バックオフでリトライ(5s 開始、最大 3 回)。