# Prevention alert received

Webhook sent when a prevention alert is received for a payment.

Endpoint: POST PreventionAlertReceived
Version: 2.0.0
Security: signatureAuth

## Request fields (application/json):

  - `event_id` (string, required)
    Unique event identifier.
    Example: "2c871666-c3a4-4a4e-89a8-fc8956e95731"

  - `event_type` (string, required)
    Event type.
    Enum: "PREVENTION_ALERT_RECEIVED"

  - `occurred_at` (string, required)
    Date and time when the event occurred.
    Example: "2026-06-22T10:05:00.000000Z"

  - `data` (object, required)
    Event payload containing the reported prevention alert.

  - `data.prevention_alert` (object, required)
    Represents a prevention alert reported by a provider for a payment.

  - `data.prevention_alert.id` (string, required)
    Unique prevention alert identifier.
    Example: "pral_01KMG2ABYPF6XS5DMJQ817C429"

  - `data.prevention_alert.merchant_order_id` (string, required)
    Merchant order identifier of the payment associated with the prevention alert.
    Example: "019ef938-06fb-769f-90a9-e61fafcc75a4"

  - `data.prevention_alert.provider` (string, required)
    Provider that reported the prevention alert.
    Enum: "ETHOCA", "VERIFI", "SOLIDGATE"

  - `data.prevention_alert.alert_type` (string, required)
    Prevention alert type.
    Enum: "INIT_REFUND", "INQUIRY", "RESOLVED", "PREVENTED"

  - `data.prevention_alert.outcome` (string, required)
    Outcome of handling the prevention alert.
    Enum: "REVERSED", "PREVIOUSLY_REVERSED", "DUPLICATE", "DECLINE", "ERROR", "REVERSE_ERROR", "NOT_FOUND", "ACKNOWLEDGED", "PENDING"

  - `data.prevention_alert.amount` (integer, required)
    Prevention alert amount in the minor currency unit.
    Example: 4990

  - `data.prevention_alert.currency` (string, required)
    Three-letter ISO-4217 currency code.
    Example: "USD"

  - `data.prevention_alert.reported_at` (string, required)
    Date and time when the provider reported the alert.
    Example: "2026-06-22T09:00:00.000000Z"

  - `data.prevention_alert.created_at` (string, required)
    Date and time when the prevention alert was created.
    Example: "2026-06-22T09:05:00.000000Z"

  - `data.prevention_alert.updated_at` (string, required)
    Date and time when the prevention alert was updated.
    Example: "2026-06-22T09:05:00.000000Z"