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

string

required

The unique identifier of the alert

account_id

string

required

The account identifier associated with the alert

ext_account_id

string | null

required

The external account identifier

transaction

null

The transaction object associated with the alert

created_at

string

required

The date when the alert was created

network_transaction

object

required

Network transaction details

status_date

string

required

The date when the status was last updated

status

string

enum

required

The current status of the alert

Allowed:

statement_descriptor

string

required

The statement descriptor for the transaction

amount

number

required

The amount associated with the alert

currency

string

required

The currency of the alert amount

outcome

string

enum

required

The outcome of the alert

Allowed:

type

string

enum

required

The type of alert

Allowed:

reason

string

enum

required

The reason for the alert

Allowed:

Response

200