Skip to main content
type distingue les signalements de fraude (early_fraud_warning), les avis de pré-litige (dispute_alert) et les cas Visa RDR que le réseau a déjà clôturés par un remboursement (rapid_dispute_resolution). Utilisez l’API Dispute alerts pour lister les alertes d’un compte, les filtrer par type ou par paiement, et lire actionable pour savoir si un remboursement peut encore éviter la rétrofacturation.

Endpoints

Attributs

string
requis
ID de l’alerte de litige, préfixé par dspa_.
string | null
requis
Le compte auquel appartient le paiement concerné par l’alerte, préfixé par biz_. null tant que l’alerte n’est pas rapprochée.
number
requis
Le montant concerné par l’alerte, en unités entières de currency. Il s’agit du montant déclaré par l’émetteur, qui peut différer du montant du paiement lui-même.
boolean
requis
Indique si Whop a automatiquement remboursé le paiement concerné. Reflète l’état du paiement, et peut donc être true pour un remboursement émis par un autre processus (RDR, résolution) sur le même paiement.
string | null
requis
Le réseau de la carte tel que déclaré par l’émetteur, en minuscules, comme visa ou mastercard. unknown lorsque le signalement ne comporte ni réseau ni BIN reconnaissable.
string | null
requis
Ce que le titulaire de la carte affirme. fraud lorsqu’il déclare ne pas avoir effectué le paiement : toujours pour un early_fraud_warning, ainsi que pour les alertes de fraude Ethoca et les cas Visa RDR déposés pour un motif de fraude. customer_dispute lorsqu’il a effectué le paiement mais le conteste, par exemple pour un produit non reçu ou un abonnement annulé. null lorsque l’alerte ne comporte aucune réclamation, comme une demande de documents de transaction par l’émetteur.Options disponibles : fraud, customer_dispute
string
requis
Date à laquelle Whop a reçu l’alerte, sous forme d’horodatage ISO 8601.
string
requis
Code de devise ISO à trois lettres du montant concerné par l’alerte.
object | null
requis
Les frais d’alerte facturés au compte, dans la devise dans laquelle ils ont été prélevés. null lorsque fee_charged est false.

Propriétés

string
requis
Le montant en unités principales, sous forme de chaîne décimale exacte. Par exemple, "10.00" correspond à dix dollars. Il s’agit d’une chaîne afin qu’aucun nombre à virgule flottante ne l’arrondisse pendant le transit.
string
requis
Code de devise ISO 4217 à trois lettres, en minuscules.
integer
requis
Nombre de décimales du montant. Il s’agit de la précision avec laquelle le prélèvement lui-même est effectué.
integer
requis
Nombre de décimales à AFFICHER. Généralement égal à decimals, mais délibérément pas toujours : le COP est facturé en centavos mais s’écrit en pesos entiers, il vaut donc 2 et 0. Formatez le nombre dans votre propre locale à l’aide de cette valeur.
boolean
requis
Indique si Whop a facturé au compte des frais d’alerte pour celle-ci. Toujours false pour early_fraud_warning, qui n’est pas facturé à Whop et n’est jamais répercuté.
string | null
requis
Obsolète : toujours null en dehors du tableau de bord de Whop. Nom de la banque qui a émis la carte et déposé le signalement. OBSOLÈTE : toujours null en dehors du tableau de bord de Whop.
string | null
requis
Le paiement signalé par l’émetteur, préfixé par pay_. null lorsque Whop n’a pas pu rapprocher le signalement d’un paiement.
string | null
requis
Le produit auquel correspondait le paiement concerné, préfixé par prod_.
string
requis
Date à laquelle l’émetteur a déposé le signalement, sous forme d’horodatage ISO 8601. Antérieure à created_at, qui correspond à sa réception par Whop.
string | null
requis
Le programme réseau qui a envoyé l’alerte, ce que type seul ne permet pas de distinguer. ethoca pour Mastercard Ethoca, cdrn pour Visa Verifi CDRN, rdr pour Visa RDR, tc40 / safe pour un signalement de fraude Visa / Mastercard, paypal pour une alerte PayPal. null lorsque le réseau ne l’a pas précisé.Options disponibles : ethoca, cdrn, rdr, tc40, safe, paypal
string | null
requis
Date à laquelle la transaction signalée a été effectuée, sous forme d’horodatage ISO 8601 — à défaut, date du paiement rapproché si le signalement de l’émetteur n’en comportait pas. Ne devrait pas être null en pratique ; considérez une telle valeur comme un problème de données plutôt que comme un comportement attendu.
string
requis
Ce que l’émetteur a envoyé. early_fraud_warning est un signalement de fraude sur un paiement réglé (Visa TC40 / Mastercard SAFE) — un remboursement permet encore d’éviter la rétrofacturation, et Whop ne facture jamais de frais pour ce type. dispute_alert est un avis de pré-litige provenant du réseau d’alertes de l’émetteur, que Whop paie et répercute sous forme de frais. rapid_dispute_resolution est un cas Visa RDR que le réseau a déjà clôturé en remboursant le paiement — il n’y a plus rien à faire.Options disponibles : early_fraud_warning, dispute_alert, rapid_dispute_resolution
string
requis
Date de dernière modification de l’alerte, sous forme d’horodatage ISO 8601.
DisputeAlert