Shield

Shield examine chaque paiement live avant l'appel d'un prestataire et lui attribue un nombre entre 0 et 100. Au-dessus de l'un de vos seuils, le paiement est directement refusé. Au-dessus de l'autre, il est traité et ajouté à une file pour que vous l'examiniez. Le score combine de nombreux signaux sur le payeur, l'appareil, la carte et l'historique de chaque identifiant, et Wajub ajuste ces signaux en permanence.

Shield fonctionne même si vous ne l'avez pas configuré. Votre configuration détermine sa sévérité envers votre trafic et les actions qu'il peut effectuer au-delà du simple calcul du score.

1. 1Noté avant le routage

   Chaque paiement live reçoit une note entre 0 et 100 avant qu'un prestataire soit contacté.

2. 2Signalé ne veut pas dire retenu

   Au-dessus du seuil review, l'argent arrive quand même. La file est une liste de tâches, pas une retenue.

3. 3Seul un blocage l'arrête

   Au-dessus du seuil block, l'appel renvoie 403 et aucun prestataire ne voit jamais le paiement.

Sa place dans un paiement

Un paiement nécessite deux appels. Shield intervient lorsque vous débitez le paiement, dans le second, avant tout appel à un prestataire.

L'ordre est important. Un paiement refusé par vos propres plafonds ne reçoit pas de score et n'apparaît pas dans votre file d'examen.

Trois résultats, dont un seul arrête le paiement

Une tentative bloquée rejoint la même file immédiatement, sans rien encaisser. S'il s'agit d'une erreur, clôturez-la avec allow this customer : la prochaine tentative de ce client passe, quel que soit votre plan.

Deux couches, dont une seule vous appartient

Wajub contrôle sa propre plateforme, puis vos paramètres s'appliquent par-dessus.

La couche de la plateforme applique les propres seuils de blocage et d'examen de Wajub à tous les comptes. Vous ne pouvez pas la désactiver. Elle s'applique avant toute configuration de votre part. Wajub peut faire évoluer ces seuils, et ajuster les signaux, au gré de la fraude : GET /shield/settings renvoie toujours les seuils qui s'appliquent à vous. Lisez-les là plutôt que d'écrire un nombre dans votre code.

Votre couche remplace ces seuils par les vôtres après l'activation de Shield. Vous pouvez être plus strict que Wajub, jamais moins. Un seuil de blocage supérieur à celui de la plateforme est ramené à cette limite. Désactiver ensuite Shield ne supprime pas votre protection. La décision revient simplement aux seuils de la plateforme.

Toutes les autres actions de Shield, notamment les règles personnalisées, les listes et l'activation automatique de 3D Secure, existent uniquement lorsque votre propre configuration est active.

Fonctionnalités réelles de chaque plan

Le contrôle de base est actif avec tous les plans. Vous payez pour pouvoir agir sur ses résultats.

Shield Advanced est inclus dans les plans Scale et Enterprise. Il est proposé comme option payante sur les plans inférieurs. Les règles et les entrées de liste laissées par le passage à un plan inférieur sont conservées, mais cessent de s'appliquer. Elles retrouvent leur état précédent si vous vous réabonnez. Les clients que vous avez autorisés depuis un examen font exception : ils restent autorisés avec tous les plans.

Ce que votre intégration peut consulter

Rien. La réponse du paiement ne contient aucun objet shield, le paiement ne présente aucun score de risque et aucun webhook n'est émis lors d'une décision de Shield. Votre code voit uniquement le refus, qui porte error_code: shield_blocked et la référence à donner au support dans block_reference.

Réponse · 403 Forbidden

{

"code": 403,

"status": "Forbidden",

"error_code": "shield_blocked",

"message": "Payment blocked: transaction risk score too high. Please contact support and reference BLK-K3M9XQ2P.",

"block_reference": "BLK-K3M9XQ2P"

}

La transaction reste au statut pending et n'est pas modifiée. Aiguillez votre code sur error_code, pas sur le message. La référence BLK- de block_reference identifie précisément cette décision. Un payeur qui affirme être légitime peut la communiquer pour vous permettre de le retrouver dans le Dashboard. La tentative figure dans votre file d'examen, où allow this customer le libère pour son prochain essai.

Les endpoints

Shield se configure dans le Dashboard, sous Shield. Les mêmes paramètres sont accessibles dans l'API avec votre clé privée.

Tous sont réservés au mode live et nécessitent une clé secrète. Aucun endpoint n'existe pour les règles personnalisées, la file d'examen ou le détail des signaux. Ces éléments sont uniquement disponibles dans le Dashboard.