Démarrage rapide

Activez Shield, définissez des seuils valides et traitez la file d'examen.

Shield évalue déjà vos paiements live avec les seuils de la plateforme. Son activation vous permet de les remplacer par vos propres seuils et de débloquer toutes les fonctionnalités qui agissent sur un score au lieu de simplement le signaler.

Cinq étapes, toutes en mode live.

Vous ne pouvez rien essayer au préalable

Les paiements dans la sandbox ne reçoivent aucun score et les endpoints Shield refusent une clé de test. Tous les paramètres définis ici s'appliquent aux véritables clients dès le paiement suivant. C'est pourquoi les seuils possèdent des valeurs minimales. Procédez dans cet ordre : activez, observez, puis rendez les seuils plus stricts.

1. Activer Shield

Dans le Dashboard, Shield affiche un écran d'activation jusqu'à ce que vous l'activiez. Cette opération ne définit rien d'autre. Vous commencez avec les valeurs 80 et 50 qui s'appliquaient déjà.

Un seul appel suffit depuis l'API.

Activer Shield

curl -X PUT https://api.wajub.com/shield/settings \
  -H "Authorization: sk.kZ3qP8mWvL2xR7tB5nY4hC6dF9jS1aG0eU3i…" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true }'

La réponse contient les paramètres désormais appliqués, dont un indicateur advanced qui vous indique si les règles, les listes et l'activation automatique de 3D Secure sont disponibles.

2. Définir des seuils réellement acceptés

Les deux seuils sont limités. Une valeur située hors de leurs limites est refusée ou discrètement ramenée dans l'intervalle. Ce comportement surprend souvent.

Champ	Valeur acceptée	Comportement hors de cette valeur
`block_threshold`	De 40 à 100	Sous 40 ou au-dessus de 100, la requête est rejetée
`block_threshold`	Jamais au-dessus de 80	Une valeur supérieure au seuil de la plateforme est ramenée à 80
`review_threshold`	De 10 à 99	Sous 10 ou au-dessus de 99, la requête est rejetée
`review_threshold`	Toujours inférieur au seuil de blocage	Une valeur au moins égale à votre seuil de blocage est ramenée à une unité en dessous

Une requête qui demande un seuil de blocage de 90 réussit donc, mais vous laisse sur 80. Relisez les paramètres après leur écriture au lieu de supposer que la valeur envoyée est celle appliquée.

Définir vos propres seuils

curl -X PUT https://api.wajub.com/shield/settings \
  -H "Authorization: sk.kZ3qP8mWvL2xR7tB5nY4hC6dF9jS1aG0eU3i…" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "block_threshold": 70,
    "review_threshold": 45,
    "auto_3ds_enabled": true,
    "blocklist_enabled": true
  }'

auto_3ds_enabled et blocklist_enabled sont enregistrés avec tous les plans, mais produisent un effet uniquement avec Shield Advanced. Une valeur true enregistrée sur un plan qui ne possède pas cette option est renvoyée comme false.

Pourquoi la valeur minimale est 40

Un nouveau payeur légitime obtient un score de 20 à 30 avec les seuls signaux de première apparition : un numéro de téléphone et une adresse e-mail jamais rencontrés par la plateforme, ainsi qu'aucune donnée de navigateur lors d'un appel de serveur à serveur. Un seuil de blocage inférieur à 40 refuserait de nouveaux clients ordinaires. Un seuil de 0 refuserait tout le monde. Commencez avec la valeur par défaut, examinez les signalements, puis réduisez-la progressivement.

3. Lire la décision prise

Cette information ne vient pas de l'API. La réponse du paiement ne contient aucun score et aucun webhook n'est émis lors d'une décision de Shield. Tout se trouve dans le Dashboard.

Emplacement	Contenu
Shield, overview	Le nombre de paiements bloqués, signalés et examinés ce mois-ci, ainsi que leur répartition
Shield, reviews	La file des paiements signalés qui attendent votre examen
Le paiement lui-même	Son score et les codes de signalement qui l'ont produit

Les compteurs de la page overview sont mis en cache pendant cinq minutes. La file ne l'est pas.

4. Traiter la file d'examen

La file contient tous les paiements signalés des 90 derniers jours que vous n'avez pas encore clôturés. Elle affiche les plus récents en premier, vingt par page. Chaque ligne contient le score, les codes de signalement, le client et le montant que renverrait un remboursement total.

Vous pouvez clôturer une ligne avec l'une des quatre décisions suivantes.

Décision	Effet
Approve	Marque le paiement comme examiné. Rien d'autre ne change
Allow this customer	Ajoute également une règle d'autorisation sur son adresse e-mail et son numéro. Ses prochains paiements contournent le score
Block this customer	Ajoute également son adresse e-mail et son numéro à la liste de blocage. Ce paiement reste encaissé
Block and refund	Même comportement, avec le remboursement total de ce paiement

Approve est disponible avec tous les plans. Les trois autres décisions nécessitent Shield Advanced, car chacune écrit dans une liste ou une règle.

Un simple blocage vous laisse conserver l'argent

Un paiement signalé a déjà été encaissé. Le blocage du client vous protège uniquement de sa prochaine tentative. Si vous avez conclu qu'un paiement est frauduleux, Block and refund est la décision qui agit sur celui qui se trouve devant vous. Elle suit le parcours de remboursement classique, que vous pouvez suivre sur la page du paiement.

5. Reconnaître un blocage

Un paiement bloqué n'atteint jamais un prestataire. L'appel renvoie immédiatement une réponse, la transaction reste à pending et votre intégration reçoit un message avec une référence.

Réponse · 403 Forbidden

{

"code": 403,

"status": "Forbidden",

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

}

Comme la transaction n'est pas modifiée, vous pouvez proposer au payeur une autre tentative sur le même paiement. Son score sera recalculé depuis le début. Si rien n'a changé, il sera de nouveau bloqué.

Si vous utilisez votre propre checkout

Les pages hébergées de Wajub envoient un petit bloc de données du navigateur avec chaque débit. Si vous avez développé votre propre page de paiement, envoyez le même bloc dans data._client. Shield peut alors distinguer un véritable navigateur d'un script.

Débiter avec les signaux du navigateur

{

"channel": "card",

"data": {

"payment_method_id": "pm_1PqR8xLkdIwHu7ix0aB3cD4e",

"_client": {

"timezone": "Africa/Douala",

"language": "fr-CM",

"screen": "1512x982",

"color_depth": 24,

"fingerprint": "9f2c41ab7e05d3c8"

}

Tous les champs sont facultatifs et chacun est utilisé différemment. Le fuseau horaire et la langue sont comparés au pays de l'adresse IP du payeur. La résolution de l'écran détecte les navigateurs sans interface graphique, qui renvoient 0x0. L'empreinte permet à Shield de reconnaître un appareil sur plusieurs paiements. Elle rend possibles la vélocité et la réputation de l'appareil.

L'envoi de signaux peut aussi augmenter un score

Un appel de serveur à serveur sans bloc _client reçoit trois points et rien d'autre. L'envoi du bloc supprime ces trois points, mais active les contrôles de cohérence. Un payeur derrière un VPN dont le fuseau horaire du navigateur ne correspond pas au pays de son adresse IP reçoit trente-cinq points. C'est le résultat attendu, pas une régression. Tenez-en compte avant de comparer les scores obtenus avant et après cet ajout.

Pages associées