Private preview
Customer labeling Private preview
Report customer account reviews, restrictions, and suspensions to improve Radar fraud and abuse signals.
Customer labeling lets you report when you review, restrict, or suspend a customer’s account. Stripe uses these outcome signals to improve Radar fraud and abuse signals.
When you submit a label, Stripe creates an Account Activity. Report an activity each time you review, restrict, or suspend a customer.
Customer labeling is available in private preview. Request access before you report Account Activities.
Request access to the customer labeling private preview.
Enter your email to request access.
| Label | Use when | Supported account details |
|---|---|---|
account_restricted | You limit a customer’s access but keep their account active. | A Customer ID or v2 Account ID |
account_suspended | You disable a customer’s access to their account. | A Customer ID |
account_reviewed | You complete a review of the customer within your system. | A Customer ID or v2 Account ID |
For account_restricted, provide the Customer ID associated with the customer in your Stripe integration, or provide their v2 Account ID. For account_suspended, provide a Customer ID.
For account_reviewed, provide the Customer ID associated with the customer in your Stripe integration, or provide their v2 Account ID. Inline account data isn’t supported.
Report a reviewed customer
Create an account_reviewed activity after completing a point-in-time review of a customer. Stripe uses this report only to improve model training. It doesn’t change the customer’s internal account state.
Command Line
cURL
The account_reviewed activity supports the following point-in-time review outcomes:
| Outcome | Use when |
|---|---|
trusted | You’re highly confident that the customer’s behavior is trustworthy. |
other | Any other review outcome. |
Report a restricted customer
Create an account_restricted activity when you limit a customer’s access. Set reason to abuse when the restriction is in response to abusive behavior.
Command Line
cURL
Report a suspended customer
Create an account_suspended activity when you disable a customer’s access to their account.
Command Line
cURL
Choose a reason
Both account_restricted and account_suspended labels support the following reasons:
| Reason | Use when |
|---|---|
abuse | You restricted or suspended the customer for abusive behavior. |
other | You restricted or suspended the customer for another reason. |
By default, the activity’s occurred_at timestamp is the time you create it. If the review, restriction, or suspension happened earlier, provide its timestamp in occurred_at. Use metadata to attach context such as the review source.
Next steps
- Learn about customer abuse prevention
- Review the Account Activities API