# Received prevention alert

<a href="https://docs.solidgate.com/payments/integrate/webhooks/" target="_blank">Webhooks</a> enable to preemptively identify and resolve potential issues, thereby preventing the generation of alert, specifically for the <a href="https://docs.solidgate.com/payments/alternative-payments/apms-overview/paypal/" target="_blank">PayPal</a> method.
<blockquote>
<p>Duplicate webhook events can occur. Implement <a href="https://docs.solidgate.com/payments/integrate/webhooks/#event-handling" target="_blank">idempotency</a> on your end to avoid processing the same event twice.</p>
</blockquote>

Endpoint: POST APMPreventAlert
Version: 1.0.0
Security: MerchantID

## Header parameters:

  - `merchant` (string, required)

  - `signature` (string, required)

  - `solidgate-event-id` (string, required)
    Unique event identifier.

  - `solidgate-event-created-at` (string, required)
    Event creation time in <a href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601</a> format with milliseconds.

  - `solidgate-event-type` (string, required)
    Event type, indicating the specific event that occurred.

## Request fields (application/json):

  - `order` (object)
    Details of an order, including identifiers, timestamps, amounts, status, and customer data.

  - `order.id` (string)
    Unique order identifier, which can be used to find the payment.
For the first payment, the identifier is defined by the merchant.For recurring subscription-based payments, it is generated by the Solidgate subscription service.

  - `order.created_at` (string)
    Datetime when the order was created.

  - `order.amount` (integer)
    Order amount in the smallest currency unit (cents for euros).
For instance, 1020 means 10 EUR and 20 cents.

  - `order.currency` (string)
    Three-letter ISO-4217 currency code.

  - `order.status` (string)
    Status of the requested order.
    Enum: "created", "processing", "settle_pending", "approved", "declined", "refunded"

  - `alert` (object)
    Details about chargeback alerts, including identifiers, amounts, currency, provider data, alert types, and outcomes.

  - `alert.id` (string)
    Unique identifier assigned to each alert.

  - `alert.amount` (integer)
    Amount specified in the alert.

  - `alert.currency` (string)
    Three-letter ISO-4217 currency code.

  - `alert.provider_name` (string)
    Name of the alert provider.
    Enum: "ethoca", "verifi"

  - `alert.alert_date` (string)
    Datetime when the alert was raised on the provider's side.

  - `alert.created_at` (string)
    Datetime when the alert was created in the system.

  - `alert.updated_at` (string)
    Datetime when the alert was updated in the system.

  - `alert.alert_type` (string)
    Type of alert.
Each alert type denotes a specific event or action in the chargeback flow.
    Enum: "inquiry", "resolved"

  - `alert.outcome` (string)
    Specific response statuses for webhook alerts.
Upon receiving a webhook alert, the primary task is to promptly provide a valid response using one of the specified outcomes. Only the initial response to the alert is accepted, with the exception when the initial status was set to pending. Once a response is submitted to the provider, subsequent modifications are not permitted.
    Enum: "reversed", "previously-reversed", "duplicate", "decline", "error", "reverse-error", "not-found", "acknowledged", "pending", "shipped"