Skip to main content
Un paiement frauduleux vous coûte le montant, des frais de litige de 15 $ et un taux de litiges dégradé. Whop analyse les checkouts avec ses propres contrôles antifraude. Les règles de paiement y ajoutent votre propre couche : des conditions que vous rédigez, et une action que Whop applique lorsqu’un checkout les remplit toutes. Les règles s’exécutent après les contrôles de Whop et ne les assouplissent jamais. Un paiement bloqué par Whop reste bloqué.

Quatre façons dont une règle peut agir

Une règle peut lire risk_score, amount_in_usd, card_country, card_bin, customer_email et ip_address. card_bin est le numéro d’identification bancaire (BIN) de la carte utilisée pour le paiement : les six premiers chiffres du numéro de carte. List fields renvoie les opérateurs et valeurs acceptés par chacun. En cas de doute, demandez une vérification plutôt que de bloquer. Un blocage écarte aussi les vrais acheteurs qui correspondent, alors qu’une vérification leur permet de prouver qu’ils sont titulaires de la carte.
Exécutez ces exemples dans un environnement serveur de confiance où WHOP_API_KEY est défini. Réutilisez les imports et la configuration du client du premier exemple pour votre langage.

Bloquer la fraude évidente

Commencez par le schéma que vous voyez le plus souvent dans vos litiges. Cette règle bloque un paiement auquel Whop attribue un score de 85 ou plus, effectué avec une carte émise hors des États-Unis.
Passez toujours account_id. Sans lui, la règle est créée sur le compte par défaut de vos identifiants, ce qui est une source d’erreur facile pour une plateforme qui en gère plusieurs. Les règles sont publiées vers le checkout chaque minute : une règle nouvelle ou modifiée commence donc à s’appliquer en quelques minutes.
Autorisation requise : payment:manage pour écrire des règles, payment:basic:read pour les lire. Ajoutez des autorisations en suivant le guide des autorisations.

Vérifier les commandes importantes

Une commande importante passée avec une carte volée est la rétrofacturation que vous voulez le moins. Une commande importante d’un vrai client est la vente que vous voulez le moins perdre. Une vérification 3D Secure distingue les deux, et le paiement enregistre three_ds_verified: true lorsque l’acheteur la réussit. enforce_3ds est ignoré, mais tout de même enregistré sur le paiement, lorsque le checkout ne peut pas porter de vérification. Cela concerne les paiements hors session comme les renouvellements, les variantes qui définissent leur propre niveau 3D Secure, les paiements non effectués par carte et les cartes que le processeur ne peut pas vérifier. American Express n’est vérifiée que pour les paiements en USD.

Examiner un paiement avant de l’encaisser

Une règle review autorise un paiement par carte éligible sans le capturer. L’acheteur termine le checkout et obtient l’accès à l’adhésion dès l’autorisation. Utilisez-la pour les commandes que vous traitez manuellement, ou pour un schéma risqué sans être une fraude certaine. Whop capture automatiquement 48 heures plus tard, sauf si vous agissez avant :
  • Capturez pour encaisser l’argent. Le paiement passe à paid et Whop envoie payment.succeeded, votre signal pour traiter la commande.
  • Annulez pour libérer le blocage des fonds. Whop révoque l’accès, remet en stock les articles réservés et envoie payment.canceled.
Whop envoie payment.authorized au début du blocage, ainsi que pour les autorisations demandées via l’API. Un paiement bloqué affiche status: "authorized" avec substatus: "requires_capture". Récupérez le statut du paiement pour obtenir auto_capture_at. Cette règle bloque les paiements par carte d’au moins 250 $ effectués avec une carte émise hors des États-Unis.
Une fois la commande examinée, capturez-la à l’aide de l’ID du paiement :
Ou annulez-la :

Limites de l’examen

  • Seules les cartes en session peuvent être bloquées. Apple Pay, Google Pay, les paiements bancaires, par solde et hors session comme les renouvellements ignorent l’examen. La correspondance est tout de même enregistrée dans payment_rule_matches.
  • Les paiements créés avec capture: false conservent leur propre calendrier. Une règle d’examen ne le remplace jamais.
  • La capture est totale ou nulle. Remboursez ensuite pour en restituer une partie.
  • Les acheteurs ont le produit avant votre décision. Prévenez-les si vous annulez.

Ne pas freiner les acheteurs de confiance

Une règle allow exempte les acheteurs de confiance de vos règles de blocage, d’examen et de vérification.

Resserrer une règle

Le comportement d’une règle est figé à sa création, afin que les paiements qu’elle a tranchés continuent de désigner la règle responsable. Pour modifier son action ou ses conditions, remplacez-la : l’ancienne règle est supprimée et une remplaçante dotée d’un nouvel ID hérite de son nom, de ses metadata et de son état actif. Ici, le seuil de blocage passe de 85 à 90 après avoir écarté trop de vrais acheteurs.
Désactivez une règle pour la mettre en pause et activez-la pour la reprendre. Supprimez-la pour la retirer. Elle reste consultable avec status: "deleted".

Mesurer l’effet

Chaque paiement liste les règles qui lui ont correspondu dans payment_rule_matches, avec le nom que la règle portait à ce moment-là.
Des litiges sur des paiements sans aucune correspondance signifient qu’une règle est trop restrictive. Une règle qui correspond à bien plus de paiements que ceux que vous perdiez est trop large. Pour des totaux dans le temps, les métriques payment_rule_matches et payment_rule_matched_volume de l’API Stats se ventilent par payment_rule_ids ou par action.

Étapes suivantes

Référence des règles de paiement

Chaque endpoint, paramètre et champ de réponse.

Remboursements et litiges

Répondez aux rétrofacturations qui passent malgré tout.