Skip to main content
type onderscheidt fraudemeldingen (early_fraud_warning), meldingen voorafgaand aan een geschil (dispute_alert) en Visa RDR-zaken die het netwerk al heeft afgesloten met een terugbetaling (rapid_dispute_resolution). Gebruik de Dispute alerts API om alerts voor een account weer te geven, ze te filteren op type of betaling, en actionable te lezen om te zien of een terugbetaling de chargeback nog kan voorkomen.

Endpoints

Attributen

string
vereist
Dispute-alert-ID, met prefix dspa_.
string | null
vereist
Het account waartoe de gemelde betaling behoort, met prefix biz_. null zolang de alert niet is gekoppeld.
number
vereist
Het gemelde bedrag, in hele eenheden van currency. Dit is wat de uitgever heeft gerapporteerd en kan afwijken van het bedrag van de betaling zelf.
boolean
vereist
Of Whop de gemelde betaling automatisch heeft terugbetaald. Weerspiegelt de betaling, dus kan true zijn voor een terugbetaling die via een andere flow (RDR, afhandeling) op dezelfde betaling is uitgevoerd.
string | null
vereist
Het kaartnetwerk zoals gerapporteerd door de uitgever, in kleine letters, zoals visa of mastercard. unknown wanneer de melding geen netwerk en geen herkenbare BIN bevat.
string | null
vereist
Wat de kaarthouder beweert. fraud wanneer die zegt de betaling niet te hebben gedaan: altijd bij een early_fraud_warning, en bij Ethoca-fraudealerts en Visa RDR-zaken die onder een fraudereden zijn ingediend. customer_dispute wanneer die de betaling wel heeft gedaan maar deze betwist, zoals bij een niet-ontvangen product of een geannuleerd abonnement. null wanneer de alert geen claim bevat, zoals een verzoek van een uitgever om transactiedocumenten.Beschikbare opties: fraud, customer_dispute
string
vereist
Wanneer Whop de alert heeft ontvangen, als ISO 8601-tijdstempel.
string
vereist
ISO-valutacode van drie letters van het gemelde bedrag.
object | null
vereist
De alertkosten die aan het account in rekening zijn gebracht, in de valuta waarin ze zijn geïnd. null wanneer fee_charged false is.

Eigenschappen

string
vereist
Het bedrag in hoofdeenheden, als exacte decimale string. Bijvoorbeeld "10.00" is tien dollar. Het is een string zodat geen float het onderweg afrondt.
string
vereist
ISO 4217-valutacode van drie letters, in kleine letters.
integer
vereist
Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de afschrijving zelf wordt uitgevoerd.
integer
vereist
Hoeveel decimalen er moeten worden GETOOND. Meestal gelijk aan decimals, en bewust niet altijd: COP wordt in centavos afgeschreven maar in hele peso’s geschreven, dus is het 2 en 0. Gebruik dit om het getal in je eigen locale op te maken.
boolean
vereist
Of Whop het account voor deze alert alertkosten in rekening heeft gebracht. Altijd false voor early_fraud_warning, waarvoor Whop niet wordt gefactureerd en die nooit wordt doorberekend.
string | null
vereist
Verouderd: altijd null buiten het eigen dashboard van Whop. Naam van de bank die de kaart heeft uitgegeven en de melding heeft ingediend. VEROUDERD: altijd null buiten het eigen dashboard van Whop.
string | null
vereist
De betaling die de uitgever heeft gemeld, met prefix pay_. null wanneer Whop de melding niet aan een betaling kon koppelen.
string | null
vereist
Het product waarvoor de gemelde betaling was, met prefix prod_.
string
vereist
Wanneer de uitgever de melding heeft ingediend, als ISO 8601-tijdstempel. Eerder dan created_at, het moment waarop Whop de melding ontving.
string | null
vereist
Het netwerkprogramma dat de alert heeft verzonden, wat type alleen niet onderscheidt. ethoca voor Mastercard Ethoca, cdrn voor Visa Verifi CDRN, rdr voor Visa RDR, tc40 / safe voor een fraudemelding van Visa / Mastercard, paypal voor een PayPal-alert. null wanneer het netwerk dit niet aangaf.Beschikbare opties: ethoca, cdrn, rdr, tc40, safe, paypal
string | null
vereist
Wanneer de gemelde transactie heeft plaatsgevonden, als ISO 8601-tijdstempel — valt terug op het moment van de gekoppelde betaling als de melding van de uitgever zelf er geen bevatte. Zou in de praktijk niet null moeten zijn; behandel dat als een dataprobleem in plaats van verwacht gedrag.
string
vereist
Wat de uitgever heeft verzonden. early_fraud_warning is een fraudemelding over een afgewikkelde betaling (Visa TC40 / Mastercard SAFE) — een terugbetaling voorkomt de chargeback nog, en Whop rekent hiervoor nooit kosten. dispute_alert is een melding voorafgaand aan een geschil vanuit het alertnetwerk van de uitgever, waarvoor Whop betaalt en die als kosten wordt doorberekend. rapid_dispute_resolution is een Visa RDR-zaak die het netwerk al heeft afgesloten door de betaling terug te betalen — er hoeft niets meer te gebeuren.Beschikbare opties: early_fraud_warning, dispute_alert, rapid_dispute_resolution
string
vereist
Wanneer de alert voor het laatst is gewijzigd, als ISO 8601-tijdstempel.
DisputeAlert