# Risk Scoring

> What the score means, and the levers that are yours.

Shield gives every live payment a score from 0 to 100, shown in the Dashboard with the reasons behind
it.

If you charge from your own server with a secret key, see
[If you run your own checkout](https://docs.wajub.com/risk/shield/quickstart#if-you-run-your-own-checkout).

## The bands, and what they are not

| Score     | Band     |
| --------- | -------- |
| 0 to 20   | Low      |
| 21 to 50  | Medium   |
| 51 to 80  | High     |
| 81 to 100 | Critical |

These are labels for reading a list at a glance. The decision comes from
[your thresholds](https://docs.wajub.com/risk/shield/quickstart), not from the band, so a payment at 62 is `high` whether your
block threshold is 70 or 60, and only one of those refuses it.

## Raising the risk yourself

Set `risk_flag` to `high` or `medium` in the payment's `metadata` to raise the risk Shield assigns
to that payment. The same key on the customer's own `metadata` applies to every payment they make,
and there only `high` is read.

## Blocklist and sanctions matches

Two matches always refuse the payment, whatever your thresholds and your rules.

**A blocklist match**, on your own list, while the list is switched on.

**A sanctions match**, against the platform watchlist, on every plan and whether or not you have
configured Shield. Sanctions screening is not a feature you buy.

For a possible match, a name that resembles a listed one, you choose what happens, in **Shield,
Risk controls** or with `sanctions_near_match_action` on [`PUT /shield/settings`](https://docs.wajub.com/api/shield), on
every plan and whether or not your own Shield settings are switched on.

| Your choice           | What happens to the payment                                                                                                                                                               |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `review`, the default | It is sent to review whatever its score, with `sanctions_possible_match` as the reason. **Shield, Reviews** lists it even when Shield is switched off; you can then only mark it reviewed |
| `block`               | It is refused, like a match                                                                                                                                                               |

A review never holds the funds: the payment is collected, and the decision is yours to take
afterwards.

## Lost disputes and your blocklist

On Shield Advanced, losing a dispute can add the payer's email and phone to your blocklist
automatically. An entry added this way refuses payments only while Shield and your blocklist are
both switched on, like any other entry. Sandbox activity never adds anything to this list.

## Your levers

Your levers are your thresholds, your [rules and lists](https://docs.wajub.com/risk/shield/rules), and the `risk_flag` you
set.

- [Shield](https://docs.wajub.com/risk/shield): Where the score sits in a payment, and what the plans differ on.
- [Shield Rules](https://docs.wajub.com/risk/shield/rules): Custom rules, the blocklist and the allowlist, and which one wins.
- [Quickstart](https://docs.wajub.com/risk/shield/quickstart): Thresholds, the review queue, and your own checkout.
- [Disputes](https://docs.wajub.com/payments/disputes): Responding to a dispute, and what a lost one can add to your blocklist.
