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

    Has the value true if the object exists in live mode or the value false if the object exists in test mode.

  • payment_intentnullable stringExpandable

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

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

Retrieve an early fraud warning 

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.

GET /v1/radar/early_fraud_warnings/:id
curl https://api.stripe.com/v1/radar/early_fraud_warnings/issfr_1NnrwHBw2dPENLoi9lnhV3RQ \
-u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:"
Response
{
"id": "issfr_1NnrwHBw2dPENLoi9lnhV3RQ",
"object": "radar.early_fraud_warning",
"actionable": true,
"charge": "ch_1234",
"created": 123456789,
"fraud_type": "misc",
"livemode": false
}

List all early fraud warnings 

Returns a list of early fraud warnings.

Parameters

  • chargestring

    Only return early fraud warnings for the charge specified by this charge ID.

  • createdobject

    Only return early fraud warnings that were created during the given date interval.

  • payment_intentstring

    Only return early fraud warnings for charges that were created by the PaymentIntent specified by this PaymentIntent ID.

More parameters

  • ending_beforestring

  • limitinteger

  • starting_afterstring

Returns

A dictionary with a data property that contains an array of up to limit EarlyFraudWarnings, starting after EarlyFraudWarnings starting_after. Each entry in the array is a separate EarlyFraudWarning object. If no more EarlyFraudWarnings are available, the resulting array will be empty.

GET /v1/radar/early_fraud_warnings
curl -G https://api.stripe.com/v1/radar/early_fraud_warnings \
-u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
-d limit=3
Response
{
"object": "list",
"url": "/v1/radar/early_fraud_warnings",
"has_more": false,
"data": [
{
"id": "issfr_1NnrwHBw2dPENLoi9lnhV3RQ",
"object": "radar.early_fraud_warning",
"actionable": true,
"charge": "ch_1234",
"created": 123456789,
"fraud_type": "misc",
"livemode": false
}
]
}

Reviews 

Reviews can be used to supplement automated fraud detection with human expertise.

Learn more about Radar and reviewing payments here.

Value Lists 

Value lists allow you to group values together which can then be referenced in rules.

Related guide: Default Stripe lists