Alert Transaction Linked Event

wbhk

alerts.transaction.linked

The Alert Transaction Linked webhook is available exclusively for Chargeflow Alerts customers. It notifies your system in real time whenever Chargeflow successfully matches a pre-chargeback alert to a transaction in your payment processor. When this occurs, the webhook sends an HTTP POST request to your configured endpoint containing the full alert object with the transaction field populated to the matched transaction id.

Merchants can use this webhook to:

Trigger workflows that depend on having transaction-level data (e.g., adding customer tags, cancelling subscriptions, etc.).
Ingest alert-transaction data into internal systems for logging, monitoring, or case management.

For richer transaction details (network transaction breakdown, customer info), call the Get Alert by ID endpoint.

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