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.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 enregistrethree_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èglereview 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 à
paidet Whop envoiepayment.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.
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.
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: falseconservent 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ègleallow 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 sesmetadata et de son état actif. Ici, le seuil de blocage passe de 85 à 90 après avoir écarté trop de vrais acheteurs.
status: "deleted".
Mesurer l’effet
Chaque paiement liste les règles qui lui ont correspondu danspayment_rule_matches, avec le nom que la règle portait à ce moment-là.
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.

