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.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 registreertthree_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
Eenreview-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
paiden Whop verstuurtpayment.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.
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.
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: falsebehouden 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
Eenallow-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.
status: "deleted".
Het effect meten
Elke betaling vermeldt inpayment_rule_matches de regels die erop van toepassing waren, met de naam die de regel op dat moment had.
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.

