Skip to main content

Service Documentation: "Post Risk"

This service allows you to submit a request to process and assess the risk associated with a specific transaction or activity. The request will contain relevant information about the transaction or activity, as well as any other data necessary to conduct an accurate risk assessment. Upon receiving the request, the system will analyze the provided data using various risk assessment models and algorithms to determine the likelihood that the transaction is fraudulent or represents some other type of risk.

Risk

Service Overview

  • Service Name: Post risk
  • URL: {URL_Base}/api/v1/risk
  • Method: POST
  • Functionality:  The Post Risk service facilitates the submission of requests for processing and evaluating the risk associated with a particular transaction or activity. Users can send relevant information about the transaction or activity, along with any additional data necessary for a thorough risk assessment. Upon receiving the request, the system employs various risk assessment models and algorithms to analyze the provided data. The outcome of this analysis indicates the likelihood of the transaction being fraudulent or representing other types of risks.

Request Parameters:  

  • cid: The customer ID that we will provide you
  • csid:  Bank session ID
  • userID:  Bank user ID
  • additionalData: Key value pair dictionary (the generic values can be viewed above)

Response Structure

The API responds with a JSON object listing the risk levels configured within the system. Each entry in the response includes:

  • score: Score assigned to the validation of the queried customer's session" is a numerical value that represents the level of risk associated with the validation process of a specific customer's session.

Example Response

 

{
  "score": 0
}

Example CURL Request

To query the risk for a specific project, utilize the following curl command:

curl -X 'POST' \
  'https://fraud-detector-api.iristest.statsd.io/api/v1/risk' \
  -H 'accept: application/json' \
  -H 'apiKey: 73tB7AZM4K4Y9NmG1i8sR3H7hJ26Ltub73APmZVYgE' \
  -H 'Content-Type: application/json' \
  -d '{
  "cid": "iristest",
  "csid": "demo0883d839",
  "userID": "1193539722",
  "additionalData": {}
}'

Make sure you replace {BaseURL} with the actual base URL of the service, and your_api_key with the API key provided to you.

Back to top