Skip to main content
マーチャント通知 —— 新規注文、新規サブスクリプション、更新、キャンセル、支払い遅延 —— はストアに設定された受信者へ配信されます。各受信者は独自のアドレスと独自のイベント別購読トグルを持つため、同じストアの 2 人が別々のイベントを購読できます。受信者が 1 件も設定されていない場合、通知はストアオーナーのアカウントメールにフォールバックします。

イベントカタログ

上記 9 つのトグルはすべて受信者ごとです —— notifySubscriptionPlanChangednotifyChargeback も含みます。同じストアの 2 人が別々のイベントを購読でき、update-recipient は 9 キーのいずれも受け付けます。配信先アドレスは受信者リストに従います:マーチャント通知は設定された受信者へ送られ(リストが空の場合はストアオーナーのアカウントメールにフォールバック)、supportEmail へは送られません。

制限

各ストアの受信者は最大 5 件です。上限を超えると 400 を返します。下限はありません —— ただし空のリストは無音を意味しません:ストアオーナーのアカウントメールにフォールバックします(次節参照)。消費者向けのトランザクションメール(注文レシート、サブスクリプション確認)は別系統であり、影響を受けません。

フォールバック受信者

明示的な受信者が 1 件もない間、リストには isPrimary: true の合成エントリがちょうど 1 件含まれます:アドレスはストアオーナーのアカウントメール、トグルはストアレベルの notify* 設定、createdAt はストアの作成日時です。その idOWNER_<storeId> 形式の安定したセンチネル値です。 これは保存された行ではありません。その id に対する remove-recipient は 404 を返します —— アカウントメールはフォールバックであり削除できません。置き換えるには実在の受信者を追加してください。その id に対する update-recipient は代わりにその場で実体化します:アカウントメールが実在の受信者として書き込まれ、パッチがその上に適用され、レスポンスは実際の UUID を返します。 最初の明示的な受信者を追加すると、フォールバックエントリは消えます。これは意図した可視の挙動です。

環境

受信者は環境で分かれません。リクエストは従来どおり X-Environment を付けて構いませんが、受信者の読み書きのフィルタや加工には使われません —— 同じストアは test でも prod でも同じリストを返します。

受信者の一覧取得

list-recipients エンドポイントはありません —— 受信者リストの取得は GraphQL のトップレベルクエリ storeNotificationRecipients を使います。明示的な受信者が未設定の場合、このクエリはフォールバックエントリも返します:

エンドポイント

受信者を追加

マーチャント通知を受け取るアドレスを追加します。

受信者を更新

受信者が購読するイベントを変更します。

受信者を削除

リストから受信者を削除します。