Early Fraud Warnings

An early fraud warning indicates that the card issuer has notified us that a charge may be fraudulent.

Related guide: Early fraud warnings

Was this section helpful?YesNo
Retrieve an early fraud warning
GET/v1/radar/early_fraud_warnings/:id
List all early fraud warnings
GET/v1/radar/early_fraud_warnings

The Early Fraud Warning object

Attributes

  • idstring

    Unique identifier for the object.

  • objectstring

    String representing the object’s type. Objects of the same type share the same value.

  • actionableboolean

    An EFW is actionable if it has not received a dispute and has not been fully refunded. You may wish to proactively refund a charge that receives an EFW, in order to avoid receiving a dispute later.

  • chargestringExpandable

    ID of the charge this early fraud warning is for, optionally expanded.

  • createdtimestamp

    Time at which the object was created. Measured in seconds since the Unix epoch.

  • fraud_typestring

    The type of fraud labelled by the issuer. One of card_never_received, fraudulent_card_application, made_with_counterfeit_card, made_with_lost_card, made_with_stolen_card, misc, unauthorized_use_of_card.

  • livemodeboolean

    If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.

  • payment_intentnullable stringExpandable

    ID of the Payment Intent this early fraud warning is for, optionally expanded.

The Early Fraud Warning object
{
"object": "radar.early_fraud_warning",
"actionable": true,
"charge": "ch_1234",
"created": 123456789,
"fraud_type": "misc",
"livemode": false
}

Retrieve an early fraud warning

GET /v1/radar/early_fraud_warnings/:id

Retrieves the details of an early fraud warning that has previously been created.

Please refer to the early fraud warning object reference for more details.

Parameters

No parameters.

Returns

Returns an EarlyFraudWarning if a valid identifier was provided.

curl https://api.stripe.com/v1/radar/early_fraud_warnings/{{EARLY_FRAUD_WARNING_ID}} \
-u "sk_test_Hrs6SAopgFPF0bZXSN3f6ELNsk_test_Hrs6SAopgFPF0bZXSN3f6ELN:"
Response
{
"object": "radar.early_fraud_warning",
"actionable": true,
"charge": "ch_1234",
"created": 123456789,
"fraud_type": "misc",
"livemode": false
}
Morty Proxy This is a proxified and sanitized view of the page, visit original site.