Retrieve Dispute Alert
Retrieves a single dispute alert or early fraud warning by ID.
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Headers
Pins the request to a dated API version.
"2026-08-10"
Path Parameters
The dispute alert ID, prefixed dspa_.
Response
dispute alert returned
The account the alerted payment belongs to, prefixed biz_. null while the alert is unmatched.
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.
The alerted amount, in whole units of currency. This is what the issuer reported, which can differ from the payment's own amount.
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.
When Whop received the alert, as an ISO 8601 timestamp.
Three-letter ISO currency code of the alerted amount.
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.
Dispute alert ID, prefixed dspa_.
Name of the bank that issued the card and filed the report.
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.
network_resolved, payment_unmatched, payment_not_captured, payment_disputed, payment_refunded, null "network_resolved"
The payment the issuer reported, prefixed pay_. null when Whop could not match the report to a payment.
The product the alerted payment was for, prefixed prod_.
When the issuer filed the report, as an ISO 8601 timestamp. Earlier than created_at, which is when Whop received it.
When the reported transaction was made, as an ISO 8601 timestamp.
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.
early_fraud_warning, dispute_alert, rapid_dispute_resolution "early_fraud_warning"
When the alert was last changed, as an ISO 8601 timestamp.

