Webhooksイベントタイプ

Verification.Revoke

以前に合格した1つ以上の認証が取り消された場合に発行されます。例えば、不正行為やプロバイダー報告のエラーが原因です。data.verifications配列には常に少なくとも1つの項目が含まれ、一括取り消し処理の場合は複数の項目が含まれることがあります。

このイベントを受信した場合、参照された認証はもはや有効ではないものとして扱い、適切な措置を講じる必要があります(例:影響を受けたユーザーの認証を再トリガーする)。

フィールド

フィールドタイプ必須説明
eventTypestringはい常に "Verification.Revoke"
dataobjectはい取り消しデータ
data.verificationsarrayはい取り消された認証のリスト(最小1項目)
data.verifications[].idstring (UUID)はい取り消される認証ID
data.verifications[].reasonstringはい取り消しの理由: fraudulent-activity-detected または provider-reported-error

例

{
  "eventType": "Verification.Revoke",
  "data": {
    "verifications": [
      {
        "id": "4e57301e-a4d1-498f-ac3f-f3d4de19abf6",
        "reason": "fraudulent-activity-detected"
      }
    ]
  }
}

On this page