Alerts Created Event

wbhk

alerts.created

The Alert Created webhook is available exclusively for Chargeflow Alerts customers. It notifies your system in real time whenever a new pre-chargeback alert is created for your account. When a new alert is received by Chargeflow, the webhook sends an HTTP POST request to your configured endpoint containing the full alert object as available at ingestion time.

Merchants can use this webhook to:

Trigger automated workflows (e.g., refund, order cancellation, tagging) immediately when an alert is received.
Ingest alerts into internal systems for logging, monitoring, or case management.
Notify relevant teams (support, fraud, risk) without needing to poll the API.

Some fields populate later as the alert progresses (e.g., outcome, matched transaction). Subscribe to alerts.updated and alerts.transaction.linked for downstream updates, or call Get Alert by ID to fetch the latest state on demand.

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