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[] に破棄されたキーを返します。customer メールの toggle 変更は PANCAKE プラットフォームサポートまでご連絡ください。

チェックアウト設定

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

部分更新セマンティクス

2 つの settings オブジェクトはどちらも部分更新をサポートしています。各サブフィールドには 3 つの値セマンティクスがあります: オブジェクト全体を null に設定すると(例:"notificationSettings": null)、その設定グループのすべてのフィールドがクリアされます。

リクエスト例

成功レスポンス (200)

レスポンスフィールド

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

webhookSettings 互換性警告

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

エラー

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