Skip to content

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

ScoreBand
0 to 20Low
21 to 50Medium
51 to 80High
81 to 100Critical

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 choiceWhat happens to the payment
review, the defaultIt 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
blockIt 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.

What did you think of this content?