Risk Indicators#

Risk indicators provide a simplified assessment of tenant risk based on scoring results. Each score type generates its own risk indicator.

Risk Levels#

LevelScore RangeDescription
low_risk70–100Tenant meets or exceeds typical requirements
medium_risk40–69Tenant may need additional review or conditions
high_risk0–39Tenant does not meet minimum requirements

Using Risk Indicators#

Risk indicators can be used for automated decisioning:

const report = await casapay.scoreReports.retrieve('scrpt_xyz789');

const decisions = {
  low_risk: 'auto_approve',
  medium_risk: 'manual_review',
  high_risk: 'auto_decline',
};

for (const score of report.scores) {
  const decision = decisions[score.risk_indicator];
  console.log(`${score.score_type}: ${score.value} (${score.risk_indicator}) → ${decision}`);
}

Score-Specific Thresholds#

Different score types may have different threshold configurations. You can customize thresholds in your Dashboard under Settings → Scoring Configuration.

Score TypeLow RiskMedium RiskHigh Risk
tenant_score≥ 7040–69< 40
cash_flow_score≥ 6535–64< 35
credit_score≥ 7550–74< 50

Risk thresholds are configurable per account. The default thresholds shown above can be adjusted based on your risk appetite and local market conditions.