Indication de risque

ExcelID peut vous donner une indication du niveau de risque d’une demande. Elle vous aide à décider d’exiger, ou non, une étape de contrôle supplémentaire avant d’accepter une opération sensible (voir Contrôle supplémentaire).

Comment l’obtenir

Envoyez returnRisk: true dans l’appel à /auth ou /sign. À la fin de la demande, /collect renvoie alors un champ risk.

L’indication de risque exige que endUserIp soit correct : c’est l’adresse de l’appareil de l’utilisateur telle que votre service la voit, pas celle d’un proxy.

Les valeurs

`risk`	Signification	Action conseillée
`low`	Rien d’inhabituel dans la demande.	Poursuivez normalement.
`moderate`	Un élément inhabituel : appareil récent, localisation inattendue, usage différent des habitudes.	Exigez un contrôle supplémentaire pour les opérations sensibles.
`high`	Plusieurs éléments inhabituels, ou comportement qui rappelle une fraude.	Exigez un contrôle supplémentaire ou refusez l’opération, selon votre politique.

L’indication est un signal, pas un verdict : c’est à vous de décider ce que vous en faites. Une valeur absente ou inconnue doit être traitée comme moderate.

Exemple

{
  "orderRef": "131daac9-16c6-4618-beb0-365768f37288",
  "status": "complete",
  "hintCode": "complete",
  "completionData": {
    "user": { "personalNumber": "B1234567", "name": "Aïcha Ouédraogo" },
    "risk": "moderate"
  }
}