Skip to main content
A Dispute alert is an early warning from a card issuer that a settled payment is being questioned, ahead of any chargeback. type separates fraud reports (early_fraud_warning), pre-dispute notices (dispute_alert), and Visa RDR cases the network already closed by refunding (rapid_dispute_resolution). Use the Dispute alerts API to list alerts for an account, filter them by type or payment, and read actionable to see whether refunding can still avoid the chargeback.

​
Endpoints

​
Attributes

​
string
required
Dispute alert ID, prefixed dspa_.
​
string | null
required
The account the alerted payment belongs to, prefixed biz_. null while the alert is unmatched.
​
number
required
The alerted amount, in whole units of currency. This is what the issuer reported, which can differ from the payment’s own amount.
​
boolean
required
Whether Whop automatically refunded the alerted payment. Reflects the payment, so it can be true for a refund issued by another flow (RDR, resolution) on the same payment.
​
string | null
required
The card network as reported by the issuer, lowercased, such as visa or mastercard. unknown when the report carries neither a network nor a recognizable BIN.
​
string
required
When Whop received the alert, as an ISO 8601 timestamp.
​
string
required
Three-letter ISO currency code of the alerted amount.
​
object | null
required
The alert fee charged to the account, in the currency it was collected in. null when fee_charged is false.

Properties

​
string
required
The amount in major units, as an exact decimal string — "10.00" is ten dollars. A string so no float rounds it in transit.
​
string
required
Three-letter ISO 4217 currency code, lowercase.
​
integer
required
How many decimal places the amount CARRIES — the precision the charge itself runs at.
​
integer
required
How many decimal places to SHOW. Usually equal to decimals, and deliberately not always: COP is charged in centavos but written in whole pesos, so it is 2 and 0. Format the number in your own locale using this.
​
boolean
required
Whether Whop charged the account an alert fee for this one. Always false for early_fraud_warning, which Whop is not billed for and never passes on.
​
string | null
required
Deprecated: always null outside Whop’s own dashboard. Name of the bank that issued the card and filed the report. DEPRECATED: Always null outside Whop’s own dashboard.
​
string | null
required
The payment the issuer reported, prefixed pay_. null when Whop could not match the report to a payment.
​
string | null
required
The product the alerted payment was for, prefixed prod_.
​
string
required
When the issuer filed the report, as an ISO 8601 timestamp. Earlier than created_at, which is when Whop received it.
​
string | null
required
When the reported transaction was made, as an ISO 8601 timestamp — falls back to when the matched payment was made if the issuer’s own report didn’t carry one. Should not be null in practice; treat one as a data issue rather than expected behavior.
​
string
required
What the issuer sent. early_fraud_warning is a fraud report on a settled payment (Visa TC40 / Mastercard SAFE) — refunding still avoids the chargeback, and Whop never charges a fee for one. dispute_alert is a pre-dispute notice from the issuer’s alert network, which Whop pays for and passes on as a fee. rapid_dispute_resolution is a Visa RDR case the network already closed by refunding the payment — nothing is left to act on.Available options: early_fraud_warning, dispute_alert, rapid_dispute_resolution
​
string
required
When the alert was last changed, as an ISO 8601 timestamp.
DisputeAlert