The Customer Label endpoint allows you to review customers across multiple fraud categories, including Payment Fraud and Refund Abuse. This endpoint replaces the legacy v2/label endpoint, which has been deprecated.
See our Payment Fraud or Refund Abuse guides for more information on how to use manual reviews to prevent fraud.
The fraud category associated with this label. One of:
|
The specific label to apply, based on the category selected. • For
Note: The "potential" labels (POTENTIALLY_FRAUDSTER and POTENTIALLY_GENUINE) are only available if Ravelin has enabled them for your account. • For
|
The individual who is reviewing the customer. Their details will appear in the audit log on the Ravelin dashboard so you are able to see who did this review. |
The reason for reviewing the customer with this label. This will appear in the audit log on the dashboard so you are able to see why this customer was reviewed. |
POST https://api.ravelin.com/v2/customer/:customerid:/labels HTTP/1.1
Authorization: token ...
Content-Type: application/json
{
"category": "REFUND_ABUSE",
"review": "UNREVIEWED",
"reviewer": {
"name": "Bilbo Baggins",
"email": "bilbo.b@shiremail.com"
},
"comment": "We spoke to this customer on the phone and determined they are not a fraudster."
}
Example response:
eventTime
string The response's timestamp in the YYYY-MM-DDTHH:MM:SS.Z format. |
{
"eventTime": "2025-01-27T16:43:58.164260202Z"
}
Was this page helpful?