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.
​
boolean
required
Whether refunding the payment can still avoid a chargeback. false once the payment has been disputed or fully refunded, or when the alert could not be matched to a payment — not_actionable_reason says which.
​
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.
​
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.
​
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
Name of the bank that issued the card and filed the report.
​
string | null
required
Why refunding can no longer avoid a chargeback. network_resolved when a Visa RDR already closed the case, payment_unmatched when no payment matched, payment_not_captured when it never captured money, payment_disputed once the payment carries a dispute, payment_refunded once fully refunded. null while actionable is true.Available options: network_resolved, payment_unmatched, payment_not_captured, payment_disputed, payment_refunded
​
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.
​
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