How it works

Workflow

1. Create Decision: Send a transaction to the create_decision endpoint to get an initial risk assessment.

2. Evaluate Result:

   • If the status is Accepted or Rejected, the decision is final.

   • If the status is Review, the transaction requires manual review.

3. Update Decision (if needed): For transactions in Review status, use the update_decision endpoint with the transaction_id obtained in step 1 to make a final decision.

---

Risk Information Codes

Information codes (info_codes) provide details about the factors that influenced the decision:

• address: Address-related codes

• phone: Phone-related codes

• globalVelocity: Transaction velocity codes

• suspicious: Suspicious activity indicators

• identityChange: Identity change indicators

• internet: IP and internet-related information

---

Error Handling

In case of an error, the API will return a response with the following format:

{
    "status_code": "ERROR_CODE",
    "status": "fail",
    "description": "Error description"
}

Common HTTP error codes include:

• 400 Bad Request: Invalid parameters

• 401 Unauthorized: Invalid API key

• 403 Forbidden: Resource not found

• 500 Internal Server Error: Internal server error