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 alert ID and 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.

The webhook payload includes the alert ID, the matched transaction ID, and basic metadata about the alert. For full alert details — which may evolve over time (e.g., outcome) — you can call the Get Alert by ID endpoint.

Payload

string

required

The unique identifier of the alert

account_id

string

required

The account identifier associated with the alert

ext_account_id

string

The external account identifier from the platform

transaction_id

string

The transaction identifier associated with the alert

created_at

string

The date when the alert was created

network_transaction

object

Network transaction details associated with the alert

status_date

string

The date when the status was last updated

status

string

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

statement_descriptor

string

The statement descriptor for the transaction.

amount

number

The amount associated with the alert

currency

string

The currency of the alert amount

outcome

string

The outcome of the alert. Outcome can be one of the following: duplicate, not_found, prevented, pending, chargebacked, previously_refunded, error.

type

string

The type of 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.

transactionId

string

The id of the transaction you want to update alert with

Response

200

Payload

Choose an example