Manual Reviews

Manual review callbacks allow you to send a request to your internal customer system when you review customers for payment fraud in the Ravelin dashboard. This allows you to keep your internal system in sync with Ravelin.

See our guide on Payment Fraud Manual Reviews for more information.

To configure manual review callbacks, please contact us and provide us with your callback URL and an optional authorization token.

Callback format

Manual review callbacks are sent in the following format:

POST https://your-manual-reviews-callback-url.com HTTP/1.1
Authorization: token YOUR_AUTH_TOKEN_OPTIONAL
Content-Type: application/json; charset=utf-8

{
  "timestamp": "2020-01-23T17:32:58Z",
  "customerId": "123456789",
  "label": "GENUINE",
  "reviewer": {
    "name": "Bilbo Baggins",
    "email": "bilbo.b@shiremail.com"
  }
}

Show all
timestamp string

The time at which the manual review was completed.

customerId string

The ID of the customer who was reviewed.

label string

The label applied to the customer.

For payment fraud manual review callbacks:

  • FRAUDSTER
  • GENUINE
  • POTENTIALLY_FRAUDSTER
  • POTENTIALLY_GENUINE
  • UNREVIEWED
reviewer object

The individual who reviewed the customer.

Show definition

Feedback