イベントカタログ
上記 9 つのトグルはすべて受信者ごとです ——
notifySubscriptionPlanChanged と notifyChargeback も含みます。同じストアの 2 人が別々のイベントを購読でき、update-recipient は 9 キーのいずれも受け付けます。配信先アドレスは受信者リストに従います:マーチャント通知は設定された受信者へ送られ(リストが空の場合はストアオーナーのアカウントメールにフォールバック)、supportEmail へは送られません。制限
各ストアの受信者は最大 5 件です。上限を超えると 400 を返します。下限はありません —— ただし空のリストは無音を意味しません:ストアオーナーのアカウントメールにフォールバックします(次節参照)。消費者向けのトランザクションメール(注文レシート、サブスクリプション確認)は別系統であり、影響を受けません。フォールバック受信者
明示的な受信者が 1 件もない間、リストにはisPrimary: true の合成エントリがちょうど 1 件含まれます:アドレスはストアオーナーのアカウントメール、トグルはストアレベルの notify* 設定、createdAt はストアの作成日時です。その id は OWNER_<storeId> 形式の安定したセンチネル値です。
これは保存された行ではありません。その id に対する remove-recipient は 404 を返します —— アカウントメールはフォールバックであり削除できません。置き換えるには実在の受信者を追加してください。その id に対する update-recipient は代わりにその場で実体化します:アカウントメールが実在の受信者として書き込まれ、パッチがその上に適用され、レスポンスは実際の UUID を返します。
最初の明示的な受信者を追加すると、フォールバックエントリは消えます。これは意図した可視の挙動です。
環境
受信者は環境で分かれません。リクエストは従来どおりX-Environment を付けて構いませんが、受信者の読み書きのフィルタや加工には使われません —— 同じストアは test でも prod でも同じリストを返します。
受信者の一覧取得
list-recipients エンドポイントはありません —— 受信者リストの取得は GraphQL のトップレベルクエリ storeNotificationRecipients を使います。明示的な受信者が未設定の場合、このクエリはフォールバックエントリも返します:
エンドポイント
受信者を追加
マーチャント通知を受け取るアドレスを追加します。
受信者を更新
受信者が購読するイベントを変更します。
受信者を削除
リストから受信者を削除します。