Alerts Outcome Updated Event

wbhk

alerts.updated

The Alert Outcome Updated webhook (alerts.updated) is available exclusively for Chargeflow Alerts customers. It notifies your system whenever the outcome of handling a pre-chargeback alert changes.

The outcome field describes the result of Chargeflow's attempt to process the alert — whether a linked transaction was found and if a refund was successfully applied. This webhook ensures your systems remain up to date as alerts move through their lifecycle.

Possible outcome values: acknowledged, refunded, previously_refunded, transaction_not_found, pending, duplicate, decline, error.

The webhook payload includes the full alert object as available at the time of the outcome update. If further details are required, you can call the Get Alert by ID endpoint to retrieve the latest alert record.

Payload

An Alert is a notification of a potential dispute, enabling merchants to proactively address it before it escalates to a chargeback. Merchants can choose to prevent the chargeback by refunding the transaction or await escalation, which may result in a chargeback.

string

The unique Chargeflow object identifier of the alert.

account_id

string

The unique Chargeflow account identifier to which the alert belongs.

ext_account_id

string | null

Platforms only - The unique account identifier appears on the platform. Returns null if the platform did not update this attribute when creating a merchant entity.

transaction

string | null

The unique Chargeflow identifier of the transaction to which the alert is linked. Null until linking succeeds.

created_at

date-time

The time at which the alert was created in ISO 8601 format.

network_transaction

object

Network-transaction details (card brand, ARN, auth code, etc.) for the transaction associated with the alert.

status_date

date-time | null

The time at which the alert status was updated in ISO 8601 format. Null until the first status transition.

status

string

The status of the alert. Status can be one of the following: alerted, pending, refund_initiated, prevented.

statement_descriptor

string

The descriptor of the merchant to which the alert belongs.

amount

number | null

≥ 0

Alert total amount. Null if not yet known at ingestion.

currency

string | null

Three-letter ISO 4217 currency code in uppercase. Null if not yet known.

outcome

string

enum

The current outcome of the alert. May be one of: acknowledged, refunded, previously_refunded, transaction_not_found, pending, duplicate, decline, error.

type

string

The type of the alert. Type can be one of the following: fraud_warning, ethoca, cdrn, rdr, other.

reason

string

The reason for the alert. Reason can be one of the following: fraud, processing, authorization, service.

Response

200