Retrieve Dispute Alert
Retrieves a single dispute alert or early fraud warning by ID.
Authorizations
An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Headers
Pins the request to a dated API version.
"2026-10-09-2"
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.
"biz_xxxxxxxxxxxxxx"
The alerted amount, in whole units of currency. This is what the issuer reported, which can differ from the payment's own amount.
25
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.
false
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.
"visa"
When Whop received the alert, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
Three-letter ISO currency code of the alerted amount.
"usd"
The alert fee charged to the account, in the currency it was collected in. null when fee_charged is false.
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.
false
Dispute alert ID, prefixed dspa_.
"dspa_xxxxxxxxxxxxxx"
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.
null
The payment the issuer reported, prefixed pay_. null when Whop could not match the report to a payment.
"pay_xxxxxxxxxxxxxx"
The product the alerted payment was for, prefixed prod_.
"prod_xxxxxxxxxxxxxx"
When the issuer filed the report, as an ISO 8601 timestamp. Earlier than created_at, which is when Whop received it.
"2026-01-01T12:00:00.000Z"
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.
"2026-01-01T12:00:00.000Z"
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 "dispute_alert"
When the alert was last changed, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"

