Early Fraud Warning

{
  "eventId": "whe_fooD944t4VUKkaDT",
  "eventType": "intent.early_fraud_warning",
  "eventTime": 1729608043615,
  "intentId": "in_fooBOwYsaK50AEfK",
  "fraudType": "made_with_stolen_card"
}

An early fraud warning is a signal raised that a charge is likely fraudulent. It is delivered before a dispute is opened, giving you an opportunity to proactively refund the payment, cancel any pending fulfilment, or reach out to the customer to reduce the risk of an incoming chargeback.

{
  "eventId": "whe_fooD944t4VUKkaDT",
  "eventType": "intent.early_fraud_warning",
  "eventTime": 1729608043615,
  "intentId": "in_fooBOwYsaK50AEfK",
  "fraudType": "made_with_stolen_card"
}

eventId

string

A unique identifier for this specific event. This ensures that each event can be tracked and processed individually.

eventType

string

Describes the type of event. In this case, it signifies that an early fraud warning has been raised against a payment intent.

eventTime

integer

The timestamp when the event was generated, typically in milliseconds since the Unix epoch (January 1, 1970). This value can be used to track when the event occurred.

intentId

string

A unique identifier for the specific payment intent that the warning was raised against. This ID ties the event back to the transaction so you can locate and act on the charge.

fraudType

string

The category of fraud reported by the card network or issuing bank. One of:

Value	Description
`card_never_received`	Card Never Received
`fraudulent_card_application`	Fraudulent Card Application
`made_with_counterfeit_card`	Made With Counterfeit Card
`made_with_lost_card`	Made With Lost Card
`made_with_stolen_card`	Made With Stolen Card
`unauthorized_use_of_card`	Unauthorized Use of Card
`misc`	Miscellaneous

Dispute Lost Created