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.
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, 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, 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, and the risk_flag you
set.
Related pages