Skip to main content
Een frauduleuze betaling kost je het geld, $15 aan disputekosten en een slechter disputepercentage. Whop screent checkouts met eigen fraudecontroles. Betalingsregels voegen daar je eigen laag aan toe: voorwaarden die jij schrijft, en een actie die Whop uitvoert wanneer een checkout aan al die voorwaarden voldoet. Regels worden uitgevoerd na de controles van Whop en versoepelen die nooit. Een betaling die Whop blokkeert, blijft geblokkeerd.

Vier manieren waarop een regel kan handelen

Een regel kan risk_score, amount_in_usd, card_country, card_bin, customer_email en ip_address lezen. card_bin is het Bank Identification Number van de kaart waarmee de betaling is gedaan: de eerste zes cijfers van het kaartnummer. List fields geeft de operators en waarden terug die elk veld accepteert. Twijfel je, laat de koper dan liever verifiëren dan te blokkeren. Een blokkade weert ook echte kopers die aan de voorwaarden voldoen, terwijl een verificatie hen laat bewijzen dat zij de kaarthouder zijn.
Voer deze voorbeelden uit in een vertrouwde serveromgeving waarin WHOP_API_KEY is ingesteld. Hergebruik de imports en clientconfiguratie uit het eerste voorbeeld voor je taal.

Blokkeer de duidelijke fraude

Begin met het patroon dat je het vaakst ziet in je disputes. Deze regel blokkeert een betaling die Whop met 85 of hoger scoort, met een kaart die buiten de VS is uitgegeven.
Geef altijd account_id mee. Zonder dat veld komt de regel terecht op het standaardaccount van je credential, wat makkelijk misgaat bij een platform dat meerdere accounts beheert. Regels worden elke minuut naar de checkout gepubliceerd, dus een nieuwe of gewijzigde regel wordt binnen een paar minuten toegepast.
Vereiste machtiging: payment:manage om regels te schrijven, payment:basic:read om ze te lezen. Voeg machtigingen toe via de handleiding voor machtigingen.

Laat grote bestellingen verifiëren

Een grote bestelling met een gestolen kaart is de chargeback die je het minst wilt. Een grote bestelling van een echte klant is de verkoop die je het minst wilt verliezen. Een 3D Secure-verificatie onderscheidt de twee, en de betaling registreert three_ds_verified: true wanneer de koper slaagt. enforce_3ds wordt overgeslagen, maar wel op de betaling geregistreerd, wanneer de checkout geen verificatie kan uitvoeren. Dat geldt voor off-session betalingen zoals verlengingen, varianten die hun eigen 3D Secure-niveau instellen, betalingen zonder kaart en kaarten die de processor niet kan verifiëren. American Express wordt alleen bij USD-betalingen geverifieerd.

Een betaling beoordelen voordat je die belast

Een review-regel autoriseert een geschikte kaartbetaling zonder die te capturen. De koper voltooit de checkout en krijgt bij autorisatie toegang tot het lidmaatschap. Gebruik dit voor bestellingen die je handmatig afhandelt, of voor een patroon dat riskant is maar niet zeker fraude. Whop captured automatisch 48 uur later, tenzij je eerder ingrijpt:
  • Capture om het geld te innen. De betaling wordt paid en Whop verstuurt payment.succeeded, je signaal om de bestelling te leveren.
  • Void om de reservering vrij te geven. Whop trekt de toegang in, zet gereserveerde voorraad terug en verstuurt payment.canceled.
Whop verstuurt payment.authorized wanneer de reservering begint, en ook bij autorisaties die via de API zijn aangevraagd. Een gereserveerde betaling heeft status: "authorized" met substatus: "requires_capture". Haal de betalingsstatus op voor auto_capture_at. Deze regel houdt kaartbetalingen van minimaal $250 vast waarvan de kaart buiten de VS is uitgegeven.
Zodra je de bestelling hebt beoordeeld, capture je die op basis van de betalings-ID:
Of void de betaling:

Beperkingen van beoordeling

  • Alleen on-session kaarten kunnen worden vastgehouden. Apple Pay, Google Pay, bank, saldo en off-session betalingen zoals verlengingen slaan de beoordeling over. De match wordt nog steeds geregistreerd in payment_rule_matches.
  • Betalingen die zijn aangemaakt met capture: false behouden hun eigen schema. Een review-regel overschrijft dat nooit.
  • Capture is alles of niets. Doe achteraf een terugbetaling om een deel terug te geven.
  • Kopers hebben het product al voordat jij beslist. Laat het hen weten als je voidt.

Laat vertrouwde kopers doorgaan

Een allow-regel stelt kopers die je vertrouwt vrij van je blokkeer-, beoordelings- en verificatieregels.

Een regel aanscherpen

Wat een regel doet, ligt vast zodra die is aangemaakt, zodat de betalingen waarover hij besliste blijven verwijzen naar de regel die erover besliste. Om de actie of voorwaarden te wijzigen, vervang je de regel: de oude regel wordt verwijderd en een opvolger met een nieuwe ID erft de naam, metadata en actieve status. Hier wordt de blokkeerdrempel verhoogd van 85 naar 90 nadat te veel echte kopers werden tegengehouden.
Deactiveer een regel om die te pauzeren en activeer hem om te hervatten. Verwijder hem om hem buiten gebruik te stellen. Hij blijft leesbaar met status: "deleted".

Het effect meten

Elke betaling vermeldt in payment_rule_matches de regels die erop van toepassing waren, met de naam die de regel op dat moment had.
Disputes op betalingen zonder matches betekenen dat een regel te smal is. Een regel die veel meer betalingen matcht dan je verloor, is te breed. Voor totalen over tijd kun je de metrics payment_rule_matches en payment_rule_matched_volume van de Stats API uitsplitsen naar payment_rule_ids of action.

Volgende stappen

Referentie voor betalingsregels

Elk endpoint, elke parameter en elk responseveld.

Terugbetalingen en disputes

Reageer op de chargebacks die er toch nog doorheen komen.