Callbacks

Order Decision Callbacks

Order Decision Callbacks allow you to Approve or Reject orders within the Ravelin dashboard and send a callback to your Order Management System with the updated status to allow the order to be released or cancelled. Further information about Order Decisions in the Ravelin dashboard can be found here.

Callbacks are sent in the following format:

"orderId": "123456789", 
"label": "REJECTED|PENDING|APPROVED",
"reviewer": {
   "name": "Thomas Anderson",
   "email": "t.anderson@matrix.com"
},
"timestamp": "2020-01-23T17:32:58Z"
}

To configure Order Decision Callbacks, please contact us and provide us with your callback URL and an optional token.

Manual Review Callbacks

Manual Review Callbacks allow you to keep your internal system in sync with manual reviews carried out on the Ravelin Dashboard, by sending a callback any time a review is carried out.

Callbacks are sent in the following format:

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

To configure Manual Review callbacks, please contact us and provide us with your callback URL and an optional token.

Score Callbacks (Deprecated)

[DEPRECATION NOTICE] Score Callbacks are deprecated. Please see requesting a score for retrieving a Ravelin action and score for a customer.

{
    "customerId": "123456789",
    "action": "ALLOW",
    "score": 11,
    "source": "MANUAL_REVIEW",
    "scoreId": "40ba-843e-43c71",
    "comment": "Best customer!"
}

When the fraud status of one of your customers changes, Ravelin sends you a callback.

This can happen for a variety of reasons, including but not limited to:

  • A customer is manually reviewed through the dashboard, or
  • An event is received through the API, or
  • We discover a fraud network, and some of them exist in your system, or
  • Machine learning models are updated.

Any of these will cause a HTTPS request to your system. The body is a JSON blob, with the same semantics as the response to scored POST requests (see above).