Manual Reviews

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

There are two types of manual review callbacks: one for payment fraud manual reviews and another for refund abuse manual reviews. See our guides on Payment Fraud Manual Reviews and Refund Abuse 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

For refund abuse manual review callbacks:

  • REFUND_ABUSE
  • NOT_REFUND_ABUSE
  • UNREVIEWED
reviewer object

The individual who reviewed the customer.

Show definition

Feedback