受信者を削除 - Waffo Pancake

ストアの受信者リストからアドレスを削除します。同じアドレスは後から再度追加できます。

POST /v1/actions/store-notification-recipient/remove-recipient

認証： API Key（owner または admin ロールが必要）

リクエストボディ

フィールド	型	必須	説明
`storeId`	string	はい	ストア ID（Short ID 形式 `STO_xxx`）
`recipientId`	string	はい	保存済み受信者の UUID。UUID でない値は 400 を返します

リクエスト例

curl -X POST https://api.waffo.com/v1/actions/store-notification-recipient/remove-recipient \
  -H "Content-Type: application/json" \
  -H "X-Merchant-Id: $WAFFO_MERCHANT_ID" \
  -H "X-Signature: ..." \
  -d '{
    "storeId": "STO_2aUyqjCzEIiEcYMKj7TZtw",
    "recipientId": "11111111-2222-3333-4444-555555555555"
  }'

const response = await fetch(
  "https://api.waffo.com/v1/actions/store-notification-recipient/remove-recipient",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-Merchant-Id": process.env.WAFFO_MERCHANT_ID,
      "X-Signature": signature,
    },
    body: JSON.stringify({
      storeId: "STO_2aUyqjCzEIiEcYMKj7TZtw",
      recipientId: "11111111-2222-3333-4444-555555555555",
    }),
  },
);

const { data } = await response.json();

成功レスポンス (200)

{
  "data": {
    "recipientId": "11111111-2222-3333-4444-555555555555",
    "removed": true
  }
}

最後の 1 件を削除しても 200 を返します —— 「最低 1 件は残す」というガードはありません。その後そのストアはマーチャント通知を一切送信しません：フォールバック先のアドレスはなく、代わりのエントリが合成されることもありません。ストア作成時にシードされた行（isPrimary: true）も他の受信者と同様に削除できます —— このフラグは出自を示すだけで、特権はありません。アドレスを追加すれば配信が再開します。消費者向けのトランザクションメールは別系統であり、引き続き動作します。

レスポンスフィールド

フィールド	型	説明
`recipientId`	string	削除された受信者の UUID
`removed`	boolean	常に `true`。該当なしの場合は `removed: false` ではなく 404 を返します

エラー

リトライ方針： 4xx は決してリトライしないでください —— リクエストを修正して再送します。5xx は指数バックオフでリトライします（初回 5 秒、最大 3 回）。

ステータス	`errors[0].message`	意味	推奨対応
400	`Missing required field: recipientId`	`recipientId` が未指定	リクエストボディを修正して再送
400	`Invalid recipient id format: expected UUID, got "..."`	`recipientId` が UUID でない	add-recipient や GraphQL が返した `id` をそのまま渡す
401	`Missing merchantId in request context`	API Key 認証でマーチャントを解決できなかった	API Key のヘッダーと署名を確認
403	`Not authorized to manage notification recipients for this store`	マーチャントがそのストアの `owner` / `admin` ではない	ストアにおけるマーチャントのロールを確認
404	`Notification recipient not found`	そのストアに該当 id の受信者がない —— 追加されていない、または並行書き込みで既に削除された	リストを取得し直す
409	`Notification recipients changed concurrently, please retry`	読み取りと書き込みの間に並行書き込みがリストを変更	リストを取得し直して再試行
500	`Internal server error`	サーバー側の予期しない障害	指数バックオフでリトライ（初回 5 秒、最大 3 回）

⌘I